01 / DECIDE
架構決策
適合需要 state choice、hosted/custom tool 或 multimodal input 的新 OpenAI 整合。
Typed input/output item 讓 message、reasoning、tool call 與 tool result 在多步 request 中保持分離。 先把 input、output、state 與 side effect 畫成一條可觀察路徑,再決定 以 Responses 作為 agentic application 邊界 要放在哪一層。
02 / BUILD
三步實作
- 01
框定合約
先寫下 caller、資料分類、成功條件、timeout、取消與 ownership。適合需要 state choice、hosted/custom tool 或 multimodal input 的新 OpenAI 整合。
- 02
建立單一路徑
只實作一條 end-to-end path,保留 request correlation、typed state 與可逆 failure handling。Typed input/output item 讓 message、reasoning、tool call 與 tool result 在多步 request 中保持分離。
- 03
證明結果
把驗收寫成可重跑的 fixture、contract test 或 browser test。Contract test 解析每個預期 output item、refusal、incomplete result 與 tool terminal state。
03 / BOUND
Production 邊界
明確選擇 storage 與 deletion;便利的 state 不能取代產品 database 或 retention policy。
04 / PROVE
驗收證據
Contract test 解析每個預期 output item、refusal、incomplete result 與 tool terminal state。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://developers.openai.com/api/docs/guides/migrate-to-responses' | sed -n '1,5p'