実行時ツール検出
実行時ツール検出は、特定のクライアント、API key、テナント、モジュール、設定済み Agent がその時点で見られるツールを確認するための手順です。Scope、モジュール有効化、テナント設定、Agent とツールの関連付けが変わると、表示されるツールセットも変わります。
ワークフローで利用可能なツールを確認する場合、空のツール一覧を調べる場合、新しい Agent ワークフローのアクセスパッケージを準備する場合に、このページを使います。
検出フロー
表示ツールに影響する要素
ツール一覧はテナントごとに決まります。アクセス経路と設定済みワークフローがそのツールを支える場合に表示されます。
| 要素 | 制御する内容 | レビュー観点 |
|---|---|---|
| Endpoint | クライアントが入る製品またはモジュールの領域。 | クライアントはこのワークフローに合う endpoint を使っているか。 |
| API key | クライアントが代表するテナントとアクセスパッケージ。 | API key はこのテナント、ワークフロー、環境向けに発行されているか。 |
| Scope | 表示または呼び出しできるツール群。 | API key はタスクに必要な最小限の承認済み scope を持っているか。 |
| モジュール有効化 | 製品モジュールがテナントで利用できるか。 | モジュールは顧客環境で有効化され、使える状態か。 |
| Agent とツールの関連付け | 現在の設定済み Agent に属するツール。 | ツールは Agent Hub から入る Agent に割り当てられているか。 |
| リスクとレビュー境界 | ツールが読み取り専用、分析、ドラフト、アクションのどれに使われるか。 | ワークフローにそのツール種別に必要なレビュー経路があるか。 |
| データ準備状況 | ツールが有用な結果を返せるか。 | 必要な記録、文書、信号、シーンは利用できる状態か。 |
検出結果をテストする前に、アクセスと Scope 計画でアクセスパッケージを準備します。
検出チェックリスト
ツールを前提にプロンプト、自動化、ワークフローを作る前に、次を確認します。
- クライアントが正しい endpoint に接続している。
- API key が想定したテナントと環境に属している。
- 実行時検出で、ワークフローが期待するツール名が返る。
- API key がそのツールに必要な scope を持っている。
- Agent Hub の Agent 入口がユーザーの期待と合っている。
- 必要な参照元データ、文書、シーン、運用記録が利用できる。
- 起動前に、不足ツール、予期しないツール、scope 不足を記録している。
採用された実行では、ワークフロー実行記録に表示ツールセットを保存します。
ツール表示パターン
| パターン | よくある意味 | 次の手順 |
|---|---|---|
| ツール一覧が空 | Endpoint は到達できるが、API key に対応するツール表示権限がない。 | Endpoint、テナント、scope、モジュール有効化、Agent とツールの関連付けを確認する。 |
| 読み取り専用ツールだけが見える | アクセスパッケージは調査を支える。 | 読み取り専用ワークフローに保つか、レビュー済みのアクションアクセスを申請する。 |
| モジュールツールが見えない | そのテナントでモジュールが有効でない、または endpoint が合っていない可能性がある。 | モジュール有効化と endpoint 選択を確認する。 |
| ツールは見えるが呼び出しがブロックされる | 検出は成功したが、scope、入力、リスクゲート、レビュー方針が実行を止めている。 | ツール実行ガバナンスで呼び出し経路を確認する。 |
| ツール表示がユーザーごとに異なる | API key、scope、テナントコンテキスト、Agent とツールの関連付けが異なる。 | アクセスパッケージと Agent Hub 入口を比較する。 |
| ツール出力が弱い | ツールアクセスはできるが、参照元データが不完全または古い。 | 利用範囲を広げる前にデータ準備状況を確認する。 |
ツールリファレンスと実行時検出
MCP Tool Reference は、利用できるツール群、期待されるパラメーター、scope 計画を説明します。実行時検出は、現在のクライアントが現在のテナントで実際に使える内容を確認します。
両方を使い分けます。
| 目的 | 使うもの |
|---|---|
| 候補ツールと scope を計画する | Tool Reference と Scope Reference。 |
| 現在のアクセスパッケージを検証する | 実行時検出。 |
| 不足ツールを調べる | 実行時検出と endpoint、scope、モジュール、Agent 確認。 |
| 実行証拠を残す | 実行記録内の実行時表示ツール一覧。 |
検出結果と Agent Hub
Agent Hub はユーザー向けの入口です。実行時検出は、設定済み Agent が期待されたツールを使えるかを技術的に確認します。
Hub 入口を準備完了とする前に、次を確認します。
- カード名と概要がツールで支えられるワークフローに合っている。
- 入口ルートがユーザーを正しいモジュール、ダッシュボード、アシスタント、ワークフローへ送る。
- 表示ツールセットがページで約束するタスクを支える。
- データヘルス表示がツールの参照元依存関係に合っている。
- アクション可能なツールに確認または承認経路がある。
製品入口の管理には Agent Hub と Agent ライフサイクルと設定 を使います。
トラブルシューティング
| 症状 | 確認項目 |
|---|---|
| クライアントが接続できない | Host、endpoint path、末尾スラッシュ、API key header。 |
| ツール一覧が空 | テナント、API key、scope、endpoint、モジュール有効化、Agent とツールの関連付け。 |
| ツール名の呼び出しが失敗する | 固定したツール想定を、実行時検出に置き換える。 |
| 期待するモジュールツールが見えない | モジュール endpoint と顧客環境での有効化を確認する。 |
| 出力に証拠が足りない | 参照元準備状況と証拠要件を確認する。 |
| アクションツールがブロックされる | Scope、リスクゲート、確認、人による承認、監査要件を確認する。 |
詳細な失敗調査には MCP エラーと監査 を使います。
関連ページ
| 目的 | ページ |
|---|---|
| Endpoint と scope を計画する | アクセスと Scope 計画 |
| 実行挙動を確認する | ツール実行ガバナンス |
| リスクとレビューゲートを定義する | リスクガバナンスと安全性 |
| ツールと scope のリファレンスを見る | MCP Tool Reference と Scope Reference |
| エラーと監査を調べる | MCP エラーと監査 |