01 / DECIDE
架構決策
在多個產品功能用不同可靠度假設呼叫 API 前採用。
把 authentication、request ID、timeout、normalized error 與 model configuration 集中在 server-owned adapter。 先把 input、output、state、tool 與 side effect 畫成一條可觀察路徑,再決定 建立單一 xAI API 邊界 的 owner。
02 / OPERATE
三步野戰程序
- 01
鎖定合約
寫下 caller、資料分類、成功條件、timeout、取消與 ownership。在多個產品功能用不同可靠度假設呼叫 API 前採用。
- 02
執行有界路徑
只建立一條 end-to-end path,保留 correlation、typed state 與 reversible failure。把 authentication、request ID、timeout、normalized error 與 model configuration 集中在 server-owned adapter。
- 03
驗證訊號
把驗收變成可重跑的 fixture、contract test 或 browser test。Contract test 證明遮罩、timeout、error classification 與 request correlation。
03 / BOUND
Operation 邊界
長效 key 只留在 server,且不可讓 model response 繞過 application authorization。
04 / PROVE
驗收證據
Contract test 證明遮罩、timeout、error classification 與 request correlation。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://docs.x.ai/developers/quickstart' | sed -n '1,5p'