實作指南 / 12 分鐘
決定誰擁有 Agent Loop
Responses 適合 application-owned control；Agents SDK 適合 SDK-managed execution。
Agent 會規劃、呼叫 tools、攜帶 state，也可能 handoff 給 specialist。關鍵不是 agent 數量，而是誰擁有 run loop、tool policy、state、approvals 與 trace。
工作原則
只能有一個 controller
指定一層推進 run 並解析 terminal state；split-brain orchestration 會重複 action 且難以復原。
Specialist 需要契約
Handoff 要定義 goal、permitted tools、relevant context、output shape 與歸還權限。
先 trace 再擴張
先觀察單一 agent run，再加入 handoff；沒有 trace 的複雜度無法證明有改善。
實地程序
- 01
選擇 loop owner
若 application 要控制每一 turn，使用 Responses；若希望 SDK runtime 推進 tools 與 handoffs，使用 Agents SDK。
- 02
定義 terminal states
列出 success、blocked、needs approval、budget exhausted、cancelled、failed 與 caller action。
- 03
限制每個 specialist
每個 specialist 只負責一個 outcome 與有限 tool set，回傳 typed result。
- 04
插入 approval boundaries
在外部訊息、破壞性變更、購買、credential use 或其他高影響 action 前暫停。
- 05
評估整個 workflow
用 task success、tool errors、handoff count、latency、cost 與 human intervention 比較單 agent baseline。
PASS / FAIL
驗收清單
- Loop owner 無歧義。
- Stop 與 cancellation paths 已測試。
- Handoffs 只帶有界 context 與 typed results。
- Trace 不含 secrets 且可支援 incident review。
WATCH / REJECT
失敗模式
- 用更多 agents 取代清楚 task graph。
- 讓 app 與 SDK 同時 retry writes。
- Transcript 很有自信就宣告完成。