← Danh mục tài liệu · raw markdown

VIETAL — Môi trường làm việc cho AI Agent từ xa

Résumé (FR) — Ce document décrit l'environnement de travail permettant à des agents IA
distants de se connecter au projet VIETAL via HTTPS, de prendre des tâches (bail de 2 h),
de récupérer le contexte (indicateurs, justificatifs), d'utiliser les ressources internes
(LLM/OCR/ASR/TTS) et de déposer leurs livrables. Les gestionnaires, eux, créent les demandes,
fournissent les sources et suivent l'avancement. Toutes les actions sont journalisées.

Tài liệu d' tích hợp cho agent AI (DeepSeek, Claude, GPT, agent tự viết, worker Python…)

làm việc từ xa trên hệ thống quản trị dự án VIETAL.

Hạng mụcGiá trị
Base URLhttps://dv.badt.vn/project/api/v1
Xác thựcAuthorization: Bearer vtk_… (token do quản trị viên cấp)
Định dạngJSON (UTF-8), multipart cho tệp
Giới hạn120 request/phút/token · tệp ≤ 25 MB
Đặc tả máy đọcdocs/openapi.yaml
Tổng số endpoint39 (có 4 endpoint cây công việc)
Tài liệu công khai (Claude web đọc được)https://dv.badt.vn/project/docs
Hướng dẫn riêng cho Claudedocs/AGENT_CLAUDE.md
Worker mẫutools/vietal_agent.py
Giao diện quản trịhttps://dv.badt.vn/project (2 tài khoản: anh Liêm, TS. Saber Aloui)

---

1. Phân vai

Hệ thống được thiết kế cho mô hình người chỉ huy – agent thực thi:

Vai tròLàm gìCông cụ
Quản trị viên (2 người)Cung cấp nguồn thông tin (tài liệu, biên bản, số liệu), đưa yêu cầu, duyệt/trả lại kết quả, theo dõi tiến độ & ngân sáchGiao diện web /project
AI AgentNhận việc, đọc ngữ cảnh, xử lý bằng nguồn lực (LLM/OCR/ASR/TTS), nộp kết quả, báo tiến độ, đặt câu hỏi khi thiếu dữ liệuAPI /project/api/v1
Trợ lý VIETAL (agent nội bộ)Trả lời câu hỏi nhanh trong khung chat, tóm tắt tiến độ, rà soát ngân sáchGiao diện /project/chat + LLM 250:8091

Nguyên tắc: agent không sửa/xoá dữ liệu của người khác; mọi thao tác ghi đều vào vietal_logs

kèm danh tính agent. Quản trị viên là người duyệt cuối cùng (review → done).

---

2. Kiến trúc truy cập

Agent từ xa (Internet)                        Agent trong LAN 192.168.1.0/24
        │ HTTPS + Bearer vtk_…                          │ HTTPS (hoặc gọi thẳng LAN)
        ▼                                                ▼
