← 概念解説に戻る

Concept Fable

実行ステップ

先に結論:Run Step は Run の中間実行記録であり、例えば一度のモデルメッセージ生成、一度のツール呼び出し、一度の人手アクション待ち、一度の失敗リトライなどである。チームが最終回答だけでなく Agent の実行過程を検査できるようにする。企業導入では、Run Step はデバッグ、監査、受け入れ、運用改善にとって極めて重要である。各ステップで何が起きたか、入出力は何か、成功したか、どれだけ時間がかかったか、次のステップがなぜこう進むのかを答える。

Run Step · Agent execution trace

まず物語を読む。ここでは急いで定義を示さず、まず問題そのものを立ち上がらせる。

寓話

橋が落ちてから記帳するのではなく、どの梁にも足跡がある

北門工房は町のために木の橋を作っている。かつて検収は簡単だった。人が渡れれば完成、渡れなければ作り直し。老師匠たちは経験豊富で、何年もこのやり方でやってきた。

後に注文が大きくなると、橋はもはや一枚の板ではなく、測量、材料準備、切断、塗装、輸送、設置、再検査から成るようになった。各ステップが次のステップを変えうる。しかし帳簿には依然として最終結果だけが書かれた:成功、あるいは失敗。

最初の大きな手戻りは突然やってきた。橋面を設置した後、中央部分が二寸ずれていることが分かった。大工は図面通りに切ったと言い、測量士は図面は間違っていないと言い、資材運搬人は道中でぶつけていないと言った。皆で歪んだ橋を囲んで一日中言い争ったが、誰もずれがどの工程から始まったのか見つけられなかった。

管理側の応急処置は、全員に最後に署名させることだった。署名は増えたが、問題は依然として解決しなかった。署名はその人が来たことしか示さず、何をしたか、どの図面を使ったか、どんな異常を発見したか、その異常がその後処理されたかは示さないからだ。

二度目の事故はより小さかったが、より高くついた。防水塗料の一缶が安い塗料にすり替えられ、設置時に誰も気づかず、雨季の後に橋面が膨れた。経理係はコスト低下だけを見、検収担当者はその日の平坦さだけを見た。問題が現れた頃には、どの調達、どの確認、どの判断がずれたのか、もう分からなくなっていた。

新しい管事は段階別の台帳に切り替えた。各橋は結果を登録するだけでなく、各中間動作も記録した。誰が新しい図を生成したか、誰が倉庫を呼び出したか、誰が材料を取り戻したか、どの段階が承認待ちか、どの段階が失敗して再試行したか、どの段階が次の段階で使う結果を生み出したか。

最初、作業員はこれらの小さな記録を細かすぎると思った。しかし次に梁木の寸法が合わなくなったとき、三ページめくっただけで原因を見つけた。測定後の改図が切断台に伝わっていなかったのだ。問題はもはや互いに推測する必要がなく、修復も橋全体を覆す必要はなかった。

年末の振り返りで、工房は分歩冊に別の価値があることに気づいた。どの工程が最もよく待たされ、どのツールが最もよく失敗し、どの人手承認がいつも納品を遅らせているかがわかる。橋の品質は最終検収だけでなく、各工程に残された証拠によって継続的に良くなっていく。

明らかにする

この物語が語っているのは:実行ステップ

Run Step は Run の中間実行記録であり、例えば一度のモデルメッセージ生成、一度のツール呼び出し、一度の人手アクション待ち、一度の失敗リトライなどである。チームが最終回答だけでなく Agent の実行過程を検査できるようにする。企業導入では、Run Step はデバッグ、監査、受け入れ、運用改善にとって極めて重要である。各ステップで何が起きたか、入出力は何か、成功したか、どれだけ時間がかかったか、次のステップがなぜこう進むのかを答える。

重要なのは、それが単なる用語ではなく、実際のAI/Agentシステムで繰り返し現れる構造的な問題だという点だ。これを理解して初めて、いつモデルを足すべきか、いつプロセスを変えるべきか、いつガバナンスを補うべきかを判断できる。

メタファーのマッピング

  • 一つの橋:一回のRun、つまり一回の完全なAgent実行
  • 測定、切断、輸送、設置:Run Step、実行中の記録可能な中間動作
  • 成否だけを書く:最終出力だけを見て、過程の可観測性を欠く
  • 最終署名:粗い監査では具体的な行為を説明できない
  • 分歩冊:実行ステップ記録と実行 trace
  • 変更図が切断台に伝わらない:Run Step がコンテキスト伝達の断点を特定するのを支援
  • 承認待ちと失敗リトライ:Run Step は非成功経路も記録する
  • 継続的改善:プロセスデータが納品受け入れ、デバッグ、運用最適化を支える

Andy(任旭)判断

この概念の実戦的価値は、「賢く見えるAI機能」を納品可能、検収可能、ガバナンス可能な作業単位に分解する手助けをすることです。

runtracetool callメッセージ作成監査ログ
京ICP备2026014272号