Call Agentツール

Call AgentツールによりAgentは他のAgentを呼び出してタスクの支援を受け、分業と協力を実現できます。

使用するタイミング

タスクが複数の専門分野に関わる場合
既に作成されたAgentの能力を再利用したい場合
複雑なプロセスの階層的な処理が必要な場合

使用シナリオ例

メインAgent	呼び出されるAgent	シナリオ
カスタマーサービスハブ	テクニカルサポートAgent、請求Agent	質問タイプに基づいて転送
セールスアシスタント	製品仕様Agent、見積もりAgent	複合的な問い合わせ
プロジェクト管理	スケジューリングAgent、リソース照会Agent	多面的な調整

事前準備

Call Agentツールを追加する前に、次のことが必要です：

ターゲットAgentの作成：ワークスペースで少なくとも1つのAgentを作成
ターゲットAgentの公開：ターゲットAgentが少なくとも1つのバージョンを公開していることを確認

公開バージョンが必須

ターゲットAgentが一度もバージョンを公開していない場合、「常に最新の公開バージョンを選択」（Always choose latest published version）にチェックを入れても、そのツールは実行時に自動的にスキップされます。
ターゲットAgentが少なくとも1つのバージョンを公開していることを確認してください。

設定手順

ステップ1：Call Agentツールを追加

Toolsセクションで「ツールを追加」をクリックし、ツールセレクターを開きます。

ステップ2：ターゲットAgentを選択

ツールセレクターの「エージェントツール」グループで、呼び出したいAgentを選択します。システムは既に選択されたAgentを自動的にフィルタリングして、重複選択を防ぎます。

利用可能なAgentがない場合は追加できません

ワークスペースに作成および公開されたAgentがない場合、ツールセレクターの「エージェントツール」オプションは灰色表示され、「すべてのエージェントツールが選択されています」と表示されます。この時点ではCall Agentツールを追加できません。
まず少なくとも1つのAgentを作成して公開してください。

ステップ3：バージョンを選択

Call Agentツールを追加するとき、システムはデフォルトで「最新の公開バージョン」を選択します。

選択できます：

オプション	説明	適したシナリオ
最新の公開バージョン（デフォルト）	ターゲットAgentの最新の公開バージョンを自動的に使用	迅速な反復、テストフェーズ
固定バージョン	特定のバージョンを指定、自動更新されない	安定した運用、本番環境

デフォルトは最新の公開バージョン

システムはデフォルトで「最新の公開バージョン」を選択します。
ターゲットAgentが一度もバージョンを公開していない場合は、まず少なくとも1つのバージョンを公開するか、「固定バージョン」に切り替えて既存のバージョンを選択してください。

未公開バージョンの深刻度

「最新の公開バージョン」を選択したが、ターゲットAgentが一度もバージョンを公開していない場合、そのCall Agentツールは実行時に自動的にスキップされ、Agentはそのツールを呼び出せません。システムはツール設定に黄色の警告アイコンを表示してこの問題を通知します。
強く推奨：Call Agentツールを設定する前に、ターゲットAgentが少なくとも1つのバージョンを公開していることを確認するか、「固定バージョン」に変更してください。

ステップ4：「When to Use」の設定

AgentにこのAgentをいつ呼び出すかを伝えます。

例：

ユーザーが技術的な質問、トラブルシューティング、APIの使用方法について質問したときは、
テクニカルサポートAgentを呼び出して回答を支援してもらってください。
ユーザーの質問の原文を渡してください。

見積もりの計算または価格の照会が必要な場合は、見積もりAgentを呼び出してください。
必要な仕様と数量の情報を渡してください。

ステップ5：追加を確認

確認をクリックすると、ツールがToolsリストに表示されます。

バージョン選択の推奨事項

「最新の公開バージョン」を使用

開発およびテストフェーズで、改善を自動的に有効にしたい場合
ターゲットAgentの最新の公開バージョンを自動的に使用したい場合

デフォルトオプション

Call Agentツールを追加するとき、システムはデフォルトで「最新の公開バージョン」を選択します。ターゲットAgentがまだバージョンを公開していない場合は、まず公開するか、「固定バージョン」に変更してください。

「固定バージョン」を使用

本番サービス
安定した予測可能な動作が必要
ターゲットAgentに大きな変更のリスクがある

バージョン番号の表示

「固定バージョン」を選択すると、システムはターゲットAgentの利用可能なすべてのバージョン番号（v1、v2、v3...）を表示し、適切なバージョンを選択しやすくします。

