コンテキスト グラウンディング

Context Grounding in Autopilot for Everyone allows you to search existing Context Grounding indexes to answer user queries.

For example, you want to query the HR documents of your organization, such as time and expense policies, or employee handbooks, using Autopilot. Using Context Grounding, an admin would create the index and enable it in Autopilot, which allows Autopilot to search the index to answer HR-related queries.

To use Context Grounding, make sure you meet the following criteria:

• 関連する PDF、CSV、JSON、DOCX、XLSX、TXT のドキュメントを共有の Orchestrator ストレージ バケットにアップロードする
• Orchestrator のストレージ バケットからインデックスが作成済みである

Managing Context Grounding indexes

Index creation is done in Orchestrator, in the tenant-level Indexes page. For details, refer to Indexes.

Index enablement and management in Autopilot is done via the Context Grounding configuration section in Automation Cloud™ > Admin > AI Trust Layer > Autopilot for Everyone.

Once the index is created, enable it in Autopilot through the Context Grounding, panel.

Managing access for Context Grounding indexes

Access to Context Grounding indexes is managed at the folder level. Users can access indexes under the following conditions:

• インデックスがフォルダー内に存在する
• インデックスが存在するフォルダーと同じフォルダーにユーザーが割り当てられている
• The index is enabled in Autopilot

Adding Context Grounding indexes

To add a Context Grounding index, follow the steps described in Creating indexes, in the Orchestrator user guide.

Enabling Context Grounding indexes

To enable an index for Autopilot for Everyone:

1. Navigate to the Automation Cloud > Admin > AI Trust Layer > Autopilot for Everyone tab, then choose the tenant where Autopilot for Everyone is installed.

2. Expand the Context grounding settings section.

3. Select the Enable Index option. The Enable Index In Autopilot panel opens.

4. From the Orchestrator folder dropdown, select the Orchestrator folder where your index resides.

5. From the Index name dropdown menu, select the index you want to add to Autopilot. The list of available indexes in the selected tenant is displayed.

6. In the Description for Autopilot* field, write a comprehensive description that should help Autopilot understand when to search for the selected index.

   たとえば、インデックス値が「人事ドキュメント」の場合、「勤務時間/経費、父親の育児休暇、有給休暇に関する人事ポリシーのドキュメントと従業員ハンドブックです。会社の人事ポリシーに関する質問に使用し、従業員に正確かつ最新の情報を提供してください。」のような説明を入力できます。

7. For indexes with structured tabular data, select the Enable tabular query checkbox to allow retrieval of that information.

8. Select Enable to add the index. The panel closes and you are returned to the Context Grounding table.

重要:

変更は自動的に保存されます。

Editing Context Grounding indexes

To edit an index for Autopilot for Everyone:

1. Navigate to the Automation Cloud > Admin > AI Trust Layer > Autopilot for Everyone tab, then choose the tenant where Autopilot for Everyone is installed.
2. Expand the Context grounding settings section.
3. For the desired index, select Edit. The Updating index opens.
4. 必要に応じて、目的のプロパティを変更します。
5. Select Save to update the index. The panel closes and you are returned to the Context Grounding table.

重要:

変更は自動的に保存されます。

Deleting Context Grounding indexes

To remove an index from Autopilot for Everyone:

1. Navigate to the Automation Cloud > Admin > AI Trust Layer > Autopilot for Everyone tab, then choose the tenant where Autopilot for Everyone is installed.
2. Expand the Context grounding settings section.
3. For the desired index, select Delete. A confirmation message is displayed.
4. Select Delete to delete the prompt, or Cancel to dismiss the action.

重要:

変更は自動的に保存されます。

コンテキスト グラウンディングで表形式クエリを使用する

このページでは、コンテキスト グラウンディングのインデックスに対してこの機能を有効化する方法について説明するとともに、データの準備とクエリの記述に関するベスト プラクティスを紹介します。

表形式クエリ機能について

The tabular query feature helps Autopilot for Everyone understand and answer natural language questions using structured data, such as CSV files. With it, you can query data, run comparisons, and get insights from your indexed tables directly in chat.

表形式クエリを有効化する

To enable the feature, check the Enable tabular query box when setting up a Context Grounding index in Autopilot for Everyone.

有効化すると、Autopilot はインデックスが付いたファイル内の構造化データを使用して、自然言語の質問に回答できるようになります。

データの準備のベスト プラクティス

ソース データがどの程度クリーンで形式が整っているかによって結果が異なります。クエリの正確さを向上させるには、以下のヒントを参考にしてデータを準備および最適化します。

データ型が正しいことを確認する

Numerical operations, such as comparisons or calculations, need correct data types to work. Autopilot for Everyone needs to recognize numbers as numeric types (Real or Integer), not as text.

Autopilor が列に割り当てたデータ型を確認するには、次のプロンプトを使用します。

• 「<index_name> 内のデータ行を 5 つリストにし、すべてのフィールドとそのデータ型のリストを表示してください。」

数値列とパーセンテージ列がクリーンであることを確認する

インデックスを作成する前に、パーセント記号 % などの特殊文字をデータ列から削除します。Autopilot は 20% などの値をテキストとして扱うため、数値のクエリが正しく動作しません。

Make sure date columns use a consistent format, preferably MM/DD/YYYY. Use the data type check query to confirm that date columns are parsed as Date Time rather than plain text.

表形式クエリのベスト プラクティス

プロンプトが明確であれば結果が向上します。表形式データをクエリする際には、以下のヒントに留意してください。

複雑なスキーマを避ける

列を多数含むファイルに注意してください。データ スキーマが複雑になるほど、自然言語のクエリが誤って解釈される可能性が高くなります。

null 値に注意する

クエリ対象の列に null 値または空の値が含まれる行は、計算時に無視されます。たとえば、4 つの列の合計を計算する場合、列の 1 つに null が含まれる行は除外されます。これを回避するには、データを正規化し、null を適切な値に置き換えます。

文字列の一致の種類を指定する

既定では、クエリ エンジンは完全一致を使用して文字列を比較します。部分一致を検索するには、次のように部分一致をクエリに明示的に含める必要があります。

• For an exact match: "BCA Claims and Consulting Ltd"
• For a partial match: "BCA Claims and Consulting Ltd. or any of its subsidiaries". This query returns any result that contains the substring "BCA Claims and Consulting Ltd."

デバッグ ビューを使用する

高度なトラブルシューティングを行うには、Ctrl+Alt+Shift+D を使用してデバッグ ビューを開きます。このパネルには、クエリ エンジンが自然言語プロンプトをどのように解釈したかが表示されるため、予期しない結果を診断するのに役立ちます。