Vòng đời một yêu cầu duyệt tool

Vòng đời một yêu cầu duyệt tool A lifecycle diagram generated by Archify. 01 / Trạng thái approval (bảng approvals) 02 / Đường tắt qua cổng 03 / Kết thúc không chạy tool Tool cần duyệt · requires_approval · Trạng thái approval (bảng approvals) · gate 01 Tool cần duyệt requires_approval gate Chờ duyệt · ApprovalRequiredEvent · Trạng thái approval (bảng approvals) · pending 02 Chờ duyệt ApprovalRequiredEvent pending Đã duyệt · POST approvals/{id} · Trạng thái approval (bảng approvals) · approved 03 Đã duyệt POST approvals/{id} approved Chạy tool · settle_tool_calls · Trạng thái approval (bảng approvals) · resume 04 Chạy tool settle_tool_calls resume Lượt tiếp tục · tool result về model · Trạng thái approval (bảng approvals) · done 05 Lượt tiếp tục tool result về model done Luôn cho phép · always → auto_approve · Đường tắt qua cổng · auto Luôn cho phép always → auto_approve auto Autonomous · conversation autonomous · Đường tắt qua cổng · autonomous: true Autonomous conversation autonomous autonomous: true Từ chối · DENIED_TOOL về model · Kết thúc không chạy tool · denied Từ chối DENIED_TOOL về model denied Hết hạn · TTL 600 s, expire_overdue · Kết thúc không chạy tool · expired Hết hạn TTL 600 s, expire_overdue expired Legend start active state waiting decision terminal success failure / exit

Khi nào có cổng

  • • Tool khai requires_approval: shell_run, workspace_write, workspace_edit
  • • shell_ask_patterns buộc hỏi cả khi autonomous cho lệnh nguy hiểm
  • • Conversation autonomous (job lịch, delegate, agent autonomous: true) bỏ qua cổng

Quyết định

  • • Duyệt / từ chối trên thanh duyệt của web UI
  • • always=true thêm tool vào auto_approve của cuộc trò chuyện đó
  • • Khi đang chờ, /inbound trả 409 InboundBusy

Kết thúc

  • • Từ chối và hết hạn đều thành tool result báo lỗi, lượt vẫn tiếp
  • • Quét hết hạn chạy định kỳ trong runtime
  • • Lịch sử duyệt xem ở GET /api/approvals