01 / DECIDE
架構決策
適合 offline evaluation、enrichment、media job 或不需 interactive latency 的 high-volume work。
使用 immutable input manifest、stable custom ID、per-item status、bounded replay 與明確 partial-result policy。 先把 input、output、state、tool 與 side effect 畫成一條可觀察路徑,再決定 對帳每個 batch item 的 owner。
02 / OPERATE
三步野戰程序
- 01
鎖定合約
寫下 caller、資料分類、成功條件、timeout、取消與 ownership。適合 offline evaluation、enrichment、media job 或不需 interactive latency 的 high-volume work。
- 02
執行有界路徑
只建立一條 end-to-end path,保留 correlation、typed state 與 reversible failure。使用 immutable input manifest、stable custom ID、per-item status、bounded replay 與明確 partial-result policy。
- 03
驗證訊號
把驗收變成可重跑的 fixture、contract test 或 browser test。Reconciliation 證明沒有 silent loss,且每個 input 都有唯一 terminal disposition。
03 / BOUND
Operation 邊界
限制敏感 dataset、定義 expiry,若 media result 有時效則要及時下載。
04 / PROVE
驗收證據
Reconciliation 證明沒有 silent loss,且每個 input 都有唯一 terminal disposition。
SOURCE / HTTP
可重現來源探針
curl -fsSI 'https://docs.x.ai/developers/advanced-api-usage/batch-api' | sed -n '1,5p'