← すべての記事

AIエージェントのレビューパケットは新しい最終回答になる

OpenAIのCodex発表記事では、Codexはターミナルログやテスト出力の引用を通じて検証可能な証拠を示し、ユーザーがタスク完了までの手順を追跡できると説明されています。1 この一文が、プロダクトの変化を言い表しています。もはや最終回答だけでは足りません。

エージェント作業では、レビューパケットが新しい最終回答になります。信頼に値するエージェントなら、主張、記録、承認、差分、テスト、情報源の確認、デプロイの証拠、未解決の課題を、構造化された束として残すべきです。流暢な文章で作業を要約することはできます。信頼を得るのは、そのパケットです。

要約

エージェントの作業は、計画、ツール呼び出し、ファイル編集、承認、テスト、本番ルート、翻訳、人間のサインオフにまで広がっています。OpenAIのCodex cloudドキュメントは、サンドボックス化されたクラウド環境で動くバックグラウンドタスクを説明しています。一方、Agents SDKは、モデル生成、ツール呼び出し、引き継ぎ、ガードレール、カスタムイベントをまたいだトレースを提供します。23 OpenAIのHuman-in-the-loopドキュメントでは、承認判断のために実行を一時停止する仕組みが示されています。また、AnthropicのClaude Codeのフックは、PreToolUsePostToolUsePermissionRequestStopなどのライフサイクルイベントを公開しています。45

これらはすべて、同じ成果物を指しています。レビューパケットです。パケットがあることで、エージェントの最終的な主張は、人間が検査し、却下し、承認し、別のレビュアーに渡せるものになります。

重要ポイント

エージェントを作る人へ: - 最終回答は表紙として扱いましょう。証拠を担うのはレビューパケットです。 - 重要な主張はすべて、ファイル、コマンド出力、トレースイベント、情報源、ルート確認、承認判断、または未解決の課題に結びつけます。

プロダクトデザイナーへ: - パケットはトランスクリプトの書き出しではなく、すばやく確認できる対象として設計します。ユーザーの判断単位ごとに証拠をまとめましょう。 - 人間によるレビュー状況をパケットに含めます。「機械で確認済み」と「人間が承認済み」は別の状態です。

エージェントを導入するチームへ: - 公開リリース、本番変更、翻訳作業、セキュリティに関わる変更、金銭的影響のある作業では、レビューパケットを必須にしましょう。 - 何が未検証として残っているのかをパケットが明示していない限り、「完了」を受け入れてはいけません。

AIエージェントのレビューパケットとは何か

レビューパケットとは、エージェント作業のための構造化された証拠の束です。

次の7つの問いに答えます。

問い パケットの項目
ユーザーは何を依頼したのか 目的と範囲
エージェントは何を変更したのか ファイル、差分、成果物、外部状態
エージェントは何を実行したのか コマンド、ツール呼び出し、引数、終了状態
人間は何を承認したのか 承認判断とリスクメモ
結果を証明するものは何か テスト、情報源確認、レンダリング済みルート、テレメトリ、スクリーンショット
まだ判断が必要なものは何か レビュータスク、サインオフ表、未解決の主張
次に何をすべきか マージ、公開、却下、再試行、またはエスカレーション

パケットはMarkdownでも、JSONでも、データベース行でも、プルリクエストテンプレートでも、専用のUIオブジェクトでも構いません。形式よりも構造が重要です。証拠と説明文を分ける必要があります。

最終回答は「記事を翻訳してデプロイしました」と言います。レビューパケットは、どのロケールが変わったのか、どの品質基準を通過したのか、どのD1行が存在するのか、どのコミットがデプロイされたのか、どのCDNパージが走ったのか、どの本番ルートで変更後の記事が返ったのか、ネイティブスピーカーによるレビューがどれだけ残っているのかを示します。後者は、人間が判断するための材料を提供します。

なぜ最終回答は機能しなくなったのか

最終回答が機能しなくなったのは、エージェントが時間をかけて行動するようになったからです。

チャットボットの回答は、その回答画面だけで評価できます。ところが、コーディングや公開を担うエージェントは経路を作ります。ファイルを読み、情報源を選び、ツールを呼び出し、コンテンツを編集し、テストを実行し、翻訳を書き、デプロイし、キャッシュを削除し、本番を検証します。最後の段落は、その経路を説明するだけです。その経路が実際に存在したことは証明しません。

