[本文是预发行文档，可能会有所更改。]
用户可以将文件附加到消息中，以便智能体在该轮对话中读取、总结或以其他方式对这些文件进行推理。 附件是用户每回合输入的，而不是由制作者永久配置的数据源。
注释
本文的功能由 GitHub Copilot 框架驱动，该工具使用 Copilot 积分进行基于使用量的计费。 在GitHub Copilot harness驱动的代理计费概览中，了解更多关于Copilot积分的信息。
基于使用量的计费适用于使用、构建、测试和评估代理。 这些操作可能会消耗Copilot积分。
附件与知识来源
附件和 知识源 是不同的概念。 选择符合你的情况的一项。
| 概念 | 由谁提供 | Scope | 典型用法 |
|---|---|---|---|
| 附件 | 每条消息的终端用户 | 一个对话 | “总结这份合同”，“这截图里写的是什么？” |
| 知识来源 | 设计时的制造者 | 和代理人的每一次对话 | 政策文档、产品目录、帮助文章 |
当代理需要始终访问相同内容时，请添加知识源。 当内容与他们的请求独一无二时，要求用户附加文件。
支持的附件类型
| 类型 | Examples | 备注 |
|---|---|---|
| 图像 | .png， .jpg， .gif， .webp | 智能体使用具备视觉能力的模型来描述或回答关于图像的问题。 |
| 文本被提取出来，供特工进行推理。 | ||
| 文本文档 | .txt， .csv， .html， .md | 内容以文本形式传递给代理。 |
| URL | 任何公开可访问的HTTP或HTTPS网址 | 代理会下载当前回合的链接文件（详见本文后面的URL下载行为）。 |
用户附加文件的地方
用户可以在代理运行的任何表面附加文件：
- 在Copilot Studio测试代理时的预览标签页。 了解更多，见 “测试代理人”。
- 任何支持附件的已发布频道，如 Microsoft Teams、智能 Microsoft 365 Copilot 副驾驶® 和网页聊天。
用户在消息撰写器中选择附件图标，选择一个或多个文件，根据需要添加消息，然后发送该消息。 代理会在收到消息时一并收到附件。
代理如何处理附件
- 代理在处理消息时会读取每个附件。 附件仅影响随其一同发送的那一轮对话，除非智能体在同一对话的后续内容中再次引用这些附件。
- 如果附件无法处理（例如无效文件或下载失败的URL），代理会跳过该附件，处理其余信息。 消息仍会被发送。
- 附件不能取代 知识源、 内存或 工具 输出。 它们是特工在当前转弯时考虑的另一个信号。
URL附件
当用户附加URL时，代理会下载该URL的文件，并将其视为该回合的上传附件。
- 下载必须在30秒内完成。 较慢的响应会超时，并且该轮中的 URL 会被跳过。
- 该URL必须是Microsoft服务中公开访问的。 需要登录或位于防火墙后的链接是无法工作的。
- 即使URL下载失败，消息仍会继续发送。
保留和限制
附件会在整个对话期间存储，而不仅限于当前轮次。 如果用户在对话早期附加了文件，代理可以在后续回合再次引用（例如，“将此与我之前发送的文件进行比较”）。
| Item | Limit |
|---|---|
| 附件大小（每个文件） | 16 MiB |
| URL 附件下载超时 | 30 秒 |
| 依恋保留率（每次对话） | 距离对话中最后一次活动已过去28天 |
| 失败时的依恋行为 | 代理跳过失败的附件，继续处理消息 |
保留窗口过后，存储的附件会从对话中删除，代理无法再引用。 同样的保留窗口适用于代理在对话中 创建的任何文件 。