01 / DECIDE
架構決策
當 SDK-managed execution、handoff、guardrail、session 或 tracing 能簡化應用時採用 Agents SDK。
Controller 必須擁有 turn、tool、state、approval、stop condition 與 trace；specialist 只接收窄任務與 typed result。 先把 input、output、state 與 side effect 畫成一條可觀察路徑，再決定 明確指定 agent loop 的 owner 要放在哪一層。
02 / BUILD
三步實作
- 01
框定合約
先寫下 caller、資料分類、成功條件、timeout、取消與 ownership。當 SDK-managed execution、handoff、guardrail、session 或 tracing 能簡化應用時採用 Agents SDK。
- 02
建立單一路徑
只實作一條 end-to-end path，保留 request correlation、typed state 與可逆 failure handling。Controller 必須擁有 turn、tool、state、approval、stop condition 與 trace；specialist 只接收窄任務與 typed result。
- 03
證明結果
把驗收寫成可重跑的 fixture、contract test 或 browser test。Trace/eval 以 task success、tool error、handoff、latency、cost 與 human intervention 比較 baseline。
03 / BOUND
Production 邊界
更多 agent 不保證更好；先有 single-agent baseline 與明確 ownership，再增加 specialist。
04 / PROVE
驗收證據
Trace/eval 以 task success、tool error、handoff、latency、cost 與 human intervention 比較 baseline。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://developers.openai.com/api/docs/guides/agents' | sed -n '1,5p'