Snowflake のエージェントのツール

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

このページでわかること

このページでは、Cortex Agents に持たせられるツール10種を、画面に何が出るかで確認できます。 表・引用・グラフ・許可の確認のように、画面の部品に直結するツールは、届くイベントと見せ方まで説明しています。

1. ツールの一覧

「画面との近さ」は、このページでの分け方です。直結は専用の部品(表・引用など)が出るもの、途中経過は「〜を実行中」と答えの文章で見えるもの、見えないは答えの形にだけ効くものです。

ツール何をするか画面に出るもの画面との近さ
Cortex Analystセマンティックビューをもとに、質問から SQL を作って実行する表・実行した SQL・言い直しの候補直結
Cortex Search文書や文章の列を検索する答えに付く引用(出典)直結
Data to Chartほかのツールが返したデータからグラフを作るグラフ直結
コード実行Python をサンドボックスで動かし、計算・加工・図・ファイルを作る実行前の許可の確認・計算結果・ファイル直結
カスタムツールストアドプロシージャや UDF で、自社の処理を呼ぶ実行前の許可の確認(設定による)・処理の結果直結
分析検索大量の文書をまたいで、件数や傾向を集計する(パブリックプレビュー)途中経過と、集計の答え途中経過
Web 検索公開されている Web から、いまの情報を取ってくる(アカウント単位で有効化)途中経過と、答えの文章途中経過
MCP コネクタJira・Salesforce・自社のアプリなど、外の MCP サーバーの道具を呼ぶ途中経過と、答えの文章途中経過
エージェントスキル決まった作業の手順と知識をまとめて持たせる答えや資料の形がそろう見えない
ツールセットほかのエージェントのツールを、実行時に引き継ぐ引き継いだツールと同じ見えない

2. 画面に直結するツール

それぞれ、届くイベント・画面の模式図・見せ方のポイントの順です。模式図はこのサイトの見た目で描いた説明用の図で、CoWork の実際の画面ではありません。

Cortex Analyst ― 表・SQL・言い直しの候補

表で答える質問のほとんどは、このツールを通ります。答えの数字が正しいかは、セマンティックビューの出来で決まります。

届くイベント

  • response.tool_result.analyst.delta

    作った SQL(sql)、その説明(sql_explanation)、結果(result_set)、検証済みクエリを使ったか(verified_query_used)、言い直しの候補(suggestions)が少しずつ届く

  • response.table

    表として描く SQL の結果と表題

見せ方のポイント

  • 表は文章に埋めず、カードとして描く(並べ替え・コピー・ダウンロードを付けやすい)
  • SQL と説明は折りたたみで根拠として置く。検証済みクエリを使った答えには、その印を出すと信頼の手がかりになる
  • 質問があいまいで SQL を作れないときは suggestions に言い直しの候補が入る。押せるボタンにすると、会話が止まらない

先月の売上は?

  • データを集計
店舗売上(万円)
横浜店1,840
新宿店1,690

▸ 実行した SQL / 検証済みの質問で答えました

質問があいまいで SQL を作れなかったときは、代わりに候補が届く

「売上」は次のどれですか?

税抜の売上返品を除いた売上

グラフと地図

グラフは Data to Chart ツールが作ります。地図は、地理のデータを結果として描くときに届きます。

届くイベント

  • response.chart

    グラフの仕様(Vega-Lite)が文字列で届く

  • response.map

    地図の仕様(deck.gl の MapSpec)が届く。Vega-Lite ではない

見せ方のポイント

  • 自作の画面では、グラフは vega-embed など、地図は deck.gl で描く。配色やダークモードは画面の側で合わせる
  • グラフの表題に「何が起きたか」を書かせたいときは、指示文で頼む

店舗別の売上をグラフで

  • データを集計
  • グラフを作成

コード実行 ― 実行前の許可の確認

Python で計算・加工・図・ファイルを作るツールです。資料の生成もこのツールを使います。既定では、コードを動かす前に利用者の許可を求めます。

届くイベント

  • response.tool_use

    permission に選択肢(例:Allow Once・Deny)が入っていたら、画面は実行前に利用者に許可を求める

見せ方のポイント

  • permission_policy の既定は always_ask(毎回確認)。always_allow にすると確認なしで動く(公式ドキュメントは注意を促している)
  • サンドボックスは、エージェントがその会話ですでに実行した SQL の結果(RESULT_SCAN)だけを読める。テーブルを直接は読めない
  • 作ったファイルは利用者のワークスペースのステージに残る

前年比を計算して PowerPoint に

  • データを集計

Python を実行して計算します。よろしいですか?

今回だけ許可許可しない

カスタムツール ― 自社の処理と確認

ストアドプロシージャや UDF を道具にして、「申請を出す」のような答える以上の操作をさせられます。

届くイベント

  • response.tool_use

    permission の選択肢があれば、実行前に許可を求める。client_side_execute が true なら、ツールはサーバーではなく画面の側で動かす

見せ方のポイント

  • 取り消せない操作をさせるなら、実行前に内容と確認のボタンを出す
  • 確認の画面は、何が起きるか(宛先・金額など)を具体的に見せる

渋谷店に販促費の申請を出して

  • 申請の内容を作成

次の内容で申請します。

項目内容
店舗渋谷店
金額30万円
申請するやめる

3. ツールの持たせ方

エージェントの仕様の tools に道具を並べ、tool_resources に中身(セマンティックビュー・検索サービスなど)を結び付けます。 下は、type 名が確認日時点の公式ドキュメントで確かめられたものだけの例です。

yaml
tools:
  - tool_spec:
      type: "cortex_analyst_text_to_sql"
      name: "sales_analyst"
      description: "店舗の売上・客数などの数字を集計する"
  - tool_spec:
      type: "cortex_search"
      name: "store_reports"
      description: "店舗日報を検索する。売上が変わった理由を調べるときに使う"
  - tool_spec:
      type: "code_execution"
      name: "code_execution"
tool_resources:
  sales_analyst:
    semantic_view: "DB.SCH.SALES_SEMANTIC_VIEW"
  store_reports:
    search_service: "DB.SCH.STORE_REPORTS_SEARCH"
  code_execution:
    permission_policy: "always_ask"
ツールの説明(description)は利用者には見えませんが、エージェントがどのツールを使うかを決める手がかりです。書き方はCoWork で変えられることの「ツールの選び方」にあります。

よくある質問

ツールは、いくつ持たせればよいですか?

質問に必要な分だけにします。ツールが多いほど、エージェントがどれを使うか迷う場面が増えます。持たせたツールには、説明(description)に「いつ使うか」を書きます。

CoWork では、許可の確認はどう出ますか?

コード実行ツールの既定は、実行前に確認する設定(always_ask)です。ただ、CoWork の画面でその確認がどう見えるかは、確認日時点の公式ドキュメントに書かれていません。実物で確かめてください。

Data to Chart の設定の書き方は?

Data to Chart は、ツールの一覧には載っていますが、確認日時点の公式ドキュメントでは tool_spec の type 名を見つけられませんでした。Snowsight のエージェントの設定から加えてください。

次に読む

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