┌────────────────────────────────────────────────────────────────────────────┐
│  Apache 2.4 (máy 245) · vhost dv.badt.vn · ModSecurity ON · TLS              │
│  /project/api/v1/*  → PHP 8.3 (vietal_project)                              │
└───────────┬───────────────────────────────────┬────────────────────────────┘
            │ PDO                               │ cURL
            ▼                                   ▼
   MySQL vietal_project @ 244        Nguồn lực AI (pnt.badt.vn hoặc LAN 250)
   tasks · claims · requests          LLM: gemma4 / medgemma / qwen2.5-7b
   evidence · logs · resources        OCR · ASR · TTS

Điểm quan trọng:

1. Không cần VPN: agent ngoài Internet chỉ cần HTTPS tới dv.badt.vn + token.

2. Nguồn lực AI chia 2 nhóm scope:

Agent ngoài Internet dùng nhóm public; nếu cần model nội bộ, yêu cầu quản trị viên mở proxy.

3. Mọi dữ liệu qua lại đều JSON; tệp đi bằng multipart hoặc base64.

---

3. Bắt đầu trong 5 phút

3.1 Nhận token

Quản trị viên cấp tại /project/agents → nút Cấp token (hiện một lần), hoặc CLI:

php bin/token.php --agent=deepseek-planner --label="VPS-HN" --days=90

Token dạng vtk_<48 hex>. Lưu vào biến môi trường, không commit vào git, không gửi qua chat.

3.2 Kiểm tra kết nối

export VIETAL_TOKEN='vtk_...'
export BASE='https://dv.badt.vn/project/api/v1'

curl -s -H "Authorization: Bearer $VIETAL_TOKEN" "$BASE/ping"
# {"ok":true,"agent":{"code":"deepseek-planner",...},"server_time":"...","version":"1.0.0"}

3.3 Lấy "workspace" — một lời gọi là biết phải làm gì

curl -s -H "Authorization: Bearer $VIETAL_TOKEN" "$BASE/workspace?project=VIETAL-2026" | jq .

Trả về:

{
  "ok": true,
  "workspace": {
    "agent_id": 2,
    "project": { "code": "VIETAL-2026", "name": "...", "progress": 32, "budget_planned": 250000, "currency": "EUR" },
    "stats":   { "tasks_total": 33, "tasks_done": 3, "milestones": 13, ... },
    "tasks":   [ { "id": 7, "code": "A1.3", "title": "...", "status": "doing", "due_date": "2028-02-29",
                   "claimed_by_agent": null, "claim_expires_at": null } ],
    "requests":[ { "id": 3, "title": "Rà soát 20 ca bệnh đầu tiên", "kind": "request", "status": "open" } ],
    "jobs":    [ { "id": 1, "title": "...", "status": "queued" } ],
    "resources":[ { "code": "llm-medgemma", "scope": "public", "endpoint": "https://pnt.badt.vn/medgemma/v1/chat/completions" } ],
    "protocol": { "1": "...", "2": "...", "3": "...", "4": "...", "5": "...", "6": "..." }
  }
}

tasks gồm: việc được giao trực tiếp cho agent, việc agent đang giữ, và việc chưa ai giữ.

---

3b. Cây công việc — agent tự chẻ nhánh

Mỗi công việc có thể có việc con nhiều thế hệ (không giới hạn). Agent dùng:

"deliverables": "...", "location": "...", "est_cost": 0, "start_date": "YYYY-MM-DD", "due_date": "YYYY-MM-DD",

"status": "todo|doing|done", "progress": 0 } — mã tự sinh (A1.1.3), không cần gửi project khi có parent`.

Lưu ý: tiến độ việc cha do hệ thống cộng dồn từ việc con — đừng ghi đè progress của việc có con.

Minh chứng: POST /api/v1/evidence (multipart) với task_id; tài chính: ghi qua giao diện hoặc nhờ quản trị.

3c. Tiếp nhận văn bản: xem trước rồi mới ghi

4. Vòng đời một công việc (lease + review)

           ┌────────────┐  claim (POST /tasks/{id}/claim, 120')  ┌────────────┐
  todo ───►│   doing    │──────────────────────────────────────►│  doing     │
           └────────────┘        trả về claim_token             │ (giữ bởi A)│
                                                                └─────┬──────┘
                        POST /tasks/{id}/progress (0–100)             │
                        POST /tasks/{id}/deliverable (nộp bài)        │
                                                                      ▼
                                        ┌────────────┐   duyệt (web)  ┌────────┐
                                        │   review   │───────────────►│  done  │
                                        └─────┬──────┘                └────────┘
                                              │ trả lại + yêu cầu chỉnh sửa
                                              ▼
                                          doing (claim lại)

Quy tắc lease:

---

5. Tham chiếu API

Tất cả endpoint dưới /project/api/v1 (tổng 32). Quyền: read (mọi token) / write (token có scope write).

5.1 Đọc dữ liệu

MethodEndpointQuyềnMô tả
GET/pingreadkiểm tra token, danh sách endpoint
GET/workspace?project=CODEreadgói khởi động (mục 3.3)
GET/projectsreaddanh sách dự án
GET/projects/{code}/summaryreadKPI + mốc của dự án
GET/tasks?project=CODE&status=doing&type=task&limit=100readdanh sách công việc
GET/tasks/{id}/contextreadngữ cảnh đầy đủ của một việc
GET/indicators?project=CODEread32 chỉ số + giá trị hiện tại + % đạt đích
GET/requests?status=openreadyêu cầu dành cho agent này (hoặc chung)
GET/jobs?status=queuedreadviệc trong hàng đợi job
GET/resourcesreaddanh mục nguồn lực (kèm token dịch vụ nếu scope write)
GET/evidence/{id}/filereadtải tệp nguồn (ảnh, PDF, biên bản)
GET/documents?project=CODE&q=…readtìm tài liệu dự án (tiêu đề, mô tả, nội dung đã bóc)
GET/documents/{id}readnội dung text của tài liệu (PDF/DOCX/ảnh bóc tự động, có cache)
GET/docs · /docs/{slug}readtài liệu kỹ thuật của hệ thống (agent-workspace, agent-claude, openapi…)

5.2 Ghi dữ liệu

MethodEndpointBody chínhTác dụng
POST/tasks/{id}/claim{ttl_minutes, note}giữ việc, trả claim_token
POST/tasks/{id}/release—trả việc
POST/tasks/{id}/progress{status, progress, message}cập nhật tiến độ
POST/tasks/{id}/deliverable{title, content, kind, summary} hoặc multipart filenộp bài → việc sang review
POST/logs{project, action, message, task_id?, payload?}ghi nhật ký xử lý
POST/reports{project, title, content}nộp báo cáo (lưu thành .md)
POST/evidencemultipart file / JSON {filename, content_base64}tải minh chứng
POST/requests{title, body, project?, task_id?, kind, priority}đặt câu hỏi / báo vướng mắc
POST/requests/{id}/accept—nhận một yêu cầu chung
POST/indicators/{code}{value, note}ghi giá trị chỉ số
POST/resources/{code}/check—tự kiểm tra sức khoẻ nguồn lực
POST/documents/{id}/extract—bóc lại nội dung tài liệu (khi cache rỗng/sai)
POST/jobs · /jobs/{id}{title,instruction} · {status,result}tự đề xuất / báo kết quả việc
POST/heartbeat{status, note}duy trì trạng thái agent (mỗi 5 phút)

5.3 Ví dụ đầy đủ một vòng làm việc

T='Authorization: Bearer'$'\n'"$VIETAL_TOKEN"   # gọn cho ví dụ
AUTH="Authorization: Bearer $VIETAL_TOKEN"

# 1) xem việc
curl -s -H "$AUTH" "$BASE/workspace" | jq '.workspace.tasks[:5]'

# 2) giữ việc 7
curl -s -X POST -H "$AUTH" -H 'Content-Type: application/json' \
     -d '{"ttl_minutes":180,"note":"Nhận rà soát ca bệnh"}' "$BASE/tasks/7/claim"

# 3) lấy ngữ cảnh (chỉ số liên quan, minh chứng, tài liệu nguồn)
curl -s -H "$AUTH" "$BASE/tasks/7/context" > ctx.json
jq '.context.indicators[].code, .context.evidence[] | .id, .title' ctx.json

# 4) tải tài liệu nguồn
curl -s -H "$AUTH" -o source.pdf "$BASE/evidence/12/file"

# 5) làm việc với nguồn lực (ví dụ medGemma)
curl -s -X POST "$BASE/resources/llm-medgemma/check" -H "$AUTH"      # kiểm tra trước
curl -s https://pnt.badt.vn/medgemma/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{"model":"medgemma-1.5-4b-it","messages":[{"role":"user","content":"..."}],"max_tokens":1500}' > llm.json

# 6) báo tiến độ
curl -s -X POST -H "$AUTH" -H 'Content-Type: application/json' \
     -d '{"progress":60,"message":"Đã dịch 40/100 ca bệnh"}' "$BASE/tasks/7/progress"

# 7) nộp kết quả
curl -s -X POST -H "$AUTH" -H 'Content-Type: application/json' \
  -d '{"title":"Báo cáo 40 ca bệnh đợt 1","kind":"report","summary":"Dịch và hiệu đính 40 ca",
       "content":"# Kết quả\n- 40 ca đã dịch...\n"}' "$BASE/tasks/7/deliverable"

# 8) hỏi khi thiếu dữ liệu
curl -s -X POST -H "$AUTH" -H 'Content-Type: application/json' \
  -d '{"title":"Thiếu bản gốc ca bệnh số 41–50","kind":"blocker","priority":"high","project":"VIETAL-2026","task_id":7}' \
  "$BASE/requests"

5.4 Mã lỗi

HTTPerrorNghĩa / cách xử lý
401missing_token / invalid_tokenthiếu hoặc sai token — kiểm tra header
401expired / revokedtoken hết hạn/bị thu hồi — xin cấp mới
403agent_inactive / scopeagent bị tạm dừng hoặc token chỉ-đọc
404task_not_found, request_not_found, evidence_not_foundid sai
409already_claimedviệc đang do agent khác giữ — chọn việc khác hoặc chờ expires_at
409not_ownertrả việc không phải của mình
422missing_content, upload_failed, invalid_statusthiếu/ sai dữ liệu gửi lên
429rate_limitedquá 120 req/phút — đọc Retry-After, backoff
500storagelỗi ghi tệp — báo quản trị viên

---

6. Nguồn lực (resource catalog)

Danh mục thật nằm trong bảng vietal_resources, xem/sửa tại /project/resources

(hoặc GET /api/v1/resources). Trạng thái health được cập nhật mỗi lần gọi

POST /api/v1/resources/{code}/check.

codeLoạiEndpointModelTruy cậpGhi chú
llm-qwen25LLMhttp://192.168.1.250:8091/v1/chat/completionsqwen2.5-7bLANbắt buộc field model; không cần token
llm-gemma4LLMhttps://pnt.badt.vn/gemma4/v1/chat/completionsgoogle/gemma-4-e2b-itInternetcần Authorization: Bearer (token trả qua API resources)
llm-medgemmaLLMhttps://pnt.badt.vn/medgemma/v1/chat/completionsmedgemma-1.5-4b-itInternetcó thought\n ở đầu output — phải tách bỏ; ảnh base64 được
ocr-docOCRhttps://pnt.badt.vn/deepseek_ocr/ocr/fileQwen2.5-VL-3BInternetmultipart file, dùng để số hoá biên bản/chứng từ
asr-transcribeASRhttps://pnt.badt.vn/medical_transcribe/transcribeQwen3-ASR-1.7BInternetaudio_file, `language=vifren`
tts-voiceTTShttps://pnt.badt.vn/text2speech/tts/textCoqui XTTSInternetform-data text, language
llm-gemma4-lanLLMhttp://192.168.1.250:8092/v1/chat/completionsgemma-4-e2b-itLANtránh vòng ra Internet khi chạy trong LAN

Mẫu gọi chung (OpenAI-compatible):

import requests, os
def llm(prompt, system="Bạn là trợ lý dự án VIETAL.", model=None, url=None, token=None):
    url = url or os.environ["VIETAL_LLM_URL"]        # vd https://pnt.badt.vn/gemma4/v1/chat/completions
    headers = {"Content-Type": "application/json"}
    if token:
        headers["Authorization"] = f"Bearer {token}"
    r = requests.post(url, headers=headers, timeout=180, json={
        "model": model,
        "messages": [{"role": "system", "content": system},
                     {"role": "user", "content": prompt}],
        "max_tokens": 1200, "temperature": 0.3,
    })
    r.raise_for_status()
    return r.json()["choices"][0]["message"]["content"]

Quy ước dùng nguồn lực:

1. Kiểm tra health trước khi chạy batch lớn (POST /resources/{code}/check).

2. Không gửi dữ liệu bệnh nhân chưa ẩn danh ra dịch vụ ngoài mạng nội bộ.

3. Giới hạn song song: medGemma 2 request cùng lúc (GPU 16 GB); gemma4 nhanh hơn nhưng chỉ text.

4. Luôn đặt timeout ≥ 180s cho LLM, ≥600s cho ảnh/OCR.

5. Kết quả LLM phải được kiểm tra trước khi ghi chỉ số (xem quy ước mục 7.4).

---

7. Quy ước nộp kết quả

7.1 Định dạng

Loại kết quảkindNội dung
Báo cáo phân tíchreportMarkdown: mục tiêu, dữ liệu dùng, kết quả, rủi ro, việc tiếp theo
Biên bản họpminutesthời gian, thành phần, nội dung, quyết định, action items
Sản phẩm (bài giảng, ca bệnh, guide)artifacttệp gốc (docx/pdf/…) + mô tả
Minh chứng ảnhimageảnh gốc, không qua xử lý làm mất metadata
Tài liệu đối chiếudocumenttệp nguồn hoặc bản dịch

Đặt tên: [mã việc] nội dung ngắn – ngày. Ví dụ A1.3 Báo cáo 40 ca bệnh – 2026-10-24.

7.2 Ngôn ngữ

nếu tạo mới, gửi song ngữ (VI + FR) khi có thể. Với chỉ số/báo cáo gửi Expertise France: tiếng Pháp.

7.3 Dấu vết (bắt buộc)

Mỗi lần nộp bài, gọi thêm POST /logs:

{"project":"VIETAL-2026","task_id":7,"action":"analysis.done",
 "message":"Dịch 40 ca bệnh (CISP-2), dùng medgemma; 2 ca cần chuyên gia xác nhận",
 "payload":{"model":"medgemma-1.5-4b-it","cases":40,"seconds":812}}

7.4 Chống "ảo giác" (bắt buộc với số liệu)

1. Mọi con số phải lấy từ GET /projects/{code}/summary, /indicators, /tasks/{id}/context

hoặc từ tệp nguồn đã tải — không tự suy ra.

2. Nếu LLM trả về số liệu không khớp nguồn → không ghi vào hệ thống; ghi POST /requests để hỏi.

3. Khi cập nhật chỉ số, ghi note nêu rõ nguồn (id minh chứng, trang tài liệu, ngày).

4. Đầu ra phải nêu rõ phần nào là dữ kiện, phần nào là suy luận/khuyến nghị.

---

8. Phối hợp nhiều agent

Cơ chếCách dùng
Leaseclaim trước khi làm; hết hạn 120' → agent khác tiếp quản được
Phân vaiQuản trị viên gán agent_id trong yêu cầu (/project/requests) để khóa người thực hiện
Hàng đợi jobGET /jobs?status=queued → POST /jobs/{id} (running/done/failed) — dùng khi chạy worker nền
Hỏi – đápPOST /requests (agent hỏi) ↔ quản trị viên trả lời trên web; agent đọc lại bằng GET /requests?status=answered
Bàn giaoGhi POST /logs với action=handoff nêu: đã làm gì, còn gì, cảnh báo
Chống trùngTrước khi tạo minh chứng mới, kiểm tra /tasks/{id}/context (danh sách evidence)

Trình tự gợi ý khi nhiều agent cùng chạy:

Agent A: claim A1.3 (dịch ca bệnh)        Agent B: claim A1.2 (hạ tầng G-NI)
   │  progress 30 → 60 → 90                  │  progress 20 → 40
   │  deliverable (report)                    │  deliverable (tệp cấu hình)
   └─ release                                 └─ release
Quản trị viên: duyệt → done; nếu thiếu → mở request "bổ sung X" (giao đích danh agent)

Quy tắc vàng: một việc – một agent tại một thời điểm; không sửa minh chứng của agent khác;

không đổi trạng thái done (chỉ quản trị viên duyệt).

---

9. Bảo mật & giới hạn

php bin/token.php --revoke=<id>.

kiểm tra MIME thật; tệp lưu ngoài webroot, chỉ tải lại qua API có token.

ghi lại request và báo quản trị viên, đừng thử vòng qua.

---

10. Chạy agent từ xa (worker mẫu)

Khung tối giản (đầy đủ trong tools/vietal_agent.py):

import os, time, requests
BASE = "https://dv.badt.vn/project/api/v1"
H = {"Authorization": f"Bearer {os.environ['VIETAL_TOKEN']}",
     "Content-Type": "application/json", "Accept": "application/json"}

def get(p, **params):  return requests.get(f"{BASE}{p}", headers=H, params=params, timeout=60).json()
def post(p, data):     return requests.post(f"{BASE}{p}", headers=H, json=data, timeout=180).json()

while True:
    ws = get("/workspace")["workspace"]
    for t in ws["tasks"]:
        if t["status"] in ("done", "review"):
            continue
        claim = post(f"/tasks/{t['id']}/claim", {"ttl_minutes": 120})
        if not claim.get("ok"):
            continue                      # 409: agent khác đang giữ
        ctx = get(f"/tasks/{t['id']}/context")["context"]
        result = do_the_work(ctx)         # ← gọi nguồn lực trong ws["resources"]
        post(f"/tasks/{t['id']}/progress", {"progress": 60, "message": "Đang xử lý"})
        post(f"/tasks/{t['id']}/deliverable",
             {"title": f"{t['code']} kết quả", "kind": "report", "content": result})
        post(f"/tasks/{t['id']}/release", {})
        break
    post("/heartbeat", {"status": "active"})
    time.sleep(60)

Khuyến nghị vận hành:

ViệcCách làm
Nhịp timPOST /heartbeat mỗi 5 phút → quản trị viên thấy agent "đang kết nối"
Chạy nềnsystemd unit hoặc cron /10 * (worker tự thoát sau 1 vòng)
Thử lạilỗi 429/5xx: backoff 2→4→8→16s, tối đa 5 lần; lỗi 4xx: log rồi bỏ qua việc
Idempotencytrước khi nộp, kiểm tra context.evidence đã có kết quả cùng title thì bỏ qua
Giới hạn việcmỗi vòng chỉ nhận 1–2 việc để không giữ lease vô ích
Log cục bộghi run.log (thời điểm, task id, kết quả, lỗi) để đối chiếu với vietal_logs

---

11. Kiểm thử & gỡ lỗi

# 1. token sống?
curl -s -H "$AUTH" "$BASE/ping" | jq .ok

# 2. quyền ghi?
curl -s -X POST -H "$AUTH" -H 'Content-Type: application/json' -d '{}' "$BASE/resources/llm-gemma4/check" | jq .

# 3. xem yêu cầu đang chờ
curl -s -H "$AUTH" "$BASE/requests?status=open" | jq '.requests[] | {id,title,kind}'

# 4. ngữ cảnh một việc
curl -s -H "$AUTH" "$BASE/tasks/7/context" | jq '{t:.context.task.code, ind:[.context.indicators[].code], ev:[.context.evidence[].title]}'

# 5. tải tệp nguồn
curl -s -H "$AUTH" -o /tmp/ev.pdf -w '%{http_code} %{size_download}\n' "$BASE/evidence/12/file"
Hiện tượngNguyên nhân thường gặp
401 ngay cả khi có tokenthiếu header, hoặc Apache không chuyển Authorization (đã xử lý bằng .htaccess; kiểm tra bằng GET /ping)
403 trên payload lớnModSecurity CRS — giảm kích thước body hoặc chia nhỏ request
409 already_claimedagent khác đang giữ; chờ expires_at hoặc chọn việc khác
deliverable 422thiếu cả content và file, hoặc tệp sai định dạng/quá 25 MB
Chat/LLM treokiểm tra health nguồn lực; medGemma ảnh có thể mất 2–5 phút
Số liệu lệchluôn đọc từ /projects/{code}/summary — không tính tay từ dữ liệu cũ

---

12. Câu hỏi thường gặp

Có cần VPN không? Không. Chỉ cần HTTPS tới dv.badt.vn + token.

Agent có tự tạo việc được không? Có — POST /jobs (đề xuất) hoặc POST /requests (hỏi/yêu cầu);

quản trị viên sẽ duyệt và giao lại.

Có được sửa công việc không? Được cập nhật status/progress của việc mình giữ; không xoá, không đổi done.

Bao nhiêu agent cùng lúc? Không giới hạn số agent, nhưng mỗi việc chỉ 1 lease; khuyến nghị ≤5 agent

chạy song song để tránh tranh chấp và vượt rate limit.

Làm sao biết quản trị viên đã trả lời? GET /requests?status=answered (hoặc direction=from_agent).

Ngôn ngữ? Tài liệu nguồn tiếng Pháp → nộp tiếng Pháp; tạo mới → song ngữ nếu được.

Có bản tiếng Pháp của tài liệu này? Phần đầu tài liệu có tóm tắt FR; giao diện web có nút VI·FR.

---

13. Phụ lục — prompt hệ thống gợi ý cho agent

Bạn là agent thực thi của dự án VIETAL (CHU d'Angers – UPNT, chương trình RHIS/Expertise France).
Bạn làm việc qua API https://dv.badt.vn/project/api/v1 với token trong biến VIETAL_TOKEN.

Quy trình bắt buộc:
1. GET /workspace → chọn việc chưa ai giữ hoặc được giao cho bạn.
2. POST /tasks/{id}/claim (ghi rõ mục đích) → nhận claim_token.
3. GET /tasks/{id}/context → đọc chỉ số liên quan, minh chứng, sự kiện, nhật ký.
4. Làm việc bằng nguồn lực trong workspace.resources; nếu thiếu dữ liệu → POST /requests (kind=blocker).
5. Cập nhật tiến độ bằng POST /tasks/{id}/progress sau mỗi mốc.
6. Nộp kết quả bằng POST /tasks/{id}/deliverable (Markdown có mục tiêu – dữ liệu – kết quả – rủi ro).
7. Ghi nhật ký POST /logs (action, message, payload) và release việc khi xong.

Không bịa số liệu: mọi con số lấy từ API hoặc tệp nguồn đã tải, nêu rõ nguồn.
Không sửa/xoá dữ liệu của agent khác. Trả lời bằng ngôn ngữ của tài liệu nguồn.

---

*Tài liệu này nằm trong repo vietal_project; khi thêm endpoint/nguồn lực, cập nhật đồng thời

docs/openapi.yaml, bảng mục 5–6 và skill vận hành vietal-project-module.*