Snowflake のAIエージェント用語集

2026-11-14 時点の Snowflake 公式ドキュメント をもとに整理 / 見直し目安:毎月。製品名や機能の状態は変わることがあります。

このページでわかること

このページでは、Snowflake Cortex Agents に出てくる用語 36 語を、ひと言の意味と画面への影響の2つで確認できます。流れの全体を先に見たいときは全体像から読んでください。

1. データの意味づけ

エージェントが「売上」「先月」を正しく読めるように、データに業務の言葉を付ける層です。

セマンティックビューSemantic view

業務の概念(顧客・売上・利益率など)を、データベースの中にスキーマのオブジェクトとして持たせたもの。物理的なテーブルに意味を重ねる。

画面への影響質問が通じるかどうかの大半はここで決まる。答えがずれるとき、最初に見直す場所。

論理テーブルLogical table

顧客・注文・仕入先のような業務の単位。たいてい物理テーブル1つに対応する。

画面への影響利用者が質問で使う「名詞」の一覧になる。質問の例を画面に出すなら、ここの言葉を使うと通りやすい。

リレーションシップRelationship

論理テーブル同士を共通のキーでつなぐ定義。

画面への影響「顧客ごとの注文数」のように、2つの表をまたぐ質問に答えられるかが決まる。

ファクトFact

行ごとの値(売上金額・数量など)。主にディメンションとメトリクスの材料になる。

画面への影響直接見えることは少ない。公開(PUBLIC)か非公開(PRIVATE)かを決められ、非公開は計算の材料だけに使う。

ディメンションDimension

商品カテゴリ・購入日のような、絞り込みと分類に使う属性。

画面への影響グラフの横軸や凡例、表の行見出しになる。絞り込みの候補を画面に出すなら、ここから取る。

メトリクスMetric

総売上・利益率のような、集計した指標。計算式を定義に持つ。

画面への影響グラフの縦軸や KPI の数字になる。定義が1か所にあるので、画面ごとに数字が食い違わない。

シノニム(別名)Synonyms

テーブルや列に付ける別の呼び方(「売上」「売り上げ」「revenue」など)。

画面への影響SQL の結果は変えない。利用者の言い回しの揺れを読み取る手がかりになる。

検証済みクエリVerified queries

よく聞かれる質問と、それに対する正しい SQL の組。

画面への影響よく使う質問ほど答えが安定する。画面の「質問の例」と同じ質問を登録しておくと、最初の体験が崩れにくい。

Semantic Studio/AutopilotSemantic View Autopilot

セマンティックビューを作る Snowsight の画面。Autopilot は AI が下書きを作るウィザードで、YAML・Tableau・Power BI のファイルも取り込める。

画面への影響作り手向けの画面。SQL を書かずに意味づけを始められる。

2. ツール

エージェントが答えを作るために呼ぶ道具です。何を持たせるかで、できることが決まります。

Cortex Analyst

セマンティックビューをもとに、自然言語の質問から SQL を作って実行するツール。

画面への影響表とグラフの答えの出どころ。実行した SQL を根拠として見せられる。

コード実行Code execution

Python をサンドボックスで動かすツール。

画面への影響既定では、コードを動かす前に利用者へ許可を求める(permission_policy: always_ask)。資料(PDF・PowerPoint など)の生成にもこのツールを使う。

Data to Chart

データからグラフを作るツール。

画面への影響グラフが Vega-Lite の仕様として届く。描くのは画面の側。

カスタムツールCustom tools

ストアドプロシージャや UDF を、エージェントが呼べるツールにしたもの。

画面への影響「申請を出す」のような、答える以上の操作をさせられる。実行前の確認を画面に置くかを決める。

MCP コネクタMCP connectors

MCP(Model Context Protocol)で、外部のツールをつなぐ仕組み。

画面への影響Snowflake の外のサービスの結果も、同じ会話の中に出てくる。

エージェントスキルAgent skills

特定の作業の手順や知識をまとめ、エージェントに持たせるもの。

画面への影響資料の体裁や答え方の型を決められる。Snowflake CoWork では、文書生成の既定の作り方をスキルで上書きできる。

3. エージェント

質問を受けて、どのツールをどの順に呼ぶかを決める本体です。

Cortex Agents

Snowflake の中で AI エージェントを作って動かす仕組み。エージェントはスキーマのオブジェクトとして作る。

