AI Agent 運用ガイド
AI Agent ワークフローを初期検証から管理されたパイロットや本番運用へ進めるときに、このガイド群を使います。アクセス、データ、実行記録、レビュー、トラブルシューティング、出力例に焦点を当てています。
前提条件
この運用ガイドを使う前に、チームは次の内容を確認します。
- 設定済み Agent または連携入口を選んでいる。
- ワークフロー所有者とレビュー担当者を決めている。
- テナント、サイト、アセット、設備、シーン、作業記録の境界を特定している。
- 必要なソースシステムと文書を洗い出している。
- 最初の MCP endpoint と scope パッケージを選んでいる。
- 最初の検証実行を読み取り専用で開始することに合意している。
ガイドマップ
| ガイド | 使う場面 | 主な出力 |
|---|---|---|
| Agent ライフサイクルと設定 | テナント Agent を申請、設定、変更、一時停止、廃止する必要があるとき | Agent の目的、所有者、境界、有効なツール、検証状態、変更記録 |
| リスクガバナンスと安全 | ワークフローが計算ツール、ドラフト操作、リスクの高い運用出力を扱う可能性があるとき | リスクレベル、レビューゲート、証拠要件、承認ルール |
| アクセスと Scope 計画 | クライアント、ワークフロー、連携に endpoint と API key が必要なとき | Endpoint 選択、scope リスト、key 所有者、承認境界 |
| 実行時ツールディスカバリ | 設定済みクライアントで実装前に見えるツールを確認する必要があるとき | 実行時ツール一覧、欠落ツールの診断、scope とモジュールの確認 |
| ツール実行ガバナンス | ツール呼び出しをエビデンス、推奨、ドラフト、承認済み記録として一貫して扱う必要があるとき | 実行結果ルール、レビュー記録、ドラフト操作境界、監査エビデンス |
| データ準備状況 | ワークフローに信頼できるアセット、信号、文書、シーン、作業指示コンテキストが必要なとき | データギャップ、ソース対応、品質チェック |
| ワークフロー実行記録 | ワークフロー実行を後からレビューまたは監査する必要があるとき | 入力境界、ツール呼び出し、参照元、レビュー記録、最終結果 |
| 検証と引き継ぎ | パイロットを運用、保全、エンジニアリングチームへ引き継ぐとき | 受入チェック、所有者引き継ぎ、サポート境界、改善ループ |
| トラブルシューティング | クライアント、scope、データ、ツール、出力の問題がワークフローを止めているとき | トリアージ手順と担当チームに渡すエビデンス |
| 例 | 実装前にリクエストとレスポンスのパターンを確認したいとき | 例示 prompt、ツール文脈、出力形式、レビュー注記 |
運用順序
- Agent の目的、所有者、ユーザー入口、ライフサイクル状態を確認します。
- ワークフロー境界、endpoint、scope、key 所有者を定義します。
- 実行時ツールを一覧し、期待する endpoint と scope パッケージと照合します。
- 必要なアセット、信号、文書、シーン、作業記録が準備できているか確認します。
- 読み取り専用でワークフローを実行し、ツール出力と参照元を記録します。
- 前提とレビュー所有者が見える状態になってから計算ツールを追加します。
- 書き込みアクションは、承認、監査、復旧手順の後ろにあるドラフトとして扱います。
- 完了した実行をレビューし、確認済みの修正をデータ層と知識層へ戻します。
レビューゲート
| ゲート | 必須チェック |
|---|---|
| アクセスゲート | クライアントが endpoint と scope で許可されたツールだけを参照できる。 |
| データゲート | 参照元レコードがアセット、場所、シーン、作業指示 ID に安定して対応する。 |
| 出力ゲート | 回答に参照元、前提、未解決のギャップが含まれる。 |
| アクションゲート | 書き込みアクションは承認者が受け入れるまでドラフトに留まる。 |
| 引き継ぎゲート | 運用チームが key、ワークフロー、例外、サポートの責任者を把握している。 |
想定出力
| 出力 | 作成元 |
|---|---|
| Agent 設定サマリー | Agent ライフサイクルと設定。 |
| アクセス計画 | アクセスと Scope 計画。 |
| 実行時ツールディスカバリのスナップショット | 実行時ツールディスカバリ。 |
| リスクと承認のメモ | リスクガバナンスと安全。 |
| データ準備メモ | データ準備状況と DFS ページ。 |
| ツール実行ポリシー | ツール実行ガバナンス。 |
| 読み取り専用検証結果 | ワークフローガイドと例。 |
| 実行記録 | ワークフロー実行記録。 |
| 受入パッケージ | 検証と引き継ぎ。 |
| 問題エビデンス | トラブルシューティングと MCP エラーと監査。 |
失敗時の扱い
| 問題 | 次に読むページ |
|---|---|
| クライアントが接続またはツール一覧に失敗する | トラブルシューティング と MCP エラーと監査 |
| Agent 設定が変わった、または廃止すべき | Agent ライフサイクルと設定 |
| Scope パッケージが広すぎる、または狭すぎる | アクセスと Scope 計画 |
| 期待したツールがない、または想定外のツールが見える | 実行時ツールディスカバリ |
| ツール結果をドラフト操作または承認済み記録にする必要がある | ツール実行ガバナンス |
| 参照元データが古い、または不完全 | データ準備状況 と DFS |
| 出力を受け入れられない | ワークフロー実行記録 と 検証と引き継ぎ |
次に読むページを選ぶ
- クライアントまたは権限モデルを設計中の場合は、アクセスと Scope 計画 から始めます。
- 設定済み Agent を作成、変更、一時停止、廃止する場合は、Agent ライフサイクルと設定 から始めます。
- クライアント接続後に見えるツールセットを確認する場合は、実行時ツールディスカバリ から始めます。
- ワークフローが外部システム、DFS パイプライン、顧客文書に依存する場合は、データ準備状況 から始めます。
- 実行可能なパイロットがあり、再現できるレビュー証跡が必要な場合は、ワークフロー実行記録 から始めます。