エージェントが作成するファイル(プレビュー)

[この記事はプレリリース ドキュメントであり、変更されることがあります。]

エージェントは会話中に、ユーザーが要求した作業の結果としてレポート、スプレッドシート、画像、コードスニペットなどのファイルを作成できます。 エージェントはこれらのファイルをユーザーに返し、確認やダウンロードできるようにします。

注:

この記事の機能は、使用量に基づく請求にCopilot Creditsを用いるGitHub Copilotハーネスによって機能しています。 GitHub Copilotハーネスで動くエージェントの請求概要でCopilotクレジットについて詳しく学びましょう。

使用率に基づく請求は、エージェントの使用、構築、テスト、評価に適用されます。 これらの行動はCopilotクレジットを消費することがあります。

エージェントがファイルを作成するとき

エージェントは、ユーザーのリクエストが自然にファイルを生成するときにファイルを作成します。 一般的なパターンは次のとおりです。

  • 会話に基づいてドキュメント、デッキ、またはスプレッドシートを生成すること。
  • ユーザーが提供したデータからチャート、図、画像を作成すること。
  • ユーザーが求めたコードファイル、スクリプト、またはデータ抽出を出力します。
  • ユーザーが添付したファイルを編集し、更新されたバージョンを返すこと。

この動作を明示的に設定するわけではありません。 エージェントがターンを完了するためにファイルを書き込む必要がある場合、それを生成し、レスポンスに含めます。

ユーザーが作成したファイルをどう見るか

ファイルを生成するターンの終了時に、エージェントの応答にはメッセージテキストの下に 作成されたファイルカード が記載されます。 カードには、次の情報が表示されます。

  • ファイル名とファイルの種類。
  • ファイル形式に合ったプレビューやアイコン。
  • ダウンロードアクションです。

作成されたファイルカードは、エージェントが動作するすべてのサーフェスに現れます:

  • エージェントをテストするときに、Copilot Studioのプレビュータブです。 詳しくは 「エージェントのテスト」をご覧ください。
  • Microsoft Teams、Microsoft 365 Copilot、ウェブチャットなどの公開チャネルも公開されています。 各チャンネルはネイティブのアタッチメントやファイル体験を使ってカードをレンダリングします。

ユーザーは作成したファイルをフォローアップのターンで参照できます(例:「チャートをもっと高くする」や「これをフランス語に翻訳する」など)。 エージェントはファイルを読み返し、更新されたバージョンを生成できます。

保持期間と制限

作成されたファイルは ユーザー添付ファイルと同じ期間会話に保存されるため、ユーザーとエージェントの両方がターンを越えて参照できます。

アイテム 極限
作成ファイルあたりのサイズ 10MB
会話あたりの保持率 会話の最後のアクティビティから28日後
サイズ制限を超えたときの行動 そのファイルは返答には表示されていません。 ターンは続き、エージェントは通常、なぜファイルが提出されなかったのかを説明します。

エージェントの作業で10MBを超えるファイルが生成される場合は、出力を分割するよう依頼してください。例えば、長いレポートの章ごとに1つの納品物を出すなど、各ファイルを制限以下に保つようにしましょう。

保持期間が経過すると、作成されたファイルは会話から削除されます。