Skip to main content
Context Editor は、自然言語のプロンプトを正確なデータクエリに変換するために必要なビジネス知識をAI モデルに提供します。既存のリソースからコンテキストをインポートする（外部コンテキストを追加する）か、組み込みのエディタを使用して手動でコンテキストを作成できます（新規コンテキストを追加する）。 Context Editor ページ（リスト表示）の左ペインには、User Context とGlobal Context があります。

​
User Context

User Context は、各会話の開始時に一度だけLLM に送信される、ユーザー自身に関する情報です。役割、好みの回答の種類、タイムゾーンなどの情報を追加できます。このページ、またはSettings のUser Context タブで情報を追加・編集できます。

​
Global Context

Global Context は、AI エージェントがデータについて知っている内容を管理します。

​
リスト表示

Global Context とリスト表示アイコンをクリックすると、アカウント内のすべてのエンティティと、それぞれに割り当てられた名前付きコンテキストの数の一覧が表示されます。Global Context の直下にある名前付きコンテキストは、すべてのコネクションとデータセットに適用され、複数持つことができます。検索バーを使用してエンティティを検索します。左ペインでエンティティを展開すると、割り当てられた名前付きコンテキストを確認できます。+ Add Context をクリックすると、新しいコンテキストまたは新しい外部コンテキストを追加できます。

​
グラフ表示

Global Context とグラフ表示アイコンをクリックすると、セマンティックレイヤー全体のすべてのコンテキストエンティティとその関連性を示すコンテキストグラフが表示されます。検索バーを使用してグラフ内のエンティティを検索します。
Context graph showing context editor entities and their relationships across the semantic layer
コンテキストグラフには、以下のエンティティタイプが含まれます：
  • Global Context：すべてのコネクションとデータセットに適用される、アカウントレベルのコンテキストです。データ環境全体に及ぶ用語やルールを定義するにはGlobal Context を使用します。
  • Connection：名前付きデータソース（例：MailChimp やPostgreSQL）です。コネクションレベルで定義されたコンテキストは、そのコネクション内のすべてのデータセットに適用されます。
  • Dataset：コネクション内のテーブルまたはクエリです。データセットレベルのコンテキストは、MCP サーバーがそのデータセットに対するクエリを解釈するためのフィールド固有の詳細を提供します。
  • Metric：1つ以上のフィールドで定義された再利用可能な測定値です。
  • Glossary：1つ以上のカラムに関連付けられたビジネス用語です。Glossary エントリにより、MCP サーバーがビジネス用語を認識できるようになります。例えば、Revenue を total_sales カラムにマッピングすることで、プロンプトが正確な結果を返すようになります。

​
コンテキスト詳細の表示

リスト表示またはグラフ表示でエンティティをクリックすると、そのエンティティの詳細を確認できます。
Context details panel for a selected entity

​
コンテキストの追加

コンテキストを追加する方法は2つあります：
  • オプションメニュー：エンティティの右側にあるオプションメニュー（⋮）をクリックすると、そのエンティティに直接コンテキストを追加できます。
  • Add Context ボタン：Add Context をクリックしてコンテキストを追加します。適用先のエンティティタイプ（特定のコネクション、またはすべてのコネクションとデータセットに適用されるグローバルコンテキスト）を選択する必要があります。
dbt またはPower BI のファイルからコンテキストをインポートしたり、AI を使用してコンテキストを生成したりできます。また、コンテキストテンプレートを編集して手動で新しいコンテキストを追加することもできます。

​
外部コンテキストの追加

Add External Context を使用すると、グローバルまたはコネクション単位でセマンティックコンテキストを追加できます。コネクションは親として表示され、その下に展開可能なデータセットの一覧が表示されます。
1
+ Add Context > Add External Context をクリックします。ダイアログが表示されます。
2
ダイアログのStep 1 で、コネクションの一覧からリソースを選択するか、Global Context を選択してすべてのコネクションとデータセットにコンテキストを適用します。検索バーを使用して検索を絞り込みます。
3
Next をクリックします。
4
ダイアログのStep 2 で、セマンティックコンテキストのSource（dbt またはPower BI）を選択します。代わりに、Connect AI にAI を使用してコンテキストを生成させることもできます。
  • dbt の場合、下の欄に manifest.json の内容を貼り付けます。
  • Power BI の場合、セマンティックコンテキストを含むPower BI（.pbix）ファイルを選択します。
    Snowflake コネクションのコンテキストには、追加のオプションとしてSnowflake Semantic View YAML ファイルがあります。
  • Generate Context の場合、精度を上げるためにInclude Sample Values をオンにしてから、Generate をクリックします。このダイアログを閉じても、Connect AI はバックグラウンドでコンテキストの生成を続けます。
    生成されたコンテキストは、グローバルコンテキストでは使用できず、コネクションコンテキストでのみ使用できます。
5
Add をクリックしてコンテキストを追加します。コンテキストがGlobal Context の一覧に表示されます。

​
新規コンテキストの追加

Global Context またはコネクションに新しいコンテキストドキュメントを手動で追加するには、以下の手順に従います：
1
+ Add Context > Add New Context をクリックします。ダイアログが表示されます。
2
ダイアログのStep 1 で、コネクションの一覧からリソースを選択するか、Global Context を選択してすべてのコネクションとデータセットにコンテキストを適用します。検索バーを使用して検索を絞り込みます。
3
Next をクリックします。
4
ダイアログのStep 2 で、新しいコンテキストの名前を入力します。
5
Add をクリックします。
6
コンテキストテンプレートを編集し、MCP サーバーがプロンプトを正確に解釈するのに役立つ用語、関係性、ビジネスルールを定義します。完成したテンプレートの例については、Jira Issues データセットの例 を参照してください。
7
Save をクリックします。

​
Jira Issues データセットの例

コンテキストテンプレートでは、以下のフィールドを使用します：
  • type：概念の種類。dataset（テーブルまたはビュー）、metric（測定値）、glossary（ビジネス用語またはルール）のいずれかです。
  • title：コンテキストグラフに表示される概念の名前です。
  • semanticType：自由入力による独自のサブ分類です（例：fact_table、dimension、kpi）。Connect AI はこれを使用して関連する概念をグループ化します。
  • synonyms：この概念について尋ねる際にユーザーが入力する可能性のある他の名前です。実際にユーザーが使用する単語を含めてください。
テンプレート本文では：
  • Heading とDescription：その概念が何をカバーし、いつ関連するかをMCP サーバーに伝えます。
  • Related：この概念が依存または説明する他の概念です。
  • Columns（データセットのみ）：意味を持つフィールドとその説明です。Glossary の用語やMetric の場合は、このセクションを削除します。
以下は、Jira Issues データセットの完成したコンテキストファイルの例です。

​
コンテキストの削除

コンテキストドキュメントを削除するには：
1
個々の概念の横にある削除アイコンをクリックします。コネクションのすべての概念を削除するには、コネクションの右側にあるオプションメニュー（⋮）をクリックし、Delete をクリックします。
2
ダイアログでDelete をクリックします。
最終更新日 2026年10月2日