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 を作れなかったときは、代わりに候補が届く
「売上」は次のどれですか?
Cortex Search ― 引用
文書を根拠にした答えには、引用が付きます。出典を見せられるかが、文書の答えを信じてもらえるかを左右します。
届くイベント
response.text.annotation答えの文章に付く引用。型は cortex_search_citation で、文書の ID(doc_id)・題(doc_title)・置き場所(stage_path・relative_path)を持つ
見せ方のポイント
- 本文の該当箇所に番号を付け、答えの下に出典の一覧を置く
- 置き場所(stage_path など)から元の文書を開けるようにすると、確かめられる
- 公式ドキュメントは、引用の正しさを保証していない。出典は「確かめるための手がかり」として見せる
渋谷店の売上が落ちたのはなぜ?
- 店舗日報を検索
改装工事で正面入口が閉鎖されていたためです[1]。
[1] 渋谷店 週次日報(10/14〜10/20)
グラフと地図
グラフは Data to Chart ツールが作ります。地図は、地理のデータを結果として描くときに届きます。
届くイベント
response.chartグラフの仕様(Vega-Lite)が文字列で届く
response.map地図の仕様(deck.gl の MapSpec)が届く。Vega-Lite ではない
見せ方のポイント
- 自作の画面では、グラフは vega-embed など、地図は deck.gl で描く。配色やダークモードは画面の側で合わせる
- グラフの表題に「何が起きたか」を書かせたいときは、指示文で頼む
店舗別の売上をグラフで
- データを集計
- グラフを作成
コード実行 ― 実行前の許可の確認
Python で計算・加工・図・ファイルを作るツールです。資料の生成もこのツールを使います。既定では、コードを動かす前に利用者の許可を求めます。
届くイベント
response.tool_usepermission に選択肢(例:Allow Once・Deny)が入っていたら、画面は実行前に利用者に許可を求める
見せ方のポイント
- permission_policy の既定は always_ask(毎回確認)。always_allow にすると確認なしで動く(公式ドキュメントは注意を促している)
- サンドボックスは、エージェントがその会話ですでに実行した SQL の結果(RESULT_SCAN)だけを読める。テーブルを直接は読めない
- 作ったファイルは利用者のワークスペースのステージに残る
前年比を計算して PowerPoint に
- データを集計
Python を実行して計算します。よろしいですか?
カスタムツール ― 自社の処理と確認
ストアドプロシージャや UDF を道具にして、「申請を出す」のような答える以上の操作をさせられます。
届くイベント
response.tool_usepermission の選択肢があれば、実行前に許可を求める。client_side_execute が true なら、ツールはサーバーではなく画面の側で動かす
見せ方のポイント
- 取り消せない操作をさせるなら、実行前に内容と確認のボタンを出す
- 確認の画面は、何が起きるか(宛先・金額など)を具体的に見せる
渋谷店に販促費の申請を出して
- 申請の内容を作成
次の内容で申請します。
| 項目 | 内容 |
|---|---|
| 店舗 | 渋谷店 |
| 金額 | 30万円 |
3. ツールの持たせ方
エージェントの仕様の tools に道具を並べ、tool_resources に中身(セマンティックビュー・検索サービスなど)を結び付けます。 下は、type 名が確認日時点の公式ドキュメントで確かめられたものだけの例です。
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 では、許可の確認はどう出ますか?
コード実行ツールの既定は、実行前に確認する設定(always_ask)です。ただ、CoWork の画面でその確認がどう見えるかは、確認日時点の公式ドキュメントに書かれていません。実物で確かめてください。
Data to Chart の設定の書き方は?
Data to Chart は、ツールの一覧には載っていますが、確認日時点の公式ドキュメントでは tool_spec の type 名を見つけられませんでした。Snowsight のエージェントの設定から加えてください。
次に読む
- AIエージェント画面の動くデモ:表・グラフ・引用が届く順番を再生で見る
- Snowflake CoWork で変えられること:ツールの選び方の指示と、資料を出すためのコード実行