AIエージェントの答えを資料にする
このページでわかること
このページでは、エージェントの答えを 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
コード実行ツールを有効にする(管理者)
資料はエージェントのコード実行ツール(サンドボックス)の中でファイルとして組み立てられます。CoWork で使うエージェントに、このツールが必要です。
- 2
形式・読み手・中身を伝えて頼む
チャットで「PowerPoint で」「誰向けに」「何を」を伝えます。エージェントは会話の文脈と、持っているデータのツールを使って下書きを作ります。
- 3
テンプレートを添付する(PowerPoint)
.pptx のテンプレートをチャットに添付し、それで作るよう頼むと、社内の体裁に合わせられます。PDF は見本を添付できますが、レイアウトどおりになるとは限りません。
- 4
画面の中で確かめる
できた資料は CoWork の中でそのまま開いて確認できます。直したいところは、続けて会話で頼みます。
- 5
繰り返すならスキルと定期実行に
構成と体裁をスキルにすると、既定の作り方より優先されます。定期実行(Automations)は、同じ質問を新しいデータで実行し直し、結果をメールで届けます。
4. 体裁を決める3つの層
「毎回同じ形の資料にしたい」とき、どこに書くかで効き方が変わります。見た目・構成・言葉を、それぞれの層に分けて持たせると、直す場所に迷いません。
見た目
テンプレート
配色・フォント・ロゴ・スライドの枠
置き場所:.pptx を添付する(またはスキルの中で使い方を指示する)
構成と手順
スキル
何枚目に何を置くか、表は何行まで、何を入れないか
置き場所:利用者のスキル(自分用)か、エージェントのスキル(全員に)
言葉と答え方
指示文
結論から書く、用語の言い換え、口調
置き場所:エージェントの指示文(response の指示)
利用者のスキルとエージェントのスキル
利用者のスキルは CoWork の中で自分用に作るもので、会話で頼んで作るか、画面の案内に答えて作るか、フォルダを上げて作ります。/スキル名 で呼べ、頼んだ内容が近いと自動でも使われます。 エージェントのスキルは開発者が作る SKILL.md のフォルダで、ステージや Git のリポジトリに置き、エージェントの仕様に登録します。部署の全員に同じ形を使わせたいなら、こちらです。5. 答えの部品を、資料のどこに入れるか
動くデモの答えを、資料に組み替える例です。会話で役に立った部品が、資料ではそのまま役に立つとは限りません。
| 会話の部品 | 資料では | 理由 |
|---|---|---|
| 状態・考えた道すじ | 入れない | 待ち時間を伝えるための部品で、読み手には関係ない |
| 実行した SQL | 付録か、入れない | 確かめたい人だけが見る。本文に置くと読み手を選ぶ |
| 表 | 要点だけの小さな表を本文に。全部は付録に | スライドに10行を超える表は読めない |
| グラフ | 1枚に1つ。結論を表題に書く | 「店舗別の売上」ではなく「渋谷店だけが大きく落ちた」と書くと、見る場所が決まる |
| 答えの文章 | 結論を最初の1枚に。理由は次の1枚に | 会話の答えは前置きから入りがち。資料は結論から |
| 引用 | その主張の近くに脚注。最後に出典の1枚 | 資料は文脈なしで読まれるので、根拠が紙面に必要 |
| 警告(速報値など) | 該当するグラフや表のすぐ下に注記 | 会話では流れても、資料では数字と一緒に残す必要がある |
組み替えた見本(最初の3枚)
先月は渋谷店だけが大きく落ちた
渋谷店 960 万円
5店舗で最少。横浜店の約半分。
原因は改装工事による入口の閉鎖。
渋谷店だけが他の4店舗から離れている
- 横浜店1,840
- 新宿店1,690
- 梅田店1,520
- 名古屋店1,280
- 渋谷店960
単位:万円 / 名古屋店は速報値
入口の閉鎖で、来店数が約6割に
10/14〜10/20、ビルの改装工事で正面入口を閉鎖。
この週の来店数は前週比 58%1。
1. 渋谷店 週次日報(10/14〜10/20)
- 1枚目は、会話の答えの最後にあった「なぜ」を、結論として先頭に出しています
- 2枚目のグラフは、表題に「何が起きたか」を書き、見てほしい棒だけを濃くしています。速報値の警告は、グラフのすぐ下の注記にしました
- 3枚目は、引用を脚注にしています。考えた道すじと SQL は入れていません
6. 資料を作るスキルの例
上の組み替えの考え方を、スキルにした例です。スキルには名前・説明・手順を持たせ、エージェントは名前と説明を見て、頼まれた内容に合うかを判断します。 そのため説明には「いつ使うか」を書きます。書き方の細部は公式ドキュメントで確かめてください。
---
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 での使い方を中心に書いています。
次に読む
- AIエージェント画面の動くデモ:資料にする前の、会話の答えがどう届くか
- 用語集の「既製の画面と出力」:Snowflake CoWork・文書生成・Vega-Lite