01 / DECIDE
架構決策
在 production 擴大 agent workflow，或變更 model、prompt、tool 與 orchestration 前採用。
以穩定 correlation identifier 串起 run、turn、model、tool、handoff、approval、latency、usage 與 terminal outcome。 先把 input、output、state 與 side effect 畫成一條可觀察路徑，再決定 追蹤決策，但不記錄 secret 要放在哪一層。
02 / BUILD
三步實作
- 01
框定合約
先寫下 caller、資料分類、成功條件、timeout、取消與 ownership。在 production 擴大 agent workflow，或變更 model、prompt、tool 與 orchestration 前採用。
- 02
建立單一路徑
只實作一條 end-to-end path，保留 request correlation、typed state 與可逆 failure handling。以穩定 correlation identifier 串起 run、turn、model、tool、handoff、approval、latency、usage 與 terminal outcome。
- 03
證明結果
把驗收寫成可重跑的 fixture、contract test 或 browser test。Incident 能由 identifier 與 outcome 重建，不需要無限制存取 raw prompt。
03 / BOUND
Production 邊界
遮罩 credential 與 sensitive content、定義 retention，並分開 operational metric 與 full conversation storage。
04 / PROVE
驗收證據
Incident 能由 identifier 與 outcome 重建，不需要無限制存取 raw prompt。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://developers.openai.com/api/docs/guides/agents/integrations-observability' | sed -n '1,5p'