Snowflake のAIエージェントの全体像
このページでわかること
このページでは、Snowflake の Cortex Agents が、データから画面・資料の出力までどうつながっているかを、利用者に見えるものと作り手が決めることに分けて確認できます。 公式ドキュメントの機能一覧ではなく、エージェントの画面を作る人の目線で並べ直しています。
1. ひと言でいうと
Snowflake の中にあるデータに、利用者が自然言語で質問します。エージェントは質問を読んで計画を立て、SQL の実行や文書の検索といったツールを呼び、結果を見て足りなければもう一度ツールを呼び、最後に文章・表・グラフで答えます。答えはそのまま PowerPoint や HTML の資料にもできます。
作り手の仕事は大きく3つです。データに意味を付ける(セマンティックビュー)、エージェントに道具と指示を渡す、届いた答えを画面と資料にする。このサイトが扱うのは3つ目ですが、画面の出来は1つ目と2つ目に強く左右されます。
2. 全体の流れ
上から下へ、データが答えになっていく順に並べました。右の2列が、それぞれの段で利用者に見えるものと、作り手が決めることです。
- 段 1データ
中身
テーブル・ビュー・文書
利用者に見えるもの
見えない(答えの元になる)
作り手が決めること
どのテーブルと文書をエージェントに渡すか
- 段 2意味づけ
中身
セマンティックビュー/Cortex Search サービス
利用者に見えるもの
質問がそのまま通じるかどうか(「売上」が何を指すか)
作り手が決めること
列に業務の言葉を付ける。指標の計算式、テーブルのつなぎ方、検索させる列
- 段 3ツール
中身
Cortex Analyst・Cortex Search・コード実行・Data to Chart・自作ツール など
利用者に見えるもの
「SQL を実行中」「文書を検索中」といった途中経過
作り手が決めること
どのツールを持たせるか。ツールごとの説明文(いつ使うか)
- 段 4エージェント
中身
Cortex Agents(計画 → ツール実行 → 振り返り)
利用者に見えるもの
考えている様子、聞き返し、最終の答え
作り手が決めること
指示文(答え方・ツールの選び方)、使うモデル、時間とトークンの予算
- 段 5画面
中身
Snowflake CoWork・Microsoft Teams・自作アプリ(REST API/SDK)
利用者に見えるもの
チャットの画面そのもの
作り手が決めること
既製の画面を使うか、自作するか。自作なら、届くイベントをどう並べるか
- 段 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
権限をそろえる
使う人のロールに SNOWFLAKE.CORTEX_USER か SNOWFLAKE.CORTEX_AGENT_USER のデータベースロールを付け、エージェントとツールが使うオブジェクトへの権限を渡す。
- 2
データに意味を付ける
セマンティックビューを作る。Snowsight のウィザード(Autopilot)や Semantic Studio、または SQL の CREATE SEMANTIC VIEW。文書を使うなら Cortex Search のサービスも作る。
- 3
エージェントを作る
Snowsight か SQL か REST API で作る。ツール、指示文、モデル(auto も選べる)、予算を決める。
- 4
プレイグラウンドで試す
Snowsight で質問を投げ、ツールの選び方と答え方を確かめる。うまくいかない質問は、指示文かセマンティックビューを直す。
- 5
画面につなぐ
既製の画面(Snowflake CoWork・Teams)に出すか、自作アプリから agent:run を呼ぶ。自作するなら、ストリームのイベントを部品に割り当てる。
- 6
出力と改善
資料の形(PDF・PowerPoint など)を決め、フィードバックを集めて指示文とセマンティックビューを直す。
よくある質問
セマンティックビューは必須ですか?
表のデータに自然言語で質問させるなら、ほぼ必須です。列の意味や指標の計算式を持たせることで、エージェントが正しい SQL を作れるようになります。文書だけを扱うなら Cortex Search のサービスがあれば足ります。
画面は自作しないといけませんか?
いいえ。Snowflake CoWork や Microsoft Teams から既製の画面で使えます。自社のアプリに組み込みたいときや、表示を細かく決めたいときに、REST API で自作します。
Streamlit で画面を作れますか?
Streamlit in Snowflake から Cortex Agents の API を呼ぶ場合、ウェアハウスのランタイムでは使えず、コンテナのランタイムが必要です。
次に読む
- Snowflake のAIエージェント用語集:セマンティックビュー・オーケストレーション・ストリームのイベントなどを、画面への影響つきで
- Snowflake のエージェントのツール:10種のツールを、画面に何が出るかで
- AIエージェント画面の動くデモ:「画面を作るときに決めること」を、届くイベントの再生で確かめる
- AIエージェントの答えを資料にする:HTML・PowerPoint への出力を、テンプレート・スキル・指示文で決める
- Snowflake CoWork で変えられること:既製の画面を使うとき、設定で答えをどう変えるか