> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# コンテキストの概要

> コンテキストは、質問を正確なクエリに変換するために必要なビジネス知識をAI モデルに提供します。

> [!NOTE]
>
> Context は早期アクセス段階にあります。
> 早期アクセス機能は、[クラウドサービス利用契約](https://docs.cloud.cdata.com/ja/terms-of-service.md)の第 1.4 条に基づく本番前のソフトウェアであり、本番環境での使用は想定されていません。
> プログラムに参加するには、[早期アクセスをリクエスト](https://jp.cdata.com/ai/gateway-early-access/)してください。

AI モデルは、データソースをテーブル名とカラム名で把握しています。チームが `total_sales` カラムを「Revenue」と呼んでいることや、3 つある顧客テーブルのうち経理部門が信頼しているのがどれかは知りません。コンテキストは、そのギャップを埋めます。AI モデルにビジネス用語、データセット定義、カラムマッピングを提供し、質問を正確なクエリに変換できるようにします。

## コンテキストが重要な理由

コンテキストは、次の 3 点を改善します。

* **精度**：モデルが、ビジネス上の言葉を適切なカラムとデータセットにマッピングします。
* **速度**：応答がより速く返ってきます。
* **コスト**：必要なデータを見つけるために、モデルが使用するトークンが少なくなります。

## コンテキストの種類

Connect AI には、データを説明するグローバルコンテキストと、ユーザー自身を説明するユーザーコンテキストの 2 種類のコンテキストがあります。次の表で、両者を比較します。

| 項目 | グローバルコンテキスト | ユーザーコンテキスト |
| - | - | - |
| 説明する対象 | データ：各コネクション、データセット、Metric、ビジネス用語の意味 | ユーザー自身：役割、好みの回答の種類、タイムゾーン |
| 適用範囲 | アカウント全体、コネクション、またはデータセット。アカウントでワークスペースを使用している場合、ワークスペースごとに設定され、Workspace Context と呼ばれます。 | ユーザー自身の会話 |
| 管理する場所 | [Context Editor](https://docs.cloud.cdata.com/ja/Context-Editor.md) の**Global Context** | **Settings** の [User Context](https://docs.cloud.cdata.com/ja/Settings/User-Context.md)、またはContext Editor |
| 変更できるユーザー | Administrator、Workspace Administrator、Connection Administrator（[Roles](https://docs.cloud.cdata.com/ja/Roles-Policies/Roles.md) を参照）。Query ユーザーには表示されず、AI を介してのみ取得されます。 | ユーザー自身 |

Connect AI は、どちらか一方のコンテキストを優先することはありません。両方がまとめてモデルに渡され、モデルがその使い方を判断します。共有の定義やビジネスルールはグローバルコンテキストに、役割、通常適用するフィルタ、回答の希望などの個人的な情報はユーザーコンテキストに設定してください。

## グローバルコンテキストの内容

グローバルコンテキストは、次のエンティティタイプで構成されるグラフを形成します。

* **Global Context**：すべてのコネクションとデータセットに適用される用語とルールです。
* **Connection**：1 つのデータソースのコンテキストで、そのすべてのデータセットに適用されます。
* **Dataset**：1 つのテーブルまたはクエリのフィールドレベルの詳細です。
* **Metric**：1 つ以上のフィールドに対する再利用可能な測定値です。
* **Glossary**：ビジネス用語とルールで、必要に応じてカラムにリンクされます。例えば、Glossary エントリで*Revenue* を `total_sales` カラムにマッピングできます。

## モデルがコンテキストを取得する方法

コンテキストがモデルに届く方法は、モデルがConnect AI に接続する方法によって異なります。

| 接続方法 | コンテキストがモデルに届く方法 |
| - | - |
| MCP サーバーまたはツールサーバー | エージェントが `search_context` ツールを呼び出します。このツールは、関連するデータセットを、完全修飾名、フィールドの説明、結合のヒントとともに返します。エージェントは、最初の呼び出し時にユーザーコンテキストもリクエストします。 |
| LLM Gateway | プロジェクトの[ルーティングルール](https://docs.cloud.cdata.com/ja/LLM-Gateway/Routing-Rules.md)で、**Prompt Enrichment** の下のグローバルコンテキストとユーザーコンテキストをオンにした場合のみです。グローバルコンテキストはメッセージごとに検索されます。ユーザーコンテキストは、各会話の開始時に一度送信されます。オフの場合、Connect AI はコンテキストを追加せず、モデルには `search_context` を呼び出すためのヒントが最大で 1 つ渡されるだけです。 |

## コンテキストの入手元

グローバルコンテキストは、次の方法で追加できます。

* **インポート**：既存のセマンティックモデル（dbt セマンティックレイヤー、Snowflake セマンティックビュー、またはPower BI ファイル）をインポートします。
* **生成**：AI を使用してコンテキストを生成します。
* **作成**：テンプレートから始めて、組み込みのエディタでコンテキストを作成します。

コンテキストは、dbt マニフェスト、Power BI の定義、結合などのメタデータから作成されます。AI でコンテキストを生成する場合は、精度を上げるために、テーブルのサンプル値を含めることもできます。サンプル値はLLM に送信されます。**Settings > Security** で**Include Sample Values** をオフにすると、アカウント全体でサンプル値を無効にできます。HIPAA Business Associate Agreement が設定されているアカウントでは、サンプル値は使用できません。

グローバルコンテキストへの変更は、保存するとすぐに反映されます。承認の手順はありません。生成されたコンテキストを承認すると、誰かがコンテキストを再度生成またはインポートしても上書きされなくなります。

## パフォーマンス

`search_context` の呼び出しには、通常 1.5〜2 秒かかります。

## 早期アクセス

Context は、参加者数に限りがある早期アクセスプログラムで提供されています。申し込むには、[早期アクセスをリクエスト](https://jp.cdata.com/ai/gateway-early-access/)してください。CData から 2 営業日以内に返信があり、各リクエストを審査したうえで、お客様のアカウントでContext を有効にします。

## 次のステップ

> [card] [Context Editor](https://docs.cloud.cdata.com/ja/Context-Editor.md)
>
> グローバルコンテキストを追加、インポート、確認します。

> [card] [User Context](https://docs.cloud.cdata.com/ja/Settings/User-Context.md)
>
> モデルにユーザー自身について伝えます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.