Agent ライフサイクルと設定
FactVerse AI Agent は、運用能力として管理します。設定済み Agent には、業務目的、オーナー、ユーザー入口、データコンテキスト、ツール境界、レビュー経路、実行記録が必要です。
テナントに新しい Agent を用意する場合、既存 Agent を変更する場合、または通常運用に移せるか判断する場合は、このページを使います。
ライフサイクルフロー
設定パッケージ
Agent Hub に Agent を表示する前に、短い設定パッケージを準備します。
| 項目 | 意味 | レビュー観点 |
|---|---|---|
| Agent 名 | ユーザーが認識できる入口を作る。 | 対象ユーザーが追加説明なしで理解できる名前か。 |
| 目的 | Agent を具体的な運用タスクに結び付ける。 | どの判断、記録、ワークフローを支援するか。 |
| オーナー | 運用と変更に責任を持つ人またはチームを示す。 | 挙動変更とレビュー結果を誰が受け入れるか。 |
| ステータス | 利用可能、制限あり、計画中、終了済みの状態を示す。 | ユーザーは今日この Agent に入るべきか。 |
| 入口ルート | 正しいモジュール、ダッシュボード、アシスタント、ワークフローへ送る。 | 入口はユーザーが期待する作業に合っているか。 |
| データ依存関係 | 必要な参照元システム、文書、シーン、記録を示す。 | 鮮度と品質の期待値は明確か。 |
| ツール境界 | Agent が発見して呼び出せるツールを定義する。 | 表示されるツールは目的と権限に合っているか。 |
| レビュー境界 | read-only、分析、ドラフト、確認、承認の扱いを定義する。 | どの出力を受け入れ、どの出力をレビューするか。 |
| 実行記録 | 証拠、判断、アクション、フィードバックを残す。 | 後から何が起きたかを再確認できるか。 |
Agent を計画する
まず運用タスクを定義し、そのタスクに合うモデル、ツール、レビュー経路を選びます。使いやすい Agent 計画には、次の内容を含めます。
- Agent を使うユーザーロールまたはチーム。
- テナント、拠点、アセット群、設備、シーン、作業記録の境界。
- Agent が扱う通常の質問、タスク、判断パッケージ。
- 関係するデータソースと製品モジュール。
- 想定する出力タイプ。
- 影響の大きい結果をレビューまたは承認する担当者。
参照元品質が出力に影響する場合は、計画をデータ準備状況につなげます。
Hub 入口を設定する
Agent Hub には、設定済み Agent ごとに簡潔な入口を表示します。
| Hub 項目 | 設定ガイド |
|---|---|
| 名前 | 業務能力または運用ロールを使う。 |
| 概要 | タスクを一文で説明する。 |
| ステータス | 利用可能、制限あり、計画中、終了済みを一貫して使う。 |
| 入口 | モジュールページ、ワークフロー、ダッシュボード、アシスタント、承認経路へリンクする。 |
| データヘルス | 遅延、欠落、レビュー中のデータが回答に影響する場合は表示する。 |
| レビュー注記 | Agent が証拠、ドラフト、承認が必要なアクションのどれを返すかを示す。 |
入口モデルの詳細は Agent Hub を参照してください。
ツールとアクセスを関連付ける
ツールアクセスは Agent の目的に合わせます。
- Agent の運用タスクを確認する。
- そのタスクに必要な最小限のツールセットを選ぶ。
- MCP scope とテナント権限を選択したツールに合わせる。
- 各ツールが read-only、分析、ドラフト生成、アクション実行のどれに当たるか確認する。
- 対象ユーザーが使うアクセスパッケージで実行時ツール検出をテストする。
- 起動前に不足しているツール、ブロックされたツール、scope の不足を記録する。
アクセスパッケージの準備には、アクセスと Scope 計画と MCP Tool Reference を使います。
起動前に検証する
通常運用の前に、正常ケース、弱いデータケース、ブロックされたアクションケースを含む小さな検証セットを実行します。
| 検証領域 | 確認内容 |
|---|---|
| ID とテナント境界 | Agent が想定したテナント、拠点、アセット、権限コンテキストだけを見る。 |
| データ準備状況 | 必要な記録、信号、文書、シーンが存在する、または不足が明示される。 |
| 実行時ツール検出 | Agent が実環境で想定したツールを見られる。 |
| 証拠品質 | 回答に参照元、タイムスタンプ、前提、未解決事項が含まれる。 |
| レビュー挙動 | ドラフト、確認、承認、ブロックされたアクションが設定済み経路に従う。 |
| 実行記録 | Tool calls、出力、レビュー判断、フィードバックが記録される。 |
検証証拠の整理には ワークフロー実行記録 を使います。
運用して改善する
通常運用では、軽量なレビューリズムを保ちます。
| 運用シグナル | 対応 |
|---|---|
| データ欠落が繰り返される | 利用拡大の前に、参照元マッピング、鮮度、文書を修正する。 |
| ツールが頻繁にブロックされる | Scope、モジュール有効化、Agent とツールの関連付けを確認する。 |
| 低信頼の回答が多い | ワークフローに参照証拠、例、レビュー結果を追加する。 |
| レビューが詰まる | どの出力タイプを誰が承認するかを明確にする。 |
| 採用された修正がある | 修正結果をワークフロー設計と運用手順書に反映する。 |
| 利用が減る | 入口、名前、タスク境界が実際の作業に合っているか確認する。 |
Agent を変更または終了する
変更は管理された更新として扱います。ツールアクセス、レビュー境界、入口ルートを変える前に、理由、想定されるユーザー影響、検証計画を記録します。
参照元システム、オーナー、入口、運用目的が現在の作業に合わなくなった場合は、Agent を終了します。過去の実行記録を保持し、Hub の利用中エントリから外します。
起動チェックリスト
| チェック | 準備完了の条件 |
|---|---|
| 目的 | Agent に明確な運用タスクとユーザーロールがある。 |
| オーナー | 製品または運用オーナーが変更とレビュー結果を受け入れる。 |
| データ | 参照元システム、文書、シーン、記録に鮮度期待値がある。 |
| アクセス | MCP endpoint、scope、テナント権限、ツール検出をテスト済み。 |
| レビュー | 出力タイプと承認経路が明確。 |
| 証拠 | ワークフローが参照元と実行記録を生成できる。 |
| 引き継ぎ | ユーザーが Agent の入口と問題の報告先を理解している。 |
関連ページ
| 目的 | ページ |
|---|---|
| プラットフォームモデルを理解する | Agent Platform Overview |
| ユーザー入口を設計する | Agent Hub |
| 参照元準備を計画する | データ準備状況 |
| アクセスと scope を計画する | アクセスと Scope 計画 |
| 検証証拠を残す | ワークフロー実行記録 |