01 / DECIDE
Architecture decision
SDK-managed execution、handoff、guardrail、session、tracing が application を簡潔にする場合に Agents SDK を使う。
controller が turn、tool、state、approval、stop condition、trace を所有し、specialist には narrow task と typed result を渡す。 input、output、state、side effect を一つの観測可能な経路にしてから、agent loop の owner を明確にする の所有層を決めます。
02 / BUILD
3段階の実装
- 01
contract を定義
caller、data classification、success condition、timeout、cancel、ownership を先に記述します。SDK-managed execution、handoff、guardrail、session、tracing が application を簡潔にする場合に Agents SDK を使う。
- 02
狭い経路を構築
request correlation、typed state、reversible failure handling を持つ一つの end-to-end path だけを実装します。controller が turn、tool、state、approval、stop condition、trace を所有し、specialist には narrow task と typed result を渡す。
- 03
outcome を証明
acceptance を再実行可能な fixture、contract test、browser test にします。trace/eval で task success、tool error、handoff、latency、cost、human intervention を baseline と比較する。
03 / BOUND
Production boundary
agent を増やしても品質は保証されない。single-agent baseline と明確な ownership の後に specialist を追加する。
04 / PROVE
Acceptance evidence
trace/eval で task success、tool error、handoff、latency、cost、human intervention を baseline と比較する。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://developers.openai.com/api/docs/guides/agents' | sed -n '1,5p'