01 / DECIDE
架構決策
適合低延遲 speech 或 multimodal interaction,避免 request-response audio 的斷裂感。
Transport、session configuration、turn detection、interruption、tool、reconnect 與 terminal state 共同定義體驗。 先把 input、output、state 與 side effect 畫成一條可觀察路徑,再決定 把 Realtime 當成即時分散式系統設計 要放在哪一層。
02 / BUILD
三步實作
- 01
框定合約
先寫下 caller、資料分類、成功條件、timeout、取消與 ownership。適合低延遲 speech 或 multimodal interaction,避免 request-response audio 的斷裂感。
- 02
建立單一路徑
只實作一條 end-to-end path,保留 request correlation、typed state 與可逆 failure handling。Transport、session configuration、turn detection、interruption、tool、reconnect 與 terminal state 共同定義體驗。
- 03
證明結果
把驗收寫成可重跑的 fixture、contract test 或 browser test。Network test 涵蓋 jitter、reconnect、double-talk、device change、long session、late tool 與 clean shutdown。
03 / BOUND
Production 邊界
Client credential 必須短效;interruption 要取消 stale work,tool result 也要有 turn ownership。
04 / PROVE
驗收證據
Network test 涵蓋 jitter、reconnect、double-talk、device change、long session、late tool 與 clean shutdown。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://developers.openai.com/api/docs/guides/realtime' | sed -n '1,5p'