AIエージェントの答えを資料にする

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

このページでわかること

このページでは、エージェントの答えを PDF・Word・PowerPoint・HTML の資料にするとき、何をどこで決めるかを確認できます。 Snowflake CoWork の文書生成でのやり方と、会話の答えを資料に組み替えるときの考え方の2つに分けて書いています。

1. 会話の答えと資料は、読む人が違う

会話の答えは、質問した本人がその場で読みます。資料は、その場にいない人があとで読みます。同じ中身でも、見せる部品と順番が変わるのはこのためです。

会話の答え資料
読む人質問した本人その場にいない人(上司・会議の参加者・取引先)
読む時いま、答えが出た直後あとで。数日後に開き直すことも
前提の共有質問の文脈がある文脈が無い。資料だけで通じる必要がある
途中経過見せると待ち時間が伝わる入れない(読み手には関係ない)
根拠折りたたみで、開けば見える脚注・出典・付録として紙面に残す
そのあと続けて質問する配る・発表する・手で直す

2. 形式は「受け取った人の次の行動」で選ぶ

Snowflake CoWork の文書生成が作れる形式は4つです。どれを選ぶかは、受け取った人がそのあと何をするかで決まります。

PowerPoint(.pptx)

向く場面:会議で発表する・配る

受け取った人は:受け取った人が手で直す。社内のテンプレートに合わせたい

.pptx のテンプレートを添付できる

Word(.docx)

向く場面:文章で説明する報告書

受け取った人は:受け取った人が追記・校正する

PDF(.pdf)

向く場面:形を崩さずに配る

受け取った人は:読むだけ。直さない

見本の PDF を添付できるが、レイアウトどおりになるとは限らない

HTML(.html)

向く場面:画面の中でそのまま読む

受け取った人は:CoWork の中で開いて見る

CoWork の中でそのまま表示される

3. Snowflake CoWork でのやり方

  1. 1

    コード実行ツールを有効にする(管理者)

    資料はエージェントのコード実行ツール(サンドボックス)の中でファイルとして組み立てられます。CoWork で使うエージェントに、このツールが必要です。

  2. 2

    形式・読み手・中身を伝えて頼む

    チャットで「PowerPoint で」「誰向けに」「何を」を伝えます。エージェントは会話の文脈と、持っているデータのツールを使って下書きを作ります。

  3. 3

    テンプレートを添付する(PowerPoint)

    .pptx のテンプレートをチャットに添付し、それで作るよう頼むと、社内の体裁に合わせられます。PDF は見本を添付できますが、レイアウトどおりになるとは限りません。

  4. 4

    画面の中で確かめる

    できた資料は CoWork の中でそのまま開いて確認できます。直したいところは、続けて会話で頼みます。

  5. 5

    繰り返すならスキルと定期実行に

    構成と体裁をスキルにすると、既定の作り方より優先されます。定期実行(Automations)は、同じ質問を新しいデータで実行し直し、結果をメールで届けます。

4. 体裁を決める3つの層

「毎回同じ形の資料にしたい」とき、どこに書くかで効き方が変わります。見た目・構成・言葉を、それぞれの層に分けて持たせると、直す場所に迷いません。

見た目

テンプレート

配色・フォント・ロゴ・スライドの枠

置き場所:.pptx を添付する(またはスキルの中で使い方を指示する)

構成と手順

スキル

何枚目に何を置くか、表は何行まで、何を入れないか

置き場所:利用者のスキル(自分用)か、エージェントのスキル(全員に)

言葉と答え方

指示文

結論から書く、用語の言い換え、口調

置き場所:エージェントの指示文(response の指示)

利用者のスキルとエージェントのスキル

利用者のスキルは CoWork の中で自分用に作るもので、会話で頼んで作るか、画面の案内に答えて作るか、フォルダを上げて作ります。/スキル名 で呼べ、頼んだ内容が近いと自動でも使われます。 エージェントのスキルは開発者が作る SKILL.md のフォルダで、ステージや Git のリポジトリに置き、エージェントの仕様に登録します。部署の全員に同じ形を使わせたいなら、こちらです。

5. 答えの部品を、資料のどこに入れるか

動くデモの答えを、資料に組み替える例です。会話で役に立った部品が、資料ではそのまま役に立つとは限りません。

