Snowflake CoWork で変えられること
このページでわかること
このページでは、Snowflake CoWork を使う前提で、設定を変えると答えに何が出るかを、変える前と後の画面と、変え方のコードで確認できます。 CoWork の画面の作り(配置や部品)は変えられませんが、答えの中身はエージェントとセマンティックビューの設定でかなり変わります。
変えられるものの一覧
| 変えたいこと | どこを変えるか |
|---|---|
| 1. 答えの書き方 | エージェントの指示文(instructions.response) |
| 2. ツールの選び方 | エージェントの指示文(instructions.orchestration)とツールの説明(tool_spec.description) |
| 3. 言葉の通じ方 | セマンティックビュー(メトリクス・WITH SYNONYMS・COMMENT・AI_SQL_GENERATION) |
| 4. よく聞かれる質問の答えをそろえる | セマンティックビューの検証済みクエリ(AI_VERIFIED_QUERIES) |
| 5. 資料を出せるか | エージェントのツール(コード実行) |
| 6. 資料の体裁 | スキル(利用者のスキル・エージェントのスキル)と .pptx テンプレート |
| 7. 表示名・質問の例 | エージェントの PROFILE と instructions.sample_questions(見え方は要確認) |
1. 答えの書き方
答えの長さ・順番・口調・表を添えるかは、画面ではなく指示文で決まります。
変えるところ:エージェントの指示文(instructions.response)
先月の売上がいちばん少なかった店は?
ご質問ありがとうございます。売上データを確認しました。先月(2026年10月)の店舗別の売上を集計したところ、店舗によって差が見られました。いくつかの要因が考えられますが、まず数字を見ると、横浜店が 1,840 万円、新宿店が 1,690 万円……
(結論が最後まで出てこない)
先月の売上がいちばん少なかった店は?
渋谷店(960 万円)です。
5店舗の中で最も少なく、最も多い横浜店の約半分でした。
| 店舗 | 売上(万円) |
|---|---|
| 横浜店 | 1,840 |
| 新宿店 | 1,690 |
| 渋谷店 | 960 |
変え方
Snowsight のエージェントの設定画面か、エージェントの仕様(CREATE AGENT の YAML)の instructions.response に書きます。
instructions:
response: |
最初の1文で結論を答える。
数字の答えには、根拠の表を5行まで添える。
金額は万円にそろえ、桁区切りを付ける。
前置き(「ご質問ありがとうございます」など)は書かない。「結論から」「表を添える」「単位をそろえる」のように、画面で見たい形をそのまま文で書きます。
2. ツールの選び方
数字の質問に文書検索を使う、理由の質問に数字だけで答える、といったずれは、ツールの選び方の指示で直します。
変えるところ:エージェントの指示文(instructions.orchestration)とツールの説明(tool_spec.description)
渋谷店の売上が落ちたのはなぜ?
- データを集計
渋谷店の 10月の売上は 960 万円で、9月の 1,520 万円から 37% 減りました。
渋谷店の売上が落ちたのはなぜ?
- データを集計
- 店舗日報を検索
10月14日〜20日に、改装工事で正面入口が閉鎖されていたためです[1]。この週の来店数は前週の約6割でした。
[1] 渋谷店 週次日報(10/14〜10/20)
変え方
「なぜ」に答えるには文書を探す、と指示文に書き、ツールの説明にも「いつ使うか」を書きます。エージェントは説明を読んでツールを選びます。
instructions:
orchestration: |
数字を聞かれたら sales_analyst を使う。
理由・経緯を聞かれたら、数字を確かめたうえで store_reports も使う。
tools:
- tool_spec:
type: "cortex_analyst_text_to_sql"
name: "sales_analyst"
description: "店舗の売上・客数などの数字を集計する"
- tool_spec:
type: "cortex_search"
name: "store_reports"
description: "店舗日報を検索する。売上が変わった理由や出来事を調べるときに使う"ツールの説明は、利用者には見えませんが、エージェントの判断を左右します。「何をするか」より「いつ使うか」を書きます。
3. 言葉の通じ方
社内の言い回し(粗利・既存店など)が通じないと、エージェントは聞き返すか、違う数字で答えます。言葉の定義はセマンティックビューに持たせます。
変えるところ:セマンティックビュー(メトリクス・WITH SYNONYMS・COMMENT・AI_SQL_GENERATION)
先月の既存店の粗利は?
- データを集計
「既存店」と「粗利」に当たる項目が見つかりませんでした。次のどれを知りたいですか?
- 全店舗の売上
- 全店舗の利益
先月の既存店の粗利は?
- データを集計
既存店(開店から13か月以上の4店舗)の粗利は 2,310 万円です。
粗利=売上−売上原価
変え方
セマンティックビューで、粗利をメトリクスとして計算式ごと定義し、別名(WITH SYNONYMS)と説明(COMMENT)を付けます。「既存店」のような社内の決まりは、SQL を作るときの指示(AI_SQL_GENERATION)に書きます。
CREATE OR REPLACE SEMANTIC VIEW sales_semantic_view
TABLES (
sales AS db.sch.SALES PRIMARY KEY (sale_id),
stores AS db.sch.STORES PRIMARY KEY (store_id)
)
...
METRICS (
sales.gross_profit AS SUM(sales.net_sales - sales.cost)
WITH SYNONYMS = ('粗利', '売上総利益')
COMMENT = '粗利=売上−売上原価'
)
AI_SQL_GENERATION '「既存店」は、開店日から13か月以上たった店舗のこと(stores.opened_on で判定する)';別名は SQL の結果を変えません。質問の言い回しを読み取る手がかりです。計算の中身はメトリクスの式に、社内の決まりは AI_SQL_GENERATION に書きます。
4. よく聞かれる質問の答えをそろえる
同じ質問でも、聞くたびに集計のしかたが変わると、数字が食い違います。よく聞かれる質問には、正しい SQL を登録しておきます。
変えるところ:セマンティックビューの検証済みクエリ(AI_VERIFIED_QUERIES)
今月の売上は?
1回目:7,120 万円(税込・返品を含む)
2回目:6,480 万円(税抜・返品を除く)
(聞くたびに集計のしかたが変わる)
今月の売上は?
何回聞いても:6,480 万円(税抜・返品を除く)
登録した SQL で集計した値
変え方
セマンティックビューの AI_VERIFIED_QUERIES に、質問と、その答えを出す正しい SQL の組を登録します。
AI_VERIFIED_QUERIES (
monthly_sales AS (
QUESTION '今月の売上は?'
SQL 'SELECT SUM(net_sales) FROM db.sch.SALES
WHERE DATE_TRUNC(month, sold_on) = DATE_TRUNC(month, CURRENT_DATE())
AND is_returned = FALSE'
)
)利用者が最初に試す質問(質問の例に載せるもの)から登録すると、最初の体験が崩れません。
5. 資料を出せるか
PDF・Word・PowerPoint・HTML の資料は、コード実行ツールの中で作られます。このツールが無いと、資料は作れません。
変えるところ:エージェントのツール(コード実行)
この内容を PowerPoint にして
申し訳ありません。ファイルを作ることはできません。内容を文章でまとめると、次のとおりです……
この内容を PowerPoint にして
PowerPoint を作りました。
変え方
管理者が、CoWork で使うエージェントにコード実行ツール(code_execution)を加えます。既定では、コードを動かす前に利用者へ許可を求めます(permission_policy: always_ask)。
tools:
- tool_spec:
type: "code_execution"
name: "code_execution"
tool_resources:
code_execution:
permission_policy: "always_ask" # 既定。always_allow にすると確認なしで動く資料が作れないと言われたら、まずエージェントにコード実行ツールがあるかを確かめます。ツールごとに画面に何が出るかは「エージェントのツール」のページにまとめています。
6. 資料の体裁
既定の作り方では、資料の構成や体裁が毎回少しずつ変わります。決まった形にしたいときはスキルにします。
変えるところ:スキル(利用者のスキル・エージェントのスキル)と .pptx テンプレート
週次の売上報告を作って
(毎回、枚数と並びが変わる。SQL の説明のスライドが入ることもある)
週次の売上報告を作って
結論 → 全体 → 理由 → 次の打ち手 → 出典、の順で毎回同じ
変え方
構成と体裁をスキルに書きます。自分用なら CoWork の中で利用者のスキルとして作り(/スキル名 で呼べる)、部署で同じ形にするなら開発者がエージェントのスキルとして登録します。テンプレートの .pptx は、添付するか、スキルの中で使い方を指示します。
---
name: weekly-sales-deck
description: 店舗の売上を週次の報告スライドにする。「週次の売上報告」と頼まれたときに使う。
---
## 構成(この順で5枚)
1. 結論 2. 全体のグラフ 3. 理由(根拠は脚注) 4. 次の打ち手 5. 出典と注記
## 体裁
- 添付の .pptx テンプレートの配色とフォントを使う
- 考えた道すじ・SQL は入れないスキルの説明(description)には「いつ使うか」を書きます。頼まれた内容に合うかを、エージェントはそこで判断します。
7. 表示名・アイコン・色・質問の例
エージェントには、表示名・アイコン・色(PROFILE)と、質問の例(sample_questions)を設定できます。ただ、これらが CoWork の画面のどこにどう出るかは、確認日時点の公式ドキュメントに書かれていません。設定したら、実際の CoWork の画面で見え方を確かめてください。
CREATE OR REPLACE AGENT sales_helper
COMMENT = '店舗の売上を答えるエージェント'
PROFILE = '{"display_name": "売上アシスタント", "avatar": "chart", "color": "blue"}'
FROM SPECIFICATION
$$
instructions:
sample_questions:
- question: "先月の売上がいちばん少なかった店は?"
- question: "今月の売上は?"
$$;質問の例に載せる質問は、4の検証済みクエリにも登録しておくと、押したときの答えがそろいます。
よくある質問
CoWork のチャット画面そのものは変えられますか?
確認日時点の公式ドキュメントでは、画面の配置や部品(右側の欄や選択肢のボタンなど)を変える方法は書かれていません。変えられるのは、エージェントとセマンティックビューの設定を通した「答えに何が出るか」です。画面の作りから決めたいときは、REST API か SDK で画面を自作します。
設定を変えたら、どう確かめればよいですか?
変える前に、確かめたい質問をいくつか決めておき、変えたあとに同じ質問を投げて、答えを比べます。このページの前と後の図と同じ形です。
どれから変えるのがよいですか?
答えが的外れなら、セマンティックビュー(言葉の通じ方)から。答えは合っているが読みにくいなら、答えの書き方の指示文から。数字が聞くたびに変わるなら、検証済みクエリから直します。
次に読む
- AIエージェントの答えを資料にする:5・6の資料づくりを詳しく
- 用語集の「データの意味づけ」:メトリクス・シノニム・検証済みクエリの意味
- AIエージェント画面の動くデモ:画面を自作する場合の作り方