Snowflake Cortex Agents のドキュメント生成機能を Teams・Copilot 連携で試してみた

Snowflake Cortex Agents のドキュメント生成機能を Teams・Copilot 連携で試してみた

Snowflake Cortex Agents のドキュメント生成機能を Teams・Microsoft 365 Copilot で使ってみたときの検証結果をまとめました。
2026.11.22

はじめに

Snowflake の Cortex Agents は Microsoft Teams と Microsoft 365 Copilot から利用する連携機能を提供しています。

また、Snowflake CoWork にはチャットでの分析結果を PDF・Word・PowerPoint・HTML のファイルにまとめるドキュメント生成機能があります。Teams・Copilot 連携では CoWork と同じエージェントを使えるため、この機能が Teams・Copilot 経由でも使えるのかを確認した際の内容を記事としました。

結論

先に結論を書くと、今回の環境では Teams・Copilot のいずれでもエージェントは「生成しました」と応答するものの、ファイルをチャット上で確認できませんでした。また、Copilot ではチャート自体も表示されませんでした。一方で Copilot では HTML コードを貼ってもらう方法や、回答をページとして追加して表を Excel にエクスポートする方法、回答から直接 Word にエクスポートする方法を試せたので、その内容も合わせてまとめます。

Cortex Agents のドキュメント生成機能の概要

ドキュメント生成機能については以下に記載があります。

https://docs.snowflake.com/en/user-guide/snowflake-cortex/snowflake-cowork/document-generation

Snowflake CoWork に組み込まれた機能で、チャットで形式を依頼すると、エージェントが会話の文脈とデータツールの結果をもとにファイルを生成します。主な特徴は以下の通りです。

  • 執筆時点で対応している形式は PDF(.pdf)・Word(.docx)・PowerPoint(.pptx)・HTML(.html)
  • 専用のツールや構文はなく、チャットで形式・対象読者・内容を自然言語で依頼する
  • 前提として、エージェントで code execution tool(コードサンドボックス)が有効になっている必要がある
  • 生成が終わると、CoWork 内でファイルをインライン表示できる

code execution tool については以下に記載があります。

https://docs.snowflake.com/en/user-guide/snowflake-cortex/cortex-agents-code-execution-tool

一方で、ドキュメント生成や Teams 連携のページにも Teams・Microsoft 365 Copilot でのドキュメント生成についての記載はなく、Teams 連携のページで、返ってくる形式として触れられているのは「テキスト、表形式、チャート形式」のみとあります。また、Teams と Copilot の差として書かれているのは、フィードバック機能が Teams のみという点だけでした。

前提条件

検証環境

以下の環境を使用しています。

  • Snowflake
    • Enterprise Edition(AWS 東京リージョン)
    • Cortex Agent・セマンティックビューなどの関連オブジェクトは作成済み
    • クロスリージョン推論(CORTEX_ENABLED_CROSS_REGION)はAWS_APJ
  • Microsoft 365
    • Microsoft 365 Business Standard の試用版で検証用のテナントを用意し、ユーザーに Teams Essentials のライセンスを割り当て
    • Entra ID のグローバル管理者で作業

また、Teams・Copilot と Snowflake の接続は以下の記事の内容で設定済みとします。Entra ID の管理者同意、セキュリティ統合、Snowflake ユーザーの作成、Teams アプリの接続を済ませています。

https://dev.classmethod.jp/articles/cortex-agents-microsoft-teams-integration/

ドキュメント生成機能の有効化

ドキュメント生成には、エージェントで code execution tool を有効にする必要があります。既存のエージェントには手を加えず、同じ定義に code execution tool を追加した別のエージェントを作成しました。

USE ROLE yasuhara_dev;

CREATE OR REPLACE AGENT yasuhara_test_db.COWORK_DEMO.SALES_ANALYTICS_DOC_AGENT
  FROM SPECIFICATION $$
 models:
    orchestration: auto

tools:
  - tool_spec:
      type: cortex_analyst_text_to_sql
      name: sales_analyst
      description: "日次売上データを照会するツール。カテゴリ別、地域別、日別の売上金額と販売数量を分析できます。"
  - tool_spec:
      type: code_execution
      name: code_execution

tool_resources:
  sales_analyst:
    execution_environment:
      type: warehouse
      warehouse: COMPUTE_WH
    semantic_view: yasuhara_test_db.COWORK_DEMO_SV.DAILY_SALES_ANALYTICS
  code_execution:

# instructions は既存のエージェントと同じ内容のため省略
instructions:
  ...
$$;

既存の定義からの変更点は以下の通りです。

  • toolsにtype: code_executionとname: code_executionを追加
  • tool_resourcesに、中身が空のcode_execution:を追加
  • permission_policyは指定していないため、既定のalways_ask(状態を変更するツールの実行前にユーザーの承認を求める)になります

権限があれば、エージェント作成後に Teams のチャット欄からChoose agentと入力して、作成したエージェントに切り替えることができます。

Teams から試す

