ナレッジベース

ナレッジベースは、事前学習済みデータを超える、特定の分野に関する情報をエージェントに提供するドキュメントのコレクションです。ドキュメントをエージェントに添付すると、その内容をもとに質問へ正確かつ一貫して回答できます。

ドキュメントの作成、編集、整理については、ドキュメントを管理を参照してください。

概要

適切に整理されたナレッジベースは、ユースケースで重要となる情報をエージェントに提供します。一般的な例は次のとおりです。

• 製品カタログ：仕様、価格、在庫状況。
• ポリシー：返品、福利厚生、オンボーディングなどの人事、企業、サポートポリシー。
• 技術ドキュメント：デベロッパー向けガイドとAPIリファレンス。
• 顧客向けFAQ：よくある質問への一貫した回答。

1つのドキュメントを複数のエージェントに添付できるため、共有ナレッジを1か所で管理できます。

エージェントによるナレッジの利用方法

各ドキュメントの使用モードは、エージェントがそのドキュメントを利用する方法を、次の2通りから制御します。

• フルコンテキスト：エージェントはドキュメントの全文をシステムプロンプトに配置し、すべてのターンでドキュメント全体を利用できるようにします。コンテキストを消費するため、収まるほど小さいドキュメントでのみ使用できます。大きなドキュメントでは代わりにRAGを使用する必要があります。
• 検索拡張生成（RAG）：ドキュメントは事前にインデックス化され、会話時には各ユーザークエリに最も関連性の高い箇所だけが取得され、エージェントが利用します。これにより、コンテキストウィンドウよりはるかに大きいナレッジベースをエージェントが活用できます。設定と制限については、RAGガイドを参照してください。

各ドキュメントの使用モードを設定して、エージェントが使用する方法を選択します。

エージェントはフォルダーには常にRAGを介してアクセスし、プロンプトに配置することはありません。そのため、フォルダーを使用するにはエージェントでRAGを有効にする必要があります。

対応ファイル形式

ドキュメントは、ファイル、URL、またはテキストから作成できます。アップロードするファイルでは、ファイルあたり最大20MBまで、以下の形式に対応しています。

サイズ制限

ドキュメントをフルコンテキストで使用できるのは、抽出されたテキストがプロンプトに収まる場合のみで、上限はおよそ300,000文字です。より大きなドキュメントは、代わりにRAGを通じて使用する必要があります。RAG用にインデックス化できるドキュメントの合計サイズはサブスクリプションのティアによって異なります。詳しくはRAGの使用制限を参照してください。

Claudeまたは別のMCPクライアントから、ホスト型MCPサーバーを通じて、エージェントの現在のナレッジベースサイズを確認できます。

ベストプラクティス

コンテンツの品質

エージェントの目的に関連する、明確で適切に構造化された情報を提供してください。

サイズ管理

検索と処理の精度を高めるため、大きなドキュメントは小さく焦点を絞った単位に分割してください。

定期的な更新

情報を最新かつ正確に保つため、ナレッジベースを定期的に確認して更新してください。

ナレッジの不足を特定

会話の文字起こしを確認して、ユーザーが回答を得るのに苦労しているトピックを見つけ、不足しているコンテキストをナレッジベースに追加してください。