01 / DECIDE
Architecture decision
offline evaluation、classification、enrichment、interactive latency 不要の大規模 queue に使う。
batch work には stable custom identifier、immutable input manifest、per-item status、result reconciliation、bounded replay が必要。 input、output、state、side effect を一つの観測可能な経路にしてから、遅延許容 workload を batch processing へ移す の所有層を決めます。
02 / BUILD
3段階の実装
- 01
contract を定義
caller、data classification、success condition、timeout、cancel、ownership を先に記述します。offline evaluation、classification、enrichment、interactive latency 不要の大規模 queue に使う。
- 02
狭い経路を構築
request correlation、typed state、reversible failure handling を持つ一つの end-to-end path だけを実装します。batch work には stable custom identifier、immutable input manifest、per-item status、result reconciliation、bounded replay が必要。
- 03
outcome を証明
acceptance を再実行可能な fixture、contract test、browser test にします。reconciliation で全 input が succeeded、failed、cancelled、明示 pending のいずれかになり silent loss がないことを示す。
03 / BOUND
Production boundary
無制限の sensitive dataset を送らず、retention、encryption、cancellation、partial-result policy を先に定義する。
04 / PROVE
Acceptance evidence
reconciliation で全 input が succeeded、failed、cancelled、明示 pending のいずれかになり silent loss がないことを示す。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://developers.openai.com/api/docs/guides/batch' | sed -n '1,5p'