Snowflake のAIエージェント用語集
このページでわかること
このページでは、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 を根拠として見せられる。
Cortex Search
文書や文章の列を検索するサービス。ベクトル検索とキーワード検索を組み合わせ、最後に並べ替える(ハイブリッド検索)。
画面への影響文書を根拠にした答えの出どころ。答えに引用が付くので、出典の表示を用意する。
分析検索Analytical search
大量の文書をまたいで集計する検索(パブリックプレビュー)。
画面への影響「問い合わせのうち返品の話は何件か」のような、文書を数える答えが返る。
コード実行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 を呼ぶにはコンテナのランタイムが必要(ウェアハウスのランタイムでは使えない)。
画面への影響社内向けの画面を素早く作る道の一つ。