Skip to content

ナレッジソース

ナレッジソースは、AIエージェントがカタログデータを解釈し、目標を達成するために適切な情報を取得するのに役立ちます。Brazeエージェントの概要については、Brazeエージェントを参照してください。エージェントにナレッジを追加するには、カスタムエージェントの作成を参照してください。

仕組み

ナレッジソースはエージェントコンテキストの一種です。AIエージェントはナレッジソースを参照することで、カタログをエージェントの指示で直接参照する場合よりも正確にカタログからデータを取得できます。

たとえば、ユーザーのお気に入りの料理（カスタム属性）に基づいてニューヨーク市のレストランをおすすめするエージェントを構築するとします。このエージェントは「nyc_restaurants」カタログのナレッジソースを参照します。そのナレッジソースを作成する際、レストラン名、場所、料理ジャンルなど、エージェントが必要とするフィールドのみを含め、おすすめに関係しない他のカタログ列は除外します。

エージェントの指示には、その役割と制約が明確に記述されています：

1

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}}}

ユーザーのお気に入りの料理がピザの場合、エージェントはナレッジソースに基づいて次のようなレスポンスを返すことができます：

1
2
3

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.

ナレッジソースの作成

ナレッジソースを作成するには:

  1. エージェントコンソール > ナレッジソースに移動します。
  2. ナレッジソースを追加を選択します。ドロップダウンでカタログを選択します。
  3. ドロップダウンからカタログを選択します。
  4. カタログフィールドを確認し、エージェントのユースケースに該当しないものの選択を解除します。取得や生成に役立たないカタログフィールドは除外することをお勧めします。ナレッジソースはエージェントが必要とするフィールドのみに限定してください。
  5. （任意）ナレッジソースの内容を説明する説明文を追加します。
  6. ナレッジソースを追加を選択します。

すべてのカタログフィールドを含めると、不要なコンテキストが追加され、出力品質が低下する可能性があります。ユースケースに関連しないフィールドの選択を解除すると、エージェントが重要なデータに集中できるようになります。

カタログ「nyc_restaurants」を参照するナレッジソース「nyc_restaurants」

エージェントの構築中にナレッジソースを作成することもできます。エージェントの指示セクションに移動し、ナレッジを追加 > ナレッジソースを作成を選択します。

AI エージェントでナレッジソースを使用する

ナレッジソースはナレッジソースセクションから管理できます。ここでは、どのナレッジソースがアクティブか、最後に同期されたのはいつかなどの詳細を確認できます。ナレッジソースの名前は、ソースとして使用されるカタログの名前と一致します。

AI エージェントでナレッジソースを使用するには、次の手順に従います。

  1. エージェントの指示セクションに移動します。
  2. + エージェントコンテキスト > ナレッジを追加を選択します。
  3. ドロップダウンからナレッジソースを選択します。

これで、エージェントがナレッジソースを参照し、関連するカタログデータを取得できるようになります。

よくある質問

ナレッジソースはどのように機能しますか？

カタログをナレッジソースに変換すると、Braze エージェントがカタログ内の単語やフレーズの真の意味を理解できるようになり、より効果的に有意義なデータを見つけて、より良い出力を生成できます。

ナレッジソースはいつ作成すべきですか？

カタログデータをコンテキストとして必要とするカスタムエージェント（キャンバスステップエージェントまたはカタログエージェント）をセットアップする際に、ナレッジソースを作成してください。ナレッジソースを使用すると、エージェントの指示でカタログを直接参照するよりも、エージェントがカタログデータをより正確に取得できるようになります。

エージェントにコンテキストとしてナレッジソースが与えられている場合、元のカタログもコンテキストとして割り当てる必要がありますか？

いいえ。ナレッジソースはエージェントのコンテキストとしてカタログに置き換わるため、両方をアタッチする必要はありません。ナレッジソースを作成する際は、エージェントが必要とするカタログフィールドのみを含めてください。

ナレッジソースの有効性をどのように評価すべきですか？

通常のカタログを参照している既存のエージェントを複製し、同等のナレッジソースを参照するように切り替えてください。エージェントコンソールでいくつかのテスト呼び出しを実行して精度を確認した後、既存のエージェントがデプロイされている場所でそのエージェントを置き換えるか、実験パスステップを使用して旧エージェントと新エージェントのABテストを行い、パフォーマンスへの影響を把握することを検討してください。
New Stuff!