OpenAIのCodexドキュメントでは、隔離されたクラウド環境でコードを読み、編集し、実行できるクラウドタスクが説明されています。バックグラウンドで多数のタスクを並列実行することも含まれます。2 並列のバックグラウンド作業が増えるほど、実際に起きたことと、最終回答に収まる内容の差は大きくなります。エージェントが多くのことを行うほど、トランスクリプトの要約を証拠として扱う根拠は弱くなります。

OpenAIのCodex安全運用に関する記事も、セキュリティの観点から同じ運用上の論点を示しています。そこでは、サンドボックス化、承認、ネットワークポリシー、アイデンティティ、管理された設定、エージェント向けテレメトリの制御が説明されています。また、プロンプト、承認判断、ツール実行結果、MCP使用状況、ネットワークの許可または拒否イベントなどのログエクスポートにも触れています。6 これらはパケットの材料です。レビュー画面に置くべきものです。

最終回答は残すべきです。ただし、エグゼクティブサマリーのように読めるものにします。監査証跡を担うのはレビューパケットです。

パケットに含めるべきもの

パケットでは、内部イベントの発生順ではなく、判断単位ごとに証拠をまとめるべきです。

セクション 最低限の証拠
目的 ユーザー依頼、受け入れ条件、範囲外としたもの
作業概要 変更ファイル、生成された成果物、触れた外部状態
記録 意味のあるツール呼び出し、コマンド出力、失敗、再試行
承認 リスクのある操作、承認判断、拒否、保留
検証 テスト、情報源確認、レンダリング済みルート、スキーマ確認、スクリーンショット
リリース コミット、デプロイ状態、キャッシュ削除、本番上の変更マーカー
レビュー 人間のサインオフ状況、ネイティブレビュー状況、未解決の課題

この構造なら、パケットは読みやすくなります。生のトレースには数百件のイベントが含まれることがあります。レビューパケットの中心に、それらをすべて流し込むべきではありません。必要なときには完全なトレースへリンクまたは展開できるようにしつつ、標準表示では判断に集中できる状態にします。

証拠の基準は領域によって変わります。

作業の種類 パケットが証明すべきこと
コード変更 差分、テスト、影響を受ける呼び出し元、ロールバック手順
公開記事 情報源、主張と情報源の対応、メタデータ、スキーマ、本番ルート
翻訳 ロケールキャッシュ、品質基準、D1行、本番ルート、ネイティブレビュー状況
セキュリティ作業 脅威、緩和策、テスト、残存リスク、承認記録
本番デプロイ コミット、デプロイ状態、キャッシュの鮮度、本番上の変更マーカー

規則は変わりません。人間がその作業に署名する必要があるなら、その署名に責任を持てるだけの証拠をパケットに含めるべきです。

トレースと承認はどうパケットにつながるのか

トレースと承認は、パケットの背骨になります。

OpenAIのAgents SDK tracingドキュメントは、エージェント実行に関するトレースとスパンを定義しています。そこには、LLM生成、ツール呼び出し、引き継ぎ、ガードレール、カスタムイベントが含まれます。3 このデータは、何が起きたのかをパケットに伝えます。OpenAIのHuman-in-the-loopドキュメントは、ツール承認のために実行を一時停止し、保留中の承認を中断として返し、実行状態をシリアライズし、判断後に実行を再開する方法を示しています。4 このデータは、誰がリスクのある操作を許可したのかをパケットに伝えます。

AnthropicのClaude Codeのフックも、よく似たライフサイクルの形を公開しています。フックはツールの前、ツールの後、権限リクエスト時、そしてClaudeが停止したときに実行できます。5 これらのイベントが重要なのは、エージェントシステムが挙動をレビュー可能な事実へ変換できるからです。パケットは、モデルが実行内容を覚えていることに依存してはいけません。実行基盤が、関連するイベントを発生時点で記録すべきです。

この違いは重要です。

弱い完了報告 パケットによる完了
「テストは通りました。」 コマンド、終了コード、出力要約、失敗テストがあればその内容
「情報源を確認しました。」 情報源URL、ステータス、主張との対応、ブロックされたURL
「デプロイに成功しました。」 デプロイID、実行時の健全性、キャッシュ削除、本番ルートの簡易確認
「翻訳が完了しました。」 ロケール一覧、品質基準の結果、D1行、ネイティブレビュー状況
「そのコマンドを承認しました。」 承認オブジェクト、理由、リスク階層、実行者、タイムスタンプ

