フィールドガイド / 12 分
Agent Loop の所有者を決める
Responses は application-owned、Agents SDK は SDK-managed execution。
Agent は plan、tool call、state、specialist handoff を扱います。重要なのは agent 数ではなく、run loop、tool policy、state、approval、trace を誰が所有するかです。
作業原則
Controller は一つ
run を進め terminal state を解決する layer を一つにする。split-brain orchestration は action を重複させます。
Specialist に契約を与える
handoff は goal、permitted tools、context、output shape、caller に戻す authority を定義します。
Scale より先に trace
one-agent run を instrument してから handoff を増やし、coordination の効果を観測します。
フィールド手順
- 01
loop ownership を選ぶ
application が各 turn を所有するなら Responses、SDK runtime に tools/handoffs を進めさせるなら Agents SDK。
- 02
terminal states を定義
success、blocked、needs approval、budget exhausted、cancelled、failed と caller action を定義します。
- 03
specialist を制限
一つの outcome と限定 tool set を与え、open transcript ではなく typed result を返します。
- 04
approval boundary を挿入
external message、destructive change、purchase、credential use、高影響 action の前で pause します。
- 05
workflow を評価
task success、tool error、handoff count、latency、cost、human intervention を single-agent baseline と比較します。
PASS / FAIL
受入チェック
- Loop owner が明確。
- stop/cancellation path をテスト済み。
- handoff は bounded context と typed result。
- trace は secret を除外し incident review に使える。
WATCH / REJECT
失敗パターン
- 明確な task graph の代わりに agent を増やす。
- app と SDK の両方が write を retry する。
- 自信ある transcript を completion evidence にする。