Teams で作成したエージェントに以下のように依頼してみました。

  1. 「売上データの日次サマリーレポートを作成してください。」
  2. 「このレポートの内容を PDF にまとめてください。」
  3. 「パワーポイントで生成できますか」

1つ目の依頼ではエージェントが HTML ファイルを作成し、対象期間・売上合計・カテゴリ別と地域別の1位などのサマリーとレポートの構成を説明しました。その上で「このレポートを公開しますか?」と確認されます。

2つ目と3つ目の依頼でも、エージェントは PDF(全4ページ)と PowerPoint(全5枚)を作成して添付したと応答しました。作成後の確認として、PDF から文字を取り出して日本語と数字を確認したことや、スライドの画像を確認してグラフの軸の表記などを直したことも報告されています。

しかし、これらのファイルを Teams のチャット上で確認することはできませんでした。応答には作成した旨が書かれていますが、添付ファイルの表示や、ダウンロードのための操作は画面に出ません。

その他に Word でも同様にファイルは添付されませんでした。

Copilot から試す

続けて、Microsoft 365 Copilot からも同じエージェントに依頼してみました。

「売上データの日次サマリーレポートを作成し HTML で出力してください」と依頼すると、HTML のレポートを作成した旨と、サマリーが返ってきました。ここでも、最後に「このレポートを公開・共有しますか?」と確認されます。

ちなみにここで「はい公開してください」と答えると、以下のように公開できないと応答されました。Copilot 経由では Artifact の公開はできません。

申し訳ありません。現在の環境ではレポートを公開できませんでした。公開の手順が今の環境では使えないため、こちらから公開リンクを発行できません。
レポートのHTMLファイル(region_sales_report.html)は保存済みで、前回の回答からダウンロードできます。

また、Teams と同様にファイルもチャット上で確認できません。

ファイルが見えない旨を伝えると、エージェントは添付ファイルを再度送ったと応答し、Copilot が添付ファイルを表示しない仕様の可能性が高いと説明しました。その後、Word(.docx)と PDF の作成も依頼しましたが、いずれも「添付して送った」と応答されるのみで、確認できませんでした。

Copilot ではチャートが表示されない

Copilot では、ファイルとは別に回答に含まれるチャートも表示されませんでした。

「地域別の売上を教えて」と質問すると、回答の本文と表は表示されます。一方で、チャートについては見出しが表示されるだけで、グラフ自体は表示されません。Teams から問い合わせた際はグラフを含む回答が表示されていたので、Teams と Copilot で表示に差があります。

Copilot で試せたこと

ファイルを確認できない代わりに、Copilot では以下の方法でレポートの内容を確認・持ち出すことができました。

HTML コードをチャットに貼ってもらう

エージェントに「HTML のコードをここに貼れますか」と依頼すると、HTML のコード全文がチャット上に返ってきました。Copilot の画面では、このコードを含む HTML が表示されました。

回答をページに追加して Excel にエクスポートする

Microsoft Copilot には「ページ」(Copilot Pages)という機能があります。Copilot Chat の中にある、応答を編集・共有できるページにして残せる作業用の画面です。

https://support.microsoft.com/en-us/microsoft-365-copilot/how-microsoft-365-copilot-pages-works

応答の下にあるボタンからページに追加でき、既存のページにも追加できます。

https://support.microsoft.com/en-us/microsoft-365-copilot/add-microsoft-365-copilot-chat-responses-to-multiple-copilot-pages

Snowflake のエージェントの回答のうち表形式のものをページに追加してみました。

ページを開くと表を Excel にエクスポートできるメニューが表示されます。

ここでは、エクスポートした内容は下図のようになっていました。

一方で、チャートを含む回答をページに追加すると下図のようにページが開けませんでした。

回答を Word にエクスポートする

ページを経由しなくても Copilot では回答から直接 Word にエクスポートすることもできました。

エクスポートした Word は下図のようになりました。

これらは Snowflake のドキュメント生成機能ではなく、Copilot 側の機能です。

そのため、エージェントがファイルを作成して添付する方法とは違い、Copilot の画面からそのまま Word のファイルとして受け取れます。

さいごに

Cortex Agents のドキュメント生成機能を、Teams・Copilot 連携で使った場合の挙動を確認してみました。今回の環境では、Teams・Copilot のいずれも、エージェントが生成したと応答するファイルをチャット上で確認できませんでした。また、Copilot ではチャートも表示されませんでした。

一方で、Copilot では HTML コードをチャットに貼ってもらう方法や、表形式の回答をページに追加して Excel にエクスポートする方法、回答から直接 Word にエクスポートする方法を試せました。Teams・Copilot では、エージェントが生成するファイルよりも Copilot 側のエクスポート機能を使って回答の内容を Word や Excel に持ち出す使い方のほうが現実的と思いました。ファイルを確実に受け取りたい場合は CoWork の画面を使う形になります。

こちらの内容がどなたかの参考になれば幸いです。


Snowflakeの導入支援はクラスメソッドに!

クラスメソッドでは Snowflake の導入を支援しております。
製品の詳細や支援の内容についてお気軽にお問い合わせください。

Snowflakeの詳細を見る

この記事をシェアする

関連記事