画面への影響画面から見ると、質問を送る先。1つのエージェントに、ツール・指示文・モデルがまとまっている。

オーケストレーションOrchestration

計画(質問を読み、分け、ツールを選ぶ)→ ツール実行 → 振り返り(足りなければ繰り返す)の流れ。

画面への影響1つの質問の中で、ツールが何度も呼ばれる。途中経過を段階で見せると、待ち時間が伝わる。

指示文Instructions

答え方(response)、ツールの選び方(orchestration)などを文章で指示するもの。

画面への影響答えの長さ・口調・表を出すかどうかは、画面ではなくここで決まることが多い。

オーケストレーションのモデル

計画と振り返りに使う言語モデル。auto を選ぶと Snowflake が選ぶ。

画面への影響答えの質と速さが変わる。

予算Budget

1回の実行にかけてよい時間とトークンの上限。

画面への影響上限に達すると途中で終わる。長い処理には、終わり方の表示を用意する。

スレッドThread

会話の文脈をサーバー側で持つオブジェクト。thread_id と parent_message_id を送ると、続きの質問になる。

画面への影響画面の側で会話の履歴を持たなくてよい。会話の一覧や「続きから」を作りやすい。

CORTEX_USER/CORTEX_AGENT_USER

エージェントを使うのに必要なデータベースロール。

画面への影響権限が無い利用者には、エラーではなく「使えない理由」を出す。

4. 画面と通信

自作の画面で、エージェントの答えを受け取って描くための言葉です。

agent:run

エージェントを動かす REST API。エージェントのオブジェクトを指定する形と、指定せずに設定ごと送る形がある。

画面への影響自作の画面が呼ぶ入口。

ストリーミング(SSE)Server-Sent Events

答えを一度に返さず、細かいイベントとして順に送る方式。既定でこちらになる。

画面への影響文字が少しずつ出る、途中経過が出る、といった表示はこれで作る。

イベントの種類

response.status(状態)、response.thinking.delta(考え中の文字)、response.text.delta(答えの文字)、response.tool_use/response.tool_result(ツールの呼び出しと結果)、response.table(表)、response.chart(グラフ)、response.map(地図)、response.warning(警告)、error(エラー)、response(最後のまとめ)など。

画面への影響イベントごとに、どの部品で見せるかを決める。知らない種類が来ても壊れないように作る。

アノテーション(引用)Annotation

答えの文章に付く引用などの情報(response.text.annotation)。

画面への影響出典の番号や、元の文書へのリンクとして見せる。

tool_use_id

ツールの呼び出しと、その結果を結び付ける ID。

画面への影響「SQL を実行中」の表示を、結果が届いたら同じ場所で「完了」に変えられる。

run_id

1回の実行の ID。実行の中止(cancel)や、切れたストリームの受け直しに使う。

画面への影響「止める」ボタンや、通信が切れたときの再開を作れる。

Feedback API

答えへの評価を送る API。

画面への影響答えの下の「役に立った/立たなかった」から送る。

Cortex Agent SDK

TypeScript と Python でエージェントを呼ぶためのライブラリ(プレビュー)。

画面への影響ストリームの受け取りを任せ、画面づくりに集中できる。

5. 既製の画面と出力

自作しない場合の画面と、資料として持ち帰る出力です。

Snowflake CoWork

エージェントと会話するための Snowflake の画面。

画面への影響表・グラフ・地図をアーティファクトとして出し、共有もできる。自作する前に、まずこれで足りるかを確かめる。

文書生成

Snowflake CoWork で、答えを PDF・Word・PowerPoint・HTML の資料にする機能。コード実行ツールが必要。

画面への影響.pptx のテンプレートで社内の体裁に合わせられる。スキルで既定の作り方を上書きできる。

Vega-Lite

グラフを JSON で書く仕様。response.chart はこの形で届く。

画面への影響自作の画面では、Vega-Lite を描けるライブラリ(vega-embed など)で描く。配色やダークモードは画面の側で合わせる。

Streamlit in Snowflake

Python で画面を作る仕組み。Cortex Agents の API を呼ぶにはコンテナのランタイムが必要(ウェアハウスのランタイムでは使えない)。

画面への影響社内向けの画面を素早く作る道の一つ。

出典(公式ドキュメント)