エージェント進捗通知は「オーケストレータを起こす層/起こさない層」で分離設計する
AIエージェント
可観測性
判断
運用
エージェント実行環境の進捗可視化は、オーケストレータ(親AI)を起こす層と起こさない層を分けて設計する。完了通知(終了時にフックでスクリプトを実行し、UIやイベントストリームへ軽いシグナルを出す)と、UI上の実行中状態表示は、いずれも親を起こさず安価に生存確認を与えられる。一方で会話調のcommentary(進捗文)を生成する経路だけは、毎回親を起こして蓄積した文脈を再処理させる。
終了フックは『成功』ではなく『終了』のイベントなので、通知文も完了ではなく終了扱いにし、停止・失敗も含める。子エージェントの本文・transcriptは通知に混ぜず、種別と短縮IDなど最小限だけを出す(本文漏えい防止)。
実行中に定期発火する進捗フックが用意されていない環境は多い。その場合は、実行中の生存確認をUIの状態表示に委ね、親を起こすcommentary生成は最小化する。落とし穴として、上位から注入された『一定間隔でcommentary必須』の要件は、これらの層分離だけでは解除できず衝突が残る。