Snowflake のAIエージェントの全体像

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

このページでわかること

このページでは、Snowflake の Cortex Agents が、データから画面・資料の出力までどうつながっているかを、利用者に見えるものと作り手が決めることに分けて確認できます。 公式ドキュメントの機能一覧ではなく、エージェントの画面を作る人の目線で並べ直しています。

1. ひと言でいうと

Snowflake の中にあるデータに、利用者が自然言語で質問します。エージェントは質問を読んで計画を立て、SQL の実行や文書の検索といったツールを呼び、結果を見て足りなければもう一度ツールを呼び、最後に文章・表・グラフで答えます。答えはそのまま PowerPoint や HTML の資料にもできます。

作り手の仕事は大きく3つです。データに意味を付ける(セマンティックビュー)、エージェントに道具と指示を渡す、届いた答えを画面と資料にする。このサイトが扱うのは3つ目ですが、画面の出来は1つ目と2つ目に強く左右されます。

2. 全体の流れ

上から下へ、データが答えになっていく順に並べました。右の2列が、それぞれの段で利用者に見えるものと、作り手が決めることです。

  1. 段 1データ

    中身

    テーブル・ビュー・文書

    利用者に見えるもの

    見えない(答えの元になる)

    作り手が決めること

    どのテーブルと文書をエージェントに渡すか

  2. 段 2意味づけ

    中身

    セマンティックビュー/Cortex Search サービス

    利用者に見えるもの

    質問がそのまま通じるかどうか(「売上」が何を指すか)

    作り手が決めること

    列に業務の言葉を付ける。指標の計算式、テーブルのつなぎ方、検索させる列

  3. 段 3ツール

    中身

    Cortex Analyst・Cortex Search・コード実行・Data to Chart・自作ツール など

    利用者に見えるもの

    「SQL を実行中」「文書を検索中」といった途中経過

    作り手が決めること

    どのツールを持たせるか。ツールごとの説明文(いつ使うか)

  4. 段 4エージェント

    中身

    Cortex Agents(計画 → ツール実行 → 振り返り)

    利用者に見えるもの

    考えている様子、聞き返し、最終の答え

    作り手が決めること

    指示文(答え方・ツールの選び方)、使うモデル、時間とトークンの予算

  5. 段 5画面

    中身

    Snowflake CoWork・Microsoft Teams・自作アプリ(REST API/SDK)

    利用者に見えるもの

    チャットの画面そのもの

    作り手が決めること

    既製の画面を使うか、自作するか。自作なら、届くイベントをどう並べるか

  6. 段 6出力

    中身

    文章・表・グラフ・地図/PDF・Word・PowerPoint・HTML

    利用者に見えるもの

    答えの形。持ち帰れる資料

    作り手が決めること

    どの形で返すか。資料のテンプレートと体裁

画面の不満は、上の段に原因があることが多い

「答えが的外れ」「毎回グラフの種類が違う」といった画面上の不満は、表示の部品ではなく、セマンティックビューの言葉の付け方や、エージェントの指示文で直ることがよくあります。画面を作る人も、上の段を読める必要があるのはこのためです。

3. 今の時点でできること

利用者の目線の「やりたいこと」から引けるように並べました。状態は確認日時点の公式ドキュメントの表記です。

やりたいことどうやる状態
自然言語で、表のデータに質問するセマンティックビュー+Cortex Analyst。エージェントが SQL を作って実行する利用可
社内文書を探して、根拠つきで答えるCortex Search のサービスを作り、ツールとして渡す。答えには引用(annotation)が付く利用可
表とグラフで答える結果は表(SQL の結果)とグラフ(Vega-Lite の仕様)として届く。Data to Chart ツールでグラフにする利用可
Python で計算・加工するコード実行ツール(サンドボックス)利用可
自社の処理を呼ばせるストアドプロシージャ・UDF をカスタムツールにする。MCP コネクタで外部のツールもつなげる利用可
会話を続けるスレッドを作り、ID を渡す。文脈はサーバー側が持つ利用可
PDF・Word・PowerPoint・HTML の資料を作るSnowflake CoWork の文書生成。コード実行ツールが必要。.pptx のテンプレートやスキルで体裁を決められる利用可
自作の画面に組み込むREST API(agent:run)のストリームを受けて描く。TypeScript・Python の SDK もあるAPI は利用可/SDK はプレビュー
大量の文書をまたいで集計する分析検索(Analytical search)パブリックプレビュー

4. 画面をどう用意するか ― 3つの道