パケットは曖昧さを取り除きます。エージェントは簡潔な要約を書けますが、証拠は文章の外に置かれます。

人間によるレビュー状況はどう扱うべきか

人間によるレビュー状況は、形容詞ではなく独立した項目として表示すべきです。

機械的な基準は、構造、ルートの健全性、スキーマの存在、情報源への到達性、多くの同等性チェックを証明できます。しかし、ローカライズされた記事を流暢なネイティブスピーカーが確認したことは証明できません。パケットでは、両方をはっきり書くべきです。

ステータス 意味
機械チェック合格 自動基準を通過した
人間レビュー待ち 必須の人間レビューがまだ行われていない
人間が承認済み レビュアー、日付、ロケールまたは範囲、判断が記録されている
却下 レビュアーがブロック要因を見つけた
不要 その範囲では人間のサインオフを要求しないワークフローである

同じ規則は翻訳以外にも当てはまります。セキュリティ基準が合格していても、法務レビューは未完了かもしれません。テストスイートが通っていても、プロダクトレビューで挙動が却下されるかもしれません。デプロイが成功していても、CDNが古いコンテンツを返しているかもしれません。レビュー状況は、エージェントの自信を飾るものではなく、残っている判断を説明するものです。

NISTのAI Risk Management Frameworkは、信頼性をAIシステムの設計、開発、利用、評価に組み込むものとして位置づけています。7 レビューパケットは、この考え方を運用可能にします。評価を最終回答の主張ではなく、目に見える成果物に変えるのです。

最小限のパケットはどのようなものか

小さく始めましょう。

# Review Packet: <work item>

## Decision
Status: ready for review | blocked | approved | rejected
Owner: <human or team>

## Goal
- User request:
- Acceptance criteria:
- Scope exclusions:

## Changes
- Files:
- Artifacts:
- External state:

## Evidence
| Claim | Proof | Result |
|---|---|---|
| Tests ran | `<command>` output | pass/fail |
| Public route works | `<url>` smoke | pass/fail |
| Sources support claims | source list | pass/fail |

## Approvals
| Action | Risk | Decision | Notes |
|---|---|---|---|

## Remaining Gaps
- <unverified work>

最初のパケットは退屈なくらいで構いません。表、リンク、短いステータス項目のほうが、証拠を隠してしまう美しい成果物よりも役に立ちます。構造が機能し始めたら、デザインによってさらに見やすくできます。重要度、グルーピング、フィルター、折りたたみ式の記録、明示的な次の操作などです。

重要なプロダクト判断は、パケットを他のシステムが読める成果物にすることです。プルリクエストはパケットにリンクできます。リリースノートはパケットを要約できます。ネイティブレビュアーはパケットに署名できます。将来のエージェントは、そこから作業を再開できます。

これでエージェントのインターフェースはどう変わるのか

レビューパケットは、監督のための画面証拠ゲートをつなぎます。

監督画面は、エージェントが作業している間に注意が必要なものを示します。証拠ゲートは、最後に弱い完了報告を止めます。レビューパケットは、その結果を残します。3つが組み合わさると、次のループができます。

  1. オペレーターが目的を委任します。
  2. エージェントは承認とトレースの制御下で行動します。
  3. システムはイベントの発生に合わせて証拠を記録します。
  4. エージェントが作業を要約します。
  5. パケットが各主張を証拠に結びつけます。
  6. 人間が承認し、却下し、または作業を差し戻します。

このループは、エージェントの文章基準も変えます。最終回答は、証拠そのもののふりをしてはいけません。証拠がどこにあり、何が通り、何が未解決なのかを述べるべきです。タスクが公開コンテンツ、顧客データ、金銭、セキュリティ、本番、翻訳に触れるなら、パケットはチャットより長く残るべきです。

簡単なまとめ

重要なエージェント作業では、信頼できる完了成果物として、最終回答をレビューパケットに置き換えるべきです。OpenAI Codexはすでに、検証可能なターミナルログ、テスト出力、承認、テレメトリ、クラウドタスクの記録へ向かっています。12346 Anthropicのフックのライフサイクルも、別のエージェントスタックから同じ実行基盤の形を示しています。5 NISTは信頼の枠組みを与えています。評価はモデルの挙動だけでなく、AIシステムの設計、開発、利用、評価の中に置かれるべきです。7

