コンテキスト

インデックスまたは一連の Data Fabric エンティティをエージェント コンテキストとして追加し、その検索ストラテジ、スコープ、またはエンティティの種類を設定して、エージェントが取得する内容を制御します。

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

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

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

インデックスをエージェントのコンテキストとして追加するには、[ コンテキスト] セクションで以下の手順を実行します。

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

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

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

エージェントで Data Fabric エンティティを使用する

エージェントは、インデックスに加えて Data Fabric エンティティをコンテキストとして直接使用できます。これにより、ユーザーがインデックスを作成または保守することなく、エージェントはエンタープライズ システムから直接記録システムに対してクエリを実行し、現在の値に基づいて推論を行うことができます。

ネイティブおよびフェデレーション エンティティ型をコンテキストとして追加できます。ネイティブ エンティティはレコードを UiPath に保存しますが、フェデレーション エンティティは独自のデータを保持せず、クエリが実行されるたびに外部システムまたはネイティブ エンティティからライブで読み取ります。各型がサポートする機能の完全な比較については、「 エンティティの型」をご覧ください。エンティティの作成と設定について詳しくは、「 エンティティを作成する」をご覧ください。

Data Fabric エンティティ セットをエージェントのコンテキストとして追加するには、[ コンテキスト] セクションで以下の手順を実行します。

1. [ コンテキストを追加] を選択し、[ Data Fabric エンティティ] を選択します。
   注:

   このビューには、フォルダー レベルのエンティティのみが表示されます。

2. リストから最大で 5 つのエンティティを検索して選択します。エンティティは [現在のソリューション内] と [利用可能なリソース] にグループ化され、それぞれにネイティブまたはフェデレーション ラベルが表示されます。必要に応じて、[ 表示 ] ボタンを使用してエンティティの詳細を表示できます。
3. [ 追加 ] を選択して、選択したエンティティをエージェントに追加します。
   注:

   外部システムに接続するフェデレーション エンティティには、そのシステムのコネクタがデータを読み取るために必要なものに応じて、必要なパラメーターがある場合があります。追加したエンティティにエンティティがある場合は、そのプロパティ パネルにそのエンティティが一覧表示されます。エージェントがそのエンティティに対してクエリを実行する前に、必要なパラメーターの値を入力します。

エンティティはエージェントのコンテキストとして表示され、それぞれにネイティブまたはフェデレーションのラベルが付いており、クエリの準備ができています。