跳到內容

交給你們決定的事

工作流的關卡可以交給你們的系統,主管在你們的簽核流程裡核准。工作流步驟裡的核准與提問也可以交給你們。決定好就送回來,工作流接著做。

有些事要人決定,例如超過預算的採購單。這些事可以交給你們的系統,讓主管在你們的簽核流程裡決定。他不需要 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