実践はシンプルです。最終回答は短く保ち、パケットを実際に使える成果物にすることです。

FAQ

AIエージェント作業のレビューパケットとは何ですか?

レビューパケットとは、エージェントが何を依頼され、何が変わり、どのコマンドやツールが実行され、どの承認が行われ、どの確認が通り、何が未検証として残っているのかを記録する、構造化された証拠の束です。文章だけの完了主張ではなく、人間のレビュアーが判断できる対象を提供します。

なぜ最終回答だけでは不十分なのですか?

最終回答は作業を要約しますが、その作業が実際に行われたことは証明しません。エージェントのタスクには、ツール呼び出し、ファイル編集、テスト、デプロイ、翻訳、承認、キャッシュ状態が含まれるようになっています。これらの事実には証拠が必要です。最終回答はパケットを指し示せますが、証明を担うのはパケットです。

レビューパケットには最初に何を含めるべきですか?

まずは、目的、変更ファイル、コマンドやテストの証拠、情報源確認、承認判断、デプロイまたはルートの証拠、未解決の課題から始めます。公開、本番、セキュリティ、金銭、顧客影響のある面に触れる作業では、完全な記録、スクリーンショット、ネイティブレビューのサインオフ、リスクメモを追加します。

すべてのエージェントタスクにレビューパケットが必要ですか?

いいえ。低リスクの探索的タスクなら、通常の要約で終えても構いません。レビューパケットが重要になるのは、人間が署名、マージ、公開、デプロイ、支出、承認を行う場合や、後から結果に依存する場合です。パケットの重さはリスクに合わせるべきです。

レビューパケットと記録はどう関係しますか?

記録は、エージェント実行中に何が起きたかを残します。レビューパケットは、その中から判断に必要なイベントを選び、主張に結びつけます。記録は生の記録です。パケットはレビューの対象です。


参考文献


  1. OpenAI, “Introducing Codex,” OpenAI, 2025年5月16日。Codexがクラウドベースのソフトウェアエンジニアリングエージェントであること、およびCodexがターミナルログとテスト出力の引用を通じて、行動の検証可能な証拠を提供するという主張の情報源。 

  2. OpenAI, “Codex cloud,” OpenAI Developers。サンドボックス化されたクラウドコンテナ内でコードを読み、変更し、実行するCodex cloudタスク、およびバックグラウンド実行と並列タスク実行の情報源。 

  3. OpenAI, “Tracing,” OpenAI Agents SDK。エージェント実行、スパン、LLM生成、ツール呼び出し、引き継ぎ、ガードレール、カスタムイベントの組み込みトレースに関する情報源。 

  4. OpenAI, “Human-in-the-loop,” OpenAI Agents SDK。承認による中断、保留中の承認、シリアライズされたRunState、承認判断後の実行再開に関する情報源。 

  5. Anthropic, “Hooks reference,” Claude Code Docs。PreToolUsePostToolUsePermissionRequestStopなどのClaude Codeライフサイクルイベントに関する情報源。 

  6. OpenAI, “Running Codex safely at OpenAI,” OpenAI, 2026年5月8日。サンドボックス化、承認、ネットワークポリシー、アイデンティティ、管理された設定、OpenTelemetryログエクスポート、コンプライアンスログ、エージェント向けテレメトリに関してOpenAIが説明しているCodex制御の情報源。 

  7. National Institute of Standards and Technology, “AI Risk Management Framework,” NIST。AIプロダクト、サービス、システムの設計、開発、利用、評価に信頼性の考慮を組み込むことに関する情報源。 

関連記事

エージェントには監督画面が必要です

エージェントの監督画面は、自律的なAI作業を点検可能な運用に変えます。より良いチャットよりも、承認、トレース、証拠、復旧、レビュー待ちキューが重要です。

2 分で読める

エージェント型デザインは制御インターフェースのデザインです

エージェント型デザインは、見た目のよいチャットボックスではありません。自律的に動くソフトウェアを可視化し、中断でき、監査でき、信頼に値するものにする制御インターフェースです。

2 分で読める

Ralphループ:自律型AIエージェントを一晩中稼働させる方法

ストップフック、スポーンバジェット、ファイルシステムメモリを備えた自律エージェントシステムを構築しました。失敗から学んだことと、実際にコードをシップする仕組みを紹介します。

3 分で読める