01 / DECIDE
Architecture decision
reasoning/tool work が interactive request budget を超え、recoverable result が必要な場合に使う。
background work には job identifier、polling/streaming policy、cancellation、expiry、idempotent consumption、visible status が必要。 input、output、state、side effect を一つの観測可能な経路にしてから、long-running response を asynchronous job にする の所有層を決めます。
02 / BUILD
3段階の実装
- 01
contract を定義
caller、data classification、success condition、timeout、cancel、ownership を先に記述します。reasoning/tool work が interactive request budget を超え、recoverable result が必要な場合に使う。
- 02
狭い経路を構築
request correlation、typed state、reversible failure handling を持つ一つの end-to-end path だけを実装します。background work には job identifier、polling/streaming policy、cancellation、expiry、idempotent consumption、visible status が必要。
- 03
outcome を証明
acceptance を再実行可能な fixture、contract test、browser test にします。state-machine test で queued、running、streaming、completed、cancelled、expired、failed、duplicate consumer を確認する。
03 / BOUND
Production boundary
sensitive workload で background execution を選ぶ前に storage と Zero Data Retention compatibility を確認する。
04 / PROVE
Acceptance evidence
state-machine test で queued、running、streaming、completed、cancelled、expired、failed、duplicate consumer を確認する。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://developers.openai.com/api/docs/guides/background' | sed -n '1,5p'