Snowflake CoWork で変えられること

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

このページでわかること

このページでは、Snowflake CoWork を使う前提で、設定を変えると答えに何が出るかを、変える前と後の画面と、変え方のコードで確認できます。 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 に書きます。

yaml
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)

変え方

「なぜ」に答えるには文書を探す、と指示文に書き、ツールの説明にも「いつ使うか」を書きます。エージェントは説明を読んでツールを選びます。

yaml
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)に書きます。

sql
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 の組を登録します。

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 を作りました。

PPT店舗別売上_2026年10月.pptx5枚

変え方

管理者が、CoWork で使うエージェントにコード実行ツール(code_execution)を加えます。既定では、コードを動かす前に利用者へ許可を求めます(permission_policy: always_ask)。

yaml
tools:
  - tool_spec:
      type: "code_execution"
      name: "code_execution"
tool_resources:
  code_execution:
    permission_policy: "always_ask"   # 既定。always_allow にすると確認なしで動く

資料が作れないと言われたら、まずエージェントにコード実行ツールがあるかを確かめます。ツールごとに画面に何が出るかは「エージェントのツール」のページにまとめています。

6. 資料の体裁

既定の作り方では、資料の構成や体裁が毎回少しずつ変わります。決まった形にしたいときはスキルにします。

変えるところ:スキル(利用者のスキル・エージェントのスキル)と .pptx テンプレート

変えないと

週次の売上報告を作って

PPT売上報告.pptx9枚・既定の配色

(毎回、枚数と並びが変わる。SQL の説明のスライドが入ることもある)

変えると

週次の売上報告を作って

PPT週次売上報告_11月第3週.pptx5枚・社内テンプレート

結論 → 全体 → 理由 → 次の打ち手 → 出典、の順で毎回同じ

変え方

構成と体裁をスキルに書きます。自分用なら CoWork の中で利用者のスキルとして作り(/スキル名 で呼べる)、部署で同じ形にするなら開発者がエージェントのスキルとして登録します。テンプレートの .pptx は、添付するか、スキルの中で使い方を指示します。

markdown
---
name: weekly-sales-deck
description: 店舗の売上を週次の報告スライドにする。「週次の売上報告」と頼まれたときに使う。
---

## 構成(この順で5枚)
1. 結論 2. 全体のグラフ 3. 理由(根拠は脚注) 4. 次の打ち手 5. 出典と注記

## 体裁
- 添付の .pptx テンプレートの配色とフォントを使う
- 考えた道すじ・SQL は入れない

スキルの説明(description)には「いつ使うか」を書きます。頼まれた内容に合うかを、エージェントはそこで判断します。

7. 表示名・アイコン・色・質問の例

エージェントには、表示名・アイコン・色(PROFILE)と、質問の例(sample_questions)を設定できます。ただ、これらが CoWork の画面のどこにどう出るかは、確認日時点の公式ドキュメントに書かれていません。設定したら、実際の CoWork の画面で見え方を確かめてください。

sql
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 で画面を自作します。

設定を変えたら、どう確かめればよいですか?

変える前に、確かめたい質問をいくつか決めておき、変えたあとに同じ質問を投げて、答えを比べます。このページの前と後の図と同じ形です。

どれから変えるのがよいですか?

答えが的外れなら、セマンティックビュー(言葉の通じ方)から。答えは合っているが読みにくいなら、答えの書き方の指示文から。数字が聞くたびに変わるなら、検証済みクエリから直します。

次に読む

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