交給你們決定的事
工作流的關卡可以交給你們的系統,主管在你們的簽核流程裡核准。工作流步驟裡的核准與提問也可以交給你們。決定好就送回來,工作流接著做。
有些事要人決定,例如超過預算的採購單。這些事可以交給你們的系統,讓主管在你們的簽核流程裡決定。他不需要 Dot Agents 的帳號。
哪些事會交給你們
| 種類 | 什麼時候 | 可以送回的決定 |
|---|---|---|
gate(關卡) |
工作流的關卡「問誰」選了這個 API 串接 | 核准或拒絕。「選一個」與「勾選多項」的關卡送回答案 |
approval(核准) |
這個串接開始的那一次,有一步要核准,而且串接的「核准交給」是外部系統 | 核准或拒絕 |
question(提問) |
同上,agent 在步驟裡有事要問 | 答案 |
你們會收到什麼
我們回呼 interaction.pending,data 是這一則:
{
"id": "9b1e…",
"kind": "gate",
"ask": "approve",
"title": "核准採購單?",
"body": "PO-0042,金額 82,000",
"actions": ["approve", "deny"],
"run_id": "3f2c…",
"run": 12,
"workflow": { "id": "…", "name": "採購核准" },
"expires_at": "2026-11-15T09:00:00.000Z"
}
沒有回呼網址時,查詢那一次的 waiting 也看得到。
送回決定
POST /api/v1/interactions/{id}
{ "action": "approve", "decided_by": "amy@erp.example.com" }
| action | 用在 | 其他欄位 |
|---|---|---|
approve |
核准 | — |
deny |
拒絕 | note:理由(可省略) |
answer |
提問、「選一個」、「勾選多項」 | answer:選項或答案文字。勾選多項時,送項目的 id 陣列 |
decided_by是你們系統裡按的人。我們只記在稽核紀錄,不檢查它。- 已經決定過或過期的,回
409 already_resolved。 - 不是交給這個串接的,回
404。
期限
關卡可以設期限。期限到了還沒決定,我們回呼 interaction.expired,工作流走「逾時」那條線。
相關頁
本頁對應 v0.168.0