Knowledge Baseツール
Knowledge Baseツールにより、Agentは接続されたデータソースを照会し、実際の内容に基づいて質問に答えることができます。
使用するタイミング
- Agentがあなたのドキュメント、データに基づいて質問に答える必要がある場合
- 答えに明確なソースが必要で、AIが自分で作成したものではない場合
- 特定の製品仕様、ポリシー、プロセスなどを引用する必要がある場合
事前準備
使用する前に、まずワークスペースでデータソースを接続する必要があります。
利用可能なナレッジベースがない場合は追加できません
- ワークスペースに確立されたナレッジベースがない場合、ツールセレクターの「ナレッジベース」オプションは灰色表示され、「すべてのナレッジベースが選択されています」と表示されます。この時点ではKnowledge Baseツールを追加できません。
- まず少なくとも1つのナレッジベースを作成してください。
ワークスペースの制限
- Knowledge Baseツールは同じワークスペース内のデータソースのみ使用できます。
設定手順
ステップ1:Knowledge Baseツールを追加
Toolsセクションで「ツールを追加」をクリックし、ツールセレクターを開きます。
ステップ2:データソースを選択
ツールセレクターの「ナレッジベース」グループで、使用したいデータソース(Notion、Google Driveなど)を直接選択します。システムは既に選択されたデータソースを自動的にフィルタリングして、重複選択を防ぎます。
ステップ3:「When to Use」の設定
Agentにこのナレッジベースをいつ使用するかを伝えます。
例:
ユーザーが製品機能、仕様、または価格について質問したときは、このナレッジベースを照会してください。
ナレッジベースの内容を優先的に使用して回答し、関連情報が見つからない場合は、ユーザーに通知してカスタマーサービスへの連絡を提案してください。
ユーザーが会社のポリシー、休暇規定、福利厚生について質問したときは、このナレッジベースを照会してください。
引用する際は、ソースドキュメントの名前を記載してください。
ステップ4:追加を確認
確認をクリックすると、ツールがToolsリストに表示されます。
ツールのテスト
追加後、右側のパネルでテストします:
- ナレッジベース照会をトリガーすべき質問を入力
- Agentがツールを使用したかを観察
- 回答が正しい内容を引用しているかを確認
ツールリスト表示
追加されたKnowledge Baseツールは「ツール」セクションの「ナレッジベース」グループに表示され、各ツールには次のものが表示されます:
- データソースのアイコンと名前(Notion、Google Driveなど)
- 展開して「When to Use」を表示または編集可能
- 削除ボタンをクリックしてツールを削除可能
複数のナレッジベースツールは追加された順序で表示され、識別と管理が容易です。
複数のナレッジベース
複数のKnowledge Baseツールを追加でき、各ツールは異なるデータソースに接続します。各ナレッジベースツールはツールリストに独立して表示され、異なる「When to Use」を設定できます。
選択済みナレッジベースは重複表示されません
- データソース(「Notion」など)をナレッジベースツールとして既に追加した後、そのデータソースはツールセレクターに再表示されず、重複選択を防ぎます。
- まだ選択されていないデータソースのみが選択リストに表示されます。
使用シナリオ:
- 製品ナレッジベース + カスタマーサービスFAQナレッジベース
- 技術ドキュメント + ビジネスドキュメント
- 異なる言語バージョンのコンテンツ
各ナレッジベースは独立した「When to Use」を持つことができ、Agentにどの状況でどのソースを照会するかを知らせます。
ベストプラクティス
When to Useは具体的に
❌ 十分に具体的でない:
このツールを使用してデータを検索
✅ 具体的で明確:
ユーザーが注文処理フロー、返品ポリシー、送料計算について質問したときは、このカスタマーサービスナレッジベースを照会してください。
回答時に関連するドキュメントの段落を引用してください。
Agentの「Core Instruction」と併用
Agentの「Core Instruction」でもナレッジベースの存在について言及します:
## 回答ルール
- 製品関連の質問は、製品ナレッジベースを優先的に照会
- 回答時に情報ソースを記載
- ナレッジベースに関連コンテンツがない場合は、正直に通知
よくある質問
テスト中、Agentが期待どおりにナレッジベースを使用しません。どうすればよいですか?
確認事項:
- 「When to Use」がトリガー条件を明確に説明しているか
- 「Core Instruction」でナレッジベースの使用について言及しているか
- テスト質問がトリガー条件を満たしているか
より明示的な言い回しを試してください。例:「製品ドキュメントによると、XX機能はどのように使用しますか?」
回答がソースを引用しない場合はどうすればよいですか?
「When to Use」または「Core Instruction」に追加します:
「回答時にソースドキュメント名を記載」または「ナレッジベースの内容を引用する際はソースを注釈」
ナレッジベースの内容が更新された後、再設定する必要がありますか?
データソースの内容が更新された後、「ナレッジベース」に移動してファイルの内容が最新の状態を正しく反映していることを確認することをお勧めします。Agentでツールを再設定する必要はありませんが、Agentを再度テストして、動作が最新のナレッジベースの状態に期待どおりに対応していることを確認することをお勧めします。
データソースが削除された場合はどうなりますか?
ワークスペース内のデータソースが削除されると、システムは対応するKnowledge BaseツールをAgentのツール設定から自動的に削除し、通知メッセージを表示します。
Agentのツール設定を定期的にチェックして、すべてのナレッジベースツールが正常に機能していることを確認することをお勧めします。ツールが自動的に削除されたことに気付いた場合は、データソースを再接続してからツールを再度追加してください。
特定のデータソースを選択できないのはなぜですか?
考えられる理由:
- そのデータソースは現在のAgentが配置されているワークスペースに属していない
- そのデータソースは既に選択されている
- そのデータソースはワークスペースから削除されている
データソースのステータスを確認するか、管理者に連絡してワークスペースの権限を確認してください。
次のステップ
- Web Search - リアルタイム情報で補完
- Call Agent - 他のAgentに協力してもらう
- ツール概要に戻る