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テスト（Experiment Pathステップを使用）を行ってパフォーマンスへの影響を把握することを検討してください。
New Stuff!