実行方法

Agentが複数のAgentを呼び出す必要がある場合：

順次実行：1つが完了してから次を呼び出す
結果統合：メインAgentは各呼び出し結果を統合してユーザーに返信

ツールリスト表示

追加されたCall Agentツールは「ツール」セクションの「エージェントツール」グループに表示され、各ツールには次のものが表示されます：

ターゲットAgentの名前（例：「氏名と電話番号を収集」）
バージョンラベル：
「最新の公開バージョン」が選択されている場合：「公開バージョンを使用」ラベルを表示
「固定バージョン」が選択されている場合：バージョン番号を表示（例：「v3」）
ターゲットAgentがバージョンを公開していない場合：黄色の警告アイコンを表示
展開して詳細設定を表示可能（Agent説明、バージョン選択、「When to Use」を含む）
削除ボタンをクリックしてツールを削除可能

数量制限

最大5個のCall Agentツールを追加可能
この制限はAgentが効果的にツールを選択して使用できるようにするためです

呼び出し深度の制限

システムは最大1レベルの呼び出し深度に制限されています。複数のCall Agentツールを設定しても、呼び出されたAgentは他のAgentを再び呼び出すことはできません。

ベストプラクティス

明確な分業

呼び出される各Agentには明確な専門分野が必要です：

テクニカルサポートAgent：API、SDK、トラブルシューティングを処理
請求Agent：請求、サブスクリプション、請求書の問題を処理
製品Agent：機能紹介、使用チュートリアルを処理

Agentの「Core Instruction」と併用

メインAgentの「Core Instruction」で説明します：

## 協力ルール
- 技術的な質問はテクニカルサポートAgentに委託
- 請求の質問は請求Agentに委託
- 各Agentの返信を統合した後、統一されたトーンでユーザーに回答
- 質問が複数の分野にまたがる場合は、まず主要な分野を判断してから呼び出す

十分なコンテキストを渡す

When to Useでどのような情報を渡すかを説明します：

呼び出し時に渡すもの：
- ユーザーの元の質問
- 関連する会話履歴
- 既知のユーザー情報（ある場合）

呼び出しのテスト

追加後、呼び出しが正常に機能するかテストします：

呼び出しをトリガーすべき質問をする
ターゲットAgentが呼び出されたかを観察
回答が呼び出されたAgentの結果を統合しているかを確認

よくある質問

呼び出されたAgentは他のAgentを再び呼び出せますか？

いいえ。システムは最大1レベルの呼び出し深度に制限されています：

✅ 許可：Agent A → Agent B（1レベルの呼び出し）
❌ 許可されない：Agent A → Agent B → Agent C（入れ子の多レベル呼び出し）

Agent Bが呼び出されると、システムは自動的にそのCall Agentツールを無効にし、他のAgentを再び呼び出すことを防ぎます。この制限は次のためです：

無限ループと過度の複雑さを防ぐ
デバッグの難しさを軽減
リソース消費を制御

呼び出しが失敗した場合はどうなりますか？

メインAgentはエラーメッセージを受け取り、通常はユーザーにリクエストを完了できないことを通知します。Instructionにエラー処理の指示を追加することをお勧めします。

ユーザーにどのAgentに回答してもらうか選択させることはできますか？

はい、メインAgentの「Core Instruction」でこのフローを設計できます。例：「まずユーザーに質問タイプを尋ね、その後どの専門Agentを呼び出すかを決定する」。

呼び出されたAgentが削除された場合はどうなりますか？

ワークスペース内のターゲットAgentが削除されると、システムは対応するCall AgentツールをAgentのツール設定から自動的に削除し、通知メッセージ（Toast）を表示します。

Agentのツール設定を定期的にチェックして、すべてのCall Agentツールが正常に機能していることを確認することをお勧めします。ツールが自動的に削除されたことに気付いた場合は、ターゲットAgentを再作成して公開してからツールを再度追加してください。

特定のAgentを選択できないのはなぜですか？

考えられる理由：

そのAgentは現在のAgentが配置されているワークスペースに属していない
そのAgentは既に選択されている
そのAgentはワークスペースから削除されている

Agentのステータスとタイプを確認するか、管理者に連絡してワークスペースの権限を確認してください。

次のステップ

Request Form - 構造化データを収集
Knowledge Base - データソースを接続
ツール概要に戻る