コンテキスト

Add an index or a set of Data Fabric entities as an agent context, then configure its search strategy, scope, or entity type to control what your agent retrieves.

エージェントでインデックスを使用する

インデックスにより、エージェントは権限を持つナレッジ ベースにアクセスできるようになります。これは、エージェントが業務に固有のデータを使用して推論を行うのに役立ちます。コンテキストを効果的に活用するためのガイダンスについては、「コンテキスト エンジニアリングのベスト プラクティス」をご覧ください。

コンテキスト グラウンディング機能向けにカスタム モデルを設定するには「LLM を設定する」をご覧ください。

To add an index as context for your agent, take the following steps in the Contexts section:

1. Select Add context, then select Context Grounding Indexes.
2. 利用可能なリストからインデックスを選択するか、[新規作成] を選択して Orchestrator で新しいインデックスを作成します。詳しくは、「インデックス」をご覧ください。
3. コンテキストの説明を入力します。
4. [プロパティ] パネルを使用して [検索ストラテジ] を設定します。以下の設定を使用して、コンテキストのクエリの種類、精度、および関連性を制御できます。
   • セマンティック: テキストのデータ ソースを使用する場合、セマンティック クエリ用にこのオプションを選択します。
     • 関連性スコアのしきい値: 関連するチャンクの取得および再ランク付けの後に適用される類似性スコアのしきい値を指します。関連するチャンクのスコアがこのしきい値を下回る場合、そのチャンクは返されません。このフィールドを使用すると、結果の精度を高めることができます。この数を大きくすると、コンテキスト グラウンディングによってフィルター処理が行われ、プロンプトは最高スコアのものにのみグラウンディングされます。
     • 生成される結果の最大数: コンテキスト グラウンディングによってユーザーのクエリから返されるチャンクの数を指します。これは、LLM による生成に伴うグラウンディングのペイロード (LLM の呼び出しの全体的なトークン サイズ) を小さくするのに役立ちます。また、コンテキスト グラウンディングから得られる結果に対する追加のフィルターとしても機能させることができます。結果の数を増やすと、返されるチャンクの量が増えます。
     • クエリ – 検索ストラテジのクエリです。このフィールドでは、静的な値、引数、動的の各モードがサポートされています。
   • 構造化 (プレビュー): 表形式のデータ ソースを使用する場合、構造化クエリ用にこのオプションを選択します。CSV データ形式がサポートされています。
   • DeepRAG: このオプションを選択すると、高度な複数のドキュメントの合成と取得が可能になります。詳しくは、「DeepRAG を使用する」をご覧ください。
     • 引用を有効化 – DeepRAG クエリの引用を有効化します。
     • プロンプト – DeepRAG クエリのプロンプトです。このフィールドでは、静的な値、引数、動的の各モードがサポートされています。
5. 次の設定を使用して検索範囲を制限します。
   • フォルダー パスのプレフィックス – このフィールドを使用して、ターゲット ドキュメントが保存されるフォルダー パスを指定します。/documents/project などの静的パスを手動で入力するか、動的な引数を使用して、エージェントが実行時の入力に基づいてさまざまなフォルダーを検索できるようにします。
   注:

   既定では、指定したフォルダーに直接配置されているファイルのインデックスのみを作成できます。サブフォルダーに保存されているファイルは自動的には含まれません。サブフォルダーのファイルを含めるには、パスに /** を追加します (例: /documents/project/**)。サブフォルダー内のファイルが含まれていない場合、「DeepRAG に使用する有効なファイルがありません。インデックスを更新してもう一度同期するか、別の一致パターンを使用してください。」というエラーが表示されることがあります。

   • ファイル拡張子 – インデックスに含まれるファイルの種類を選択します。DeepRAG では、PDF ファイルのみがサポートされています。

Using Data Fabric entities in agents

Besides indexes, agents can use Data Fabric entities directly as context. This lets an agent query a system of record directly from enterprise systems, and reason over the current values without you having to create or maintain an index.

Native and Federated entity types are supported to be added as a context. A Native entity stores its records in UiPath, while a Federated entity holds no data of its own and reads live from an external system or from a Native entity each time it's queried. For a full comparison of what each type supports, refer to Entity types. For details on creating and configuring entities, refer to Creating an entity.

To add a Data Fabric entity set as a context for your agent, take the following steps in the Contexts section:

1. Select Add context, then select Data Fabric Entities.
   注:

   This view displays folder-level entities only.

2. Search for and select up to five entities from the list. Entities are grouped into In current solution and Available resources, and each shows a Native or Federated label. You can optionally use the View button to view an entity's details.
3. Select Add to add the selected entities to your agent.
   注:

   Federated entities that connect to an external system may have required parameters, depending on what that system's connector needs to read data. If the entity you added has any, its properties panel lists them. Enter the values for required parameters before the agent can query that entity.

The entities appear as context for your agent, each carrying its Native or Federated label and ready to be queried.