ナレッジソース
ナレッジソースは、エージェントがカタログデータをエージェントコンテキストとして検索・取得するための仕組みです。エージェントがカタログの内容を解釈し、目標の達成に必要な行やフィールドを返すのに役立ちます。カタログエージェントは、デプロイ先のカタログフィールドから行データも受け取ります。ナレッジソースは、+ エージェントコンテキストで検索可能なカタログコンテキストを追加します。Braze Agentsの概要については、Braze Agentsを参照してください。エージェントにナレッジソースを追加するには、カスタムエージェントを作成するを参照してください。
仕組み
ナレッジソースは、+ エージェントコンテキストとして追加するカタログのキュレートされたビューです。ナレッジソースをエージェントにアタッチする際は、ユースケースに役立つフィールドのみを含めます。エージェントがカタログ情報を必要とするとき、ナレッジソースにクエリを実行して一致する行を取得します。Braze はカタログ全体ではなく、関連するカタログデータのみを返すため、エージェントは焦点を絞った正確なコンテキストで作業できます。
たとえば、ユーザーの好きな料理 (カスタム属性) に基づいてニューヨーク市のレストランをおすすめするエージェントを構築するとします。このエージェントは、「nyc_restaurants」カタログのナレッジソースを参照します。そのナレッジソースをエージェントにアタッチする際は、レストラン名、所在地、料理の種類など、エージェントが必要とするフィールドのみを含め、おすすめに役立たないその他のカタログ列は除外します。
エージェントの指示には、その役割と制約が明確に記述されています。
You are a restaurant recommendation agent. Use your knowledge to help find restaurants for the user. Only include filters in your knowledge source query. Don't ask any followup questions. The user's favorite cuisine is {{custom_attribute.${favorite_cuisine}}}
ユーザーの好きな料理がピザの場合、エージェントはナレッジソースに基づいて次のような応答を返すことができます。
Here are some pizza recommendations for you:
- Dale's Pizza (Greenwich Village, Manhattan): Dale's Pizza invites you to savor the taste of authentic New York. Nestled in the heart of Manhattan, this iconic pizzeria offers a warm and inviting atmosphere perfect for any occasion.
- Pizza Palace (Carroll Gardens, Brooklyn): Pizza Palace is a highly-rated culinary gem renowned for its exquisite pizza. This inviting spot offers a warm and modern dining experience.
ナレッジソースを作成する
ナレッジソースを作成するには、次の手順に従います。
- エージェント > ナレッジソースに移動します。
- ナレッジソースを追加を選択します。ドロップダウンでカタログを選択します。
- ドロップダウンからカタログを選択します。
- (オプション) ナレッジソースの内容を説明する説明文を追加します。
- ナレッジソースを作成を選択します。
エージェントの構築中に、エージェントの指示セクションからナレッジソースを作成することもできます。ナレッジを追加 > ナレッジソースを作成を選択します。
AIエージェントでナレッジソースを使用する
ナレッジソースはナレッジソースセクションで管理できます。このセクションでは、どのナレッジソースが有効になっているか、最後に同期されたのはいつかなどの詳細を確認できます。ナレッジソースの名前は、ソースとして使用されているカタログの名前と同じです。
AIエージェントでナレッジソースを使用するには、以下の手順に従います。
- エージェントの指示セクションに移動します。
- + エージェントコンテキスト > ナレッジを追加を選択します。
- ドロップダウンからナレッジソースを選択します。
- ナレッジソースのフィールドを設定を選択し、エージェントが検索時に使用しないカタログフィールドのチェックを外します。
すべてのカタログフィールドを含めると不要なコンテキストが増え、出力の品質が低下する場合があります。ユースケースに関係のないフィールドのチェックを外すと、エージェントは重要なデータに集中できます。
これで、エージェントはナレッジソースを参照し、関連するカタログデータを取得できるようになります。
会話型エージェントの場合は、+ エージェントコンテキストではなく、ワークフローステップのツールとしてナレッジソースを追加します。詳しくは、ナレッジソースを検索を参照してください。
よくある質問
ナレッジソースはどのように機能しますか?
カタログをナレッジソースに変換すると、Braze Agents がカタログ内の単語やフレーズの本当の意味を理解できるようになります。これにより、エージェントが意味のあるデータをより効果的に見つけ、より良い出力につなげられます。
ナレッジソースはいつ作成すべきですか?
エージェントがカタログデータを検索または取得する必要がある場合に、ナレッジソースを作成します。たとえば、キャンバスのジャーニー中に送信先、製品、レストランを検索する場合や、会話型ワークフローで製品や FAQ に関する質問に回答する場合です。検索可能なカタログコンテキストを追加する方法として、ナレッジソースがサポートされています。デプロイ先の行だけをエンリッチするカタログエージェントは、実行時に追加のカタログデータを参照する必要がない限り、ナレッジソースが不要な場合があります。
カタログをエージェントのコンテキストとして直接添付することはまだできますか?
いいえ。新しいエージェントでは、従来のカタログフィールドを追加オプションの代わりにナレッジソースを使用します。既存のエージェントが従来のカタログフィールドを追加オプションで設定されている場合は、同等のナレッジソースに移行するまでの間、そのまま使用し続けることができます。
エージェントにナレッジソースをコンテキストとして与えている場合、元のカタログもコンテキストとして割り当てる必要がありますか?
いいえ。ナレッジソースがエージェントにとってのカタログ参照となるため、両方を添付する必要はありません。ナレッジソースをエージェントに添付する際は、エージェントが必要とするカタログフィールドのみを含めてください。
ナレッジソースの有効性はどのように評価すればよいですか?
カタログをコンテキストとして直接添付している既存のエージェントを複製し、代わりに同等のナレッジソースを使用するように切り替えます。エージェントコンソールでいくつかのテスト呼び出しを実行して精度を確認したうえで、デプロイ先の既存エージェントを置き換えるか、実験パスステップを使用して旧エージェントと新エージェントの AB テストを行い、パフォーマンスへの影響を把握することを検討してください。