既製の画面を使う

Snowflake CoWork、Microsoft Teams、Cortex Code

良い点:すぐ使える。表・グラフ・資料の生成も備わっている

引き受けること:見た目と操作の流れは決められない

REST API で自作する

agent:run を呼び、Server-Sent Events のストリームを受けて描く

良い点:自社のアプリに組み込め、表示を細かく決められる

引き受けること:イベントの並べ方・再接続・エラー表示を全部作る

SDK で自作する

TypeScript・Python の Cortex Agent SDK(プレビュー)

良い点:ストリームの受け取りを任せられ、画面づくりに集中できる

引き受けること:プレビューなので、仕様が変わる前提で使う

5. 画面を作るときに決めること(UI/UX)

自作の画面には、答えが一度に届くのではなく、細かいイベントが順に届きます。どのイベントをどの部品で、どの順に見せるかが、使い心地を決めます。

1. 待ち時間を、段階で見せる

エージェントは計画・ツール実行・振り返りを何度か回すので、答えまで数十秒かかることがあります。ストリームには状態(response.status)や考えている途中(response.thinking.delta)が届くので、「質問を理解中 → データを検索中 → SQL を実行中」のように段階で見せられます。くるくる回るだけの表示より、待てる時間が延びます。

2. 根拠を、答えの近くに置く

データの答えなら、実行した SQL と結果の表(response.tool_result・response.table)。文書の答えなら、引用(response.text.annotation)。数字だけ出すと、利用者は信じてよいか判断できません。根拠は折りたたんでおき、開けば見られる形が扱いやすいです。

3. 表とグラフは、文章とは別の部品で描く

表は SQL の結果セット、グラフは Vega-Lite の仕様として、文章とは別のイベントで届きます。文章の中に埋めず、カードとして並べると、コピー・ダウンロード・拡大の操作を付けやすくなります。

4. 聞き返しと失敗を、行き止まりにしない

質問があいまいだと、エージェントは聞き返します。続けて答えられる入力欄と、言い直しの候補を出すと、会話が止まりません。致命的でない警告(response.warning)は答えと一緒に小さく、致命的なエラー(error)は再試行の手段と一緒に出します。

5. 止められる・戻れる

実行は中止(cancel)でき、途中で切れたストリームは run_id で受け直せます。長い処理には「止める」ボタンを置き、通信が切れても答えを失わないようにします。

6. 感想を集める

Feedback API で、答えへの評価を送れます。答えの下に「役に立った/立たなかった」を置き、指示文やセマンティックビューを直す材料にします。

6. 作り手の手順

  1. 1

    権限をそろえる

    使う人のロールに SNOWFLAKE.CORTEX_USER か SNOWFLAKE.CORTEX_AGENT_USER のデータベースロールを付け、エージェントとツールが使うオブジェクトへの権限を渡す。

  2. 2

    データに意味を付ける

    セマンティックビューを作る。Snowsight のウィザード(Autopilot)や Semantic Studio、または SQL の CREATE SEMANTIC VIEW。文書を使うなら Cortex Search のサービスも作る。

  3. 3

    エージェントを作る

    Snowsight か SQL か REST API で作る。ツール、指示文、モデル(auto も選べる)、予算を決める。

  4. 4

    プレイグラウンドで試す

    Snowsight で質問を投げ、ツールの選び方と答え方を確かめる。うまくいかない質問は、指示文かセマンティックビューを直す。

  5. 5

    画面につなぐ

    既製の画面(Snowflake CoWork・Teams)に出すか、自作アプリから agent:run を呼ぶ。自作するなら、ストリームのイベントを部品に割り当てる。

  6. 6

    出力と改善

    資料の形(PDF・PowerPoint など)を決め、フィードバックを集めて指示文とセマンティックビューを直す。

よくある質問

セマンティックビューは必須ですか?

表のデータに自然言語で質問させるなら、ほぼ必須です。列の意味や指標の計算式を持たせることで、エージェントが正しい SQL を作れるようになります。文書だけを扱うなら Cortex Search のサービスがあれば足ります。

画面は自作しないといけませんか?

いいえ。Snowflake CoWork や Microsoft Teams から既製の画面で使えます。自社のアプリに組み込みたいときや、表示を細かく決めたいときに、REST API で自作します。

Streamlit で画面を作れますか?

Streamlit in Snowflake から Cortex Agents の API を呼ぶ場合、ウェアハウスのランタイムでは使えず、コンテナのランタイムが必要です。

次に読む

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

このページに関するニュース