会話にファイルを添付する

ユーザーはメッセージにファイルを添付し、エージェントがそのターンのためにそれらを読んだり、要約したり、その他の方法で分析できるようにします。添付ファイルはユーザーからのターンごとの入力であり、永続的なメーカー設定のデータソースではありません。

Note

この記事の機能は、GitHub Copilot harnessを搭載するエージェントやワークフローで使用されています。

使用率に基づく請求は、エージェントの使用、構築、テスト、評価に適用されます。これらの行動はCopilotクレジットを消費することがあります。詳細は「GitHub Copilot harnessで動くエージェントのコスト管理」をご覧ください。

添付資料と知識源の比較

アタッチメントと知識源は別の概念です。自分の状況に合ったものを選びましょう。

概念	誰がそれを提供するのか	Scope	一般的な使用方法
Attachment	エンドユーザー、メッセージごとに	1 つの会話	「この契約書を要約してくれ」「このスクリーンショットには何が書いてある?」
知識源	設計時の製作者	エージェントとのすべての会話	ポリシードキュメント、製品カタログ、ヘルプ記事

エージェントが常に同じコンテンツにアクセスできるはずなのに、知識ソースを追加しましょう。コンテンツがリクエストに固有の場合は、ユーザーにファイルの添付を依頼してください。

タイプ	Examples	注記
Excel	.xls、.xlsx	エージェントが推論できるように、テキストと表が抽出されます。
画像	.png、 .jpg、 .gif、.webp	エージェントは視覚対応モデルを用いて画像に関する質問を説明または回答します。
PDFファイル	.pdf	テキストはエージェントが検討するために抽出されます。
PowerPoint	.ppt、.pptx	テキストや画像はエージェントが検討するために抽出されます。
テキスト文書	.txt、 .csv、 .html、.md	コンテンツはテキストとしてエージェントに渡されます。
URLズ	公開可能なHTTPまたはHTTPSのURLは任意です	エージェントは現在のターンのリンクファイルをダウンロードします(この記事の後半でURLダウンロードの動作を参照)。
ワード	.doc、.docx	テキストはエージェントが検討するために抽出されます。

Note

ユーザーアタッチドファイルはMicrosoft Purviewラベルをサポートしています。

ユーザーはエージェントが動作する任意の表面にファイルを接続できます:

ユーザーはメッセージ作成ツールで添付アイコンを選択し、1つ以上のファイルを選択し、オプションのメッセージを追加し、順番を送信します。エージェントは添付ファイルとメッセージを同時に受け取ります。

Copilot Studioの「エージェントのテスト」ペインにあるメッセージ作成者のスクリーンショットで、添付アイコンが表示されています。

エージェントはメッセージを処理する際に各添付ファイルを読み取ります。添付ファイルは、それが送信されたターンにのみ影響します。ただし、同じ会話の中で後からエージェントが再びそれらに言及した場合は、この限りではありません。
添付ファイルが処理できない場合(例えば無効ファイルやURLダウンロード失敗)、エージェントはその添付ファイルをスキップし、残りのメッセージを処理します。メッセージはまだ送信済みです。
アタッチメントは知識源やメモリ、ツール出力の代わりにはなりません。それはエージェントが現在のターンで考慮するもう一つの信号です。

ユーザーがURLを付けると、エージェントはそのURLのファイルをダウンロードし、そのターン用のアップロード済み添付ファイルとして扱います。

添付ファイルは現在のターンだけでなく、会話の期間中に保存されます。もしユーザーが会話の前にファイルを添付した場合、エージェントは後のターンで再度参照できます(例えば「これを先に送ったファイルと比較してください」)。

アイテム	制限
添付ファイルサイズ(ファイルごと)	16 MiB
URL添付ファイルダウンロードタイムアウト	30 秒
添付ファイルの保持（会話ごと）	会話の最後のアクティビティから28日後
失敗時の愛着行動	エージェントは失敗した添付をスキップし、メッセージの処理を続けます

保持期間が経過すると、保存された添付ファイルは会話から削除され、エージェントが参照できなくなります。この保持期間は、会話中にエージェントが作成したすべてのファイルにも適用されます。

このページはお役に立ちましたか?