会話の部品資料では理由
状態・考えた道すじ入れない待ち時間を伝えるための部品で、読み手には関係ない
実行した SQL付録か、入れない確かめたい人だけが見る。本文に置くと読み手を選ぶ
表要点だけの小さな表を本文に。全部は付録にスライドに10行を超える表は読めない
グラフ1枚に1つ。結論を表題に書く「店舗別の売上」ではなく「渋谷店だけが大きく落ちた」と書くと、見る場所が決まる
答えの文章結論を最初の1枚に。理由は次の1枚に会話の答えは前置きから入りがち。資料は結論から
引用その主張の近くに脚注。最後に出典の1枚資料は文脈なしで読まれるので、根拠が紙面に必要
警告(速報値など)該当するグラフや表のすぐ下に注記会話では流れても、資料では数字と一緒に残す必要がある

組み替えた見本(最初の3枚)

先月は渋谷店だけが大きく落ちた

渋谷店 960 万円

5店舗で最少。横浜店の約半分。

原因は改装工事による入口の閉鎖。

1枚目

渋谷店だけが他の4店舗から離れている

  • 横浜店1,840
  • 新宿店1,690
  • 梅田店1,520
  • 名古屋店1,280
  • 渋谷店960

単位:万円 / 名古屋店は速報値

2枚目

入口の閉鎖で、来店数が約6割に

10/14〜10/20、ビルの改装工事で正面入口を閉鎖。

この週の来店数は前週比 58%1。

1. 渋谷店 週次日報(10/14〜10/20)

3枚目
  • 1枚目は、会話の答えの最後にあった「なぜ」を、結論として先頭に出しています
  • 2枚目のグラフは、表題に「何が起きたか」を書き、見てほしい棒だけを濃くしています。速報値の警告は、グラフのすぐ下の注記にしました
  • 3枚目は、引用を脚注にしています。考えた道すじと SQL は入れていません

6. 資料を作るスキルの例

上の組み替えの考え方を、スキルにした例です。スキルには名前・説明・手順を持たせ、エージェントは名前と説明を見て、頼まれた内容に合うかを判断します。 そのため説明には「いつ使うか」を書きます。書き方の細部は公式ドキュメントで確かめてください。

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

# 週次売上報告スライドの作り方

## 構成(この順で5枚)
1. 結論:今週いちばん伝えたいこと1つを、文章1行で表題にする
2. 全体:店舗別の売上の横棒グラフ。表題には「何が起きたか」を書く
3. 理由:落ちた店(または伸びた店)の理由。根拠の文書を脚注に付ける
4. 次の打ち手:箇条書き3つまで
5. 出典と注記:使った文書の一覧、速報値などの注記

## 体裁
- 添付された .pptx テンプレートがあれば、その配色・フォント・レイアウトを使う
- 数字は桁区切り。金額は「万円」にそろえる
- 表は5行まで。それ以上は付録に回す
- 考えた道すじ・SQL は本文に入れない

7. 資料を頼むときの型

スキルを作る前に、まず会話で頼むときの型です。読み手・伝えたいこと・枚数・グラフ・根拠・体裁の6つを書くと、直しの往復が減ります。

AIプロンプトテンプレート

PowerPoint で、来週の店長会議で使う報告スライドを作ってください。

- 読み手:店長たち(数字には慣れているが、データの細かい定義は知らない)
- 伝えたいこと:先月いちばん売上が落ちた店と、その理由
- 枚数:5枚以内。1枚目に結論を書く
- グラフ:1枚に1つ。表題には「何が起きたか」を書く
- 根拠:理由には、元にした日報を脚注で付ける。最後に出典の1枚
- 体裁:添付したテンプレートの配色とフォントに合わせる

このプロンプトはあくまでたたき台です。AIの回答はモデルやバージョン、会話の文脈によって毎回異なります。意図通りに動かない場合は、条件を追記・修正してお使いください。

よくある質問

資料を作るのに、特別な設定は要りますか?

Snowflake CoWork で使うエージェントに、コード実行ツールが有効になっている必要があります。資料は、このツールの中でファイルとして組み立てられます。使えないときは、管理者にコード実行ツールの有効化を頼みます。

社内のテンプレートに合わせられますか?

PowerPoint は、.pptx のテンプレートをチャットに添付して、そのテンプレートで作るよう頼めます。毎回添付せずに済ませたいときは、テンプレートの使い方をスキルにしておきます。PDF は見本を添付できますが、レイアウトどおりになるとは限りません。

毎週同じ資料を作らせたいときは?

構成と体裁をスキルにまとめると、毎回同じ形で作れます。さらに、Snowflake CoWork の定期実行(Automations)は、同じ質問を新しいデータで実行し直し、結果をメールで届けられます。

自作の画面から資料を作れますか?

資料づくりはコード実行ツールとスキルの組み合わせなので、エージェント側の仕組みとしては同じです。ただ、自作の画面で生成したファイルをどう受け取るかは、確認日時点の公式ドキュメントでは見つけられませんでした。このページでは、Snowflake CoWork での使い方を中心に書いています。

次に読む

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