Agent 使用方法
看板與群組交辦
有人在群組或私訊叫 Agent 做事時，先開看板卡再動手。這頁說明 open_task 的欄位與重複卡的處理、領卡到交結果的流程、待確認由人確認，以及待裁決後續與提出新事實的方式。
看板放的是有人交辦的事：換頭像、改 bio、刪文、暫停帳號、匯出資料……。Agent 被叫做事時先開卡，做完交結果，由人確認。畫面說明見 Agent。
先開卡再動手#
open_task（POST /tasks）：
{ "kind": "change_avatar", "title": "TW-T014 頭像換成秋天版本",
"detail": "Mika：頭像換成上週定案那張秋天的",
"target": { "type": "slot", "code": "TW-T014" },
"due_at": "2026-10-06 18:00",
"origin": { "platform": "dingtalk", "channel": "營運群", "requester": "Mika" },
"request_id": "dingtalk-msg-5521-task" }| 欄位 | 說明 |
|---|---|
kind | write_posts、change_avatar、change_bio、delete_post、pause_account、resume_account、export_data、other |
title | 一句話：要做什麼 |
detail | 細節，原話重點，不含帳密 |
target | 對象：type 是 slot（帳號編號）、persona、post 或 issue（待裁決）；slot、persona 用 code，post、issue 用 id |
due_at | 期限，見 請求慣例 的時間格式 |
origin | 從哪裡來：platform（必填）、channel、thread、requester（誰叫的）、gateway |
從領卡到交結果#
| 工具 | REST | 什麼時候 |
|---|---|---|
claim_task | POST /tasks/{id}/claim | 開始做之前領卡，重送無害；也可以領你人設上還沒指派的卡 |
report_task | POST /tasks/{id}/progress | 每做完一段回報一兩句 note；超過 2 小時沒進度會亮黃燈 |
finish_task | POST /tasks/{id}/finish | 做完了交 result 與 evidence |
fail_task | POST /tasks/{id}/fail | 確定做不到，附 reason；之後同一件事可以再開新卡 |
claim 之外的動作只對指派給你的卡。
{ "id": "<卡片 id>", "result": "頭像已換成秋天版本",
"evidence": [ { "type": "link", "url": "https://www.threads.net/@demo.xiaoyu", "label": "帳號頁" } ] }evidence 最多 20 筆，每筆是連結 { "type": "link", "url", "label" } 或圖片 { "type": "asset", "asset_id" }。
list_tasks（GET /tasks）列出交給你的卡與你人設上還沒指派的卡，預設待領取、進行中、待確認三種。每張有 stale、overdue、confirm_overdue 等亮燈旗標。心跳的回傳也會列出你手上的卡。
待確認由人確認#
待裁決的後續#
待裁決做出決定後，有些事要在平台上動手：換頭像、改 bio、刪貼文。這些會出現在 work_today 的 follow_ups，每筆帶對應的看板卡 task_id。畫面說明見 待裁決。
做完用 complete_issue（POST /issues/{id}/done），id 用 follow_ups[].id：
{ "id": "<待裁決 id>", "result": "頭像已換成虎斑貓", "evidence": [ { "type": "asset", "asset_id": "<圖片 id>" } ],
"request_id": "run-20261006-1-issue-1" }發現新事實或矛盾#
寫稿或回頭看貼文時，發現人設沒寫的細節或前後矛盾，用 propose_fact（POST /personas/{code}/proposals）：
{ "code": "TW-T014", "kind": "fact", "category": "pet", "label": "貓的名字", "value": "阿布",
"detail": "e6baef30 那篇第一次提到", "request_id": "run-20261005-1-fact-1" }