第5章 上传文件与资料：先让 Agent 读懂，再开始工作

当你把一份会议纪要、商品说明或课程资料交给 Agent 时，真正的第一步不是“让它总结”，而是确认它到底收到了什么。文件出现在列表里，只能说明它被上传或保存过；它是否能读取、读取了哪一部分、是否引用了正确版本，都要单独检查。

本章解决一个很常见的问题：你以为 Agent 已经看过资料，它其实只看到了文件名，或者引用了旧文件。我们用一份完全虚构的《XX项目第三次筹备会议纪要》练习从准备、上传、引用、读取确认到结果核对的完整过程。

先理解：文件在 Coze 里有几种状态

对初学者来说，“文件”容易被理解成一个按钮。更准确的理解是，它至少可能经历几个不同状态：

• 本地资料：还在你的电脑或手机上，Agent 尚未收到。
• 已上传资料：出现在当前对话或文件目录中，但还没有证明 Agent 已经读懂。
• 本次引用资料：你明确告诉当前任务使用哪一个文件。
• 生成产物：Agent 根据资料生成的草稿、表格或其他文件，仍然需要检查。
• 分享资料：你把文件交给其他人或公开链接，风险和“自己查看”完全不同。

官方文档说明，用户上传的素材和 Agent 生成的文件可能进入文件目录或云盘；具体存储位置、可见范围、格式处理和分享方式以当前账号界面为准。官方文件说明 以及云盘使用须知也提醒用户对上传、保存和分享的内容负责。

因此，本章的原则不是“上传后放心交给 Agent”，而是：先确认输入，再允许处理；先看草稿，再决定保存或分享。

为什么“读取确认”比“总结”更重要

人阅读文件时，会自然地看到标题、段落和上下文；Agent 处理文件时，则要先把文件解析成可用的输入。解析过程中可能遇到扫描图片、表格单元格、分页、重复版本或内容超出任务范围等情况。即使最终回答语气很确定，也不代表每一页都被识别，更不代表它知道哪些内容是结论、哪些只是讨论。

所以，读取确认不是多余的准备动作，而是一次小型验收。它把“我觉得 Agent 应该看到了”变成“Agent 明确回显了这些内容，我也能在原文中找到”。当资料较长时，可以先让 Agent 输出标题、章节或关键字段；当资料格式复杂时，可以先换成短文本验证流程，再决定是否上传原文件。这个顺序能减少一个常见返工：先生成一篇看似完整的方案，后来才发现输入就错了。

文件范围也会影响结果

如果一个项目里有多份会议纪要、几版商品说明或多个学习计划，Agent 可能面对相互矛盾的内容。你在 Prompt 中写“请参考项目资料”，范围就太宽了；更稳妥的写法是指出文件名、版本或本次要使用的栏目。如果无法确认文件版本，先让 Agent 列出它看到的候选文件，再由人选择。

文件格式也会改变核对方式。纯文本通常适合逐句核对；表格要检查列名、空白单元格和数字格式；图片或扫描件要特别注意文字识别遗漏。没有经过核对的表格数字，不应直接进入报价、预算或对外报告。Coze 能处理某类文件，并不等于它能理解其中每个图表或隐藏备注。

对普通用户来说，最安全的默认设置不是追求一次上传很多资料，而是指定一份、一个范围、一个输出目标。等第一份资料的读取结果通过，再增加第二份资料；等草稿核对无误，再考虑保存或分享。这样做会多花几分钟，却能让错误更容易定位，也不会因为文件太多而无法判断 Agent 到底参考了哪一份。

主案例：一份会议纪要到底讲了什么

准备一个只用于练习的文本文件，内容如下：

项目第三次筹备会议纪要（虚构）

已确定：活动主题方向为“数智未来·转型赋能”。
当前情况：主题方向已讨论，但嘉宾、场地和最终预算尚未确认。
讨论建议：下次会议前整理两种主视觉方向，并准备活动流程草案。
已提出行动：整理主视觉初稿；确认候选场地；补充预算信息。
待确认：负责人、截止日期、嘉宾名单、场地和预算。

文件名可使用 XX项目第三次筹备会议纪要.txt。不要把真实会议记录、客户名单、合同、身份证、密码或联系方式放进练习文件。文件名可以帮助你识别资料，但不等于内容本身；Agent 不能根据文件名猜出不存在的事实。

从准备到引用：每一步都说明为什么

1. 先决定这份资料能不能交给 Agent

上传前先问自己三个问题：这份资料是否脱敏？本次任务是否真的需要它？结果是否会被分享给别人？如果资料中包含不必要的个人信息，先在本地删掉；如果只是想测试格式，可以使用上面的虚构文本。

这一步看起来和 Coze 无关，却决定了后续风险。上传之后，资料可能保存到文件目录或云盘，也可能被用于后续任务。少上传一份不需要的资料，通常比事后清理更简单。

2. 找到当前界面的文件入口

进入练习 Agent 或项目对话，在输入区附近寻找当前可见的 +、附件或文件入口。不同版本、账号和 Agent 类型的布局可能不同，不要按旧截图寻找完全相同的图标。如果暂时找不到入口，先检查输入框左侧、下方或展开菜单中的文件选项；仍然没有时，把它记为“当前界面待实测”，不要假装已经完成上传。

选择虚构的会议纪要后，先不要急着发送任务。让文件名出现在待发送区或当前文件列表中，确认选择的是本次练习的文件，而不是同名旧稿。文件列表可能会展示上传文件、生成文件或历史版本，看到名称后还要确认来源和时间线索。

3. 在对话中明确引用哪份资料

上传和引用是两个动作。上传只是把资料交给 Coze；引用是在本次任务中明确“请使用这一份”。部分当前界面支持在输入区通过附件、文件列表或 / 查找已有文件，具体入口以当前账号为准。

引用后先发送一个“读取确认”任务，不要让 Agent 立刻生成方案：

请先确认你收到的资料名称，并用 3–5 条说明这份资料中实际能找到什么。
请区分：已经确定的内容、讨论中的建议、仍然缺少的信息。
只做资料盘点，不生成方案，不补写资料中没有的内容。

这个 Prompt 的结构很简单：先确认文件身份，再让 Agent 回显可见内容，最后限制它不要越过资料盘点阶段。它不是为了得到漂亮答案，而是为了建立输入证据。

4. 对照原文判断“读到了多少”

收到回复后，至少核对四点：文件名是否正确；主题是否和原文一致；“已确定”和“建议”有没有被混淆；嘉宾、场地、预算、负责人和截止日期是否被标成待确认。如果 Agent 只说“我已读取文件”，却没有回显内容，不要把这句话当成读取证明。

可以继续追问一个具体范围：

请只列出原文中明确出现的行动和待确认事项，并分别引用对应的短句。
如果原文没有负责人、日期或预算数字，请明确写“原文未提供”。

在当前账号成功得到读取确认后，再进入结构化处理；如果读不到，先处理文件或格式问题，不要让 Agent 继续生成正式文档。

这张图应当展示真实的读取确认与资料范围：文件身份、已确定内容、讨论建议和缺失信息都能在回复中找到。它不是“上传成功”的装饰图；如果回复没有这些证据，就先停在核对阶段。

文件产出、版本和分享：不要混成一步

当 Agent 生成草稿、表格或 PPT 时，先把结果视为“对话中的待检查产物”。你可以检查内容后再决定是否保存为文件。若当前界面自动保存生成文件，也要打开结果确认文件名、来源和内容，而不能只看“任务完成”。

如果出现同名文件，建议在任务中要求 Agent 回显正在使用的文件名，并在本地或文件目录中保留清晰的版本标记，例如“会议纪要-初稿”和“会议纪要-修正版”。不要让 Agent 根据“最新版”三个字自行猜测哪个文件最新。

分享前要重新判断范围：自己查看属于私用；指定协作者属于分享；任何人可访问属于公开。文件中哪怕只有一个真实姓名或联系方式，也不应在没有确认的情况下公开。当前账号的分享、下载、删除和恢复入口需要实测，不在正文中写死按钮位置。

迁移案例：商品资料整理

把会议纪要换成一份虚构商品说明：

商品名称：桌面收纳盒 A
已知信息：三格、可折叠、灰色。
待补信息：材质、尺寸、价格、库存和发货时间。

任务可以改成“提取商品信息表，并把缺少字段列为待确认”。输入变化是从会议文本变成字段资料；输出变化是表格而不是五栏方案；新增风险是 Agent 可能为了让商品介绍更完整而补写材质、价格或“耐用”等宣传语。迁移时要把“没有来源的规格和承诺一律待确认”写进边界。

失败排错：Agent 说读到了，但内容明显不对

现象

Agent 回答“会议已经确定预算和负责人”，但原文只有“预算和负责人待确认”；或者它只返回通用的“这是一份项目资料”，没有列出任何可核对内容。

先检查什么

1. 当前消息是否真的附加了文件，而不是只输入了文件名。
2. 引用是否指向旧文件或同名文件。
3. 文件是否为空、内容过长、格式异常或当前 Agent 无法解析。
4. Agent 是否把用户在上一轮说过的内容混进了本次文件。

如何修正或停止

先要求它停止生成方案，只回显文件名、可识别的原文短句和缺失信息。必要时用更短的纯文本练习文件重试。如果它继续补写，停止当前任务，回到原文人工整理，不要用更多 Prompt 掩盖输入问题。

如何确认恢复

只有当 Agent 能列出“主题方向已讨论”“预算未确认”等原文事实，并明确说“原文未提供负责人和日期”，才算通过读取确认。把这次确认结果作为下一步的输入，而不是直接把第一次错误结果保存成文件。

本章产物与验收

本章完成后，你应得到一份读取确认记录和一份可人工核对的资料盘点，而不是一份未经检查的“总结”。

• 文件是虚构或脱敏的，范围明确。
• Agent 回显了正确文件名或资料范围。
• 已确定、讨论建议和待确认事项没有混在一起。
• 没有根据文件名或常识补写负责人、日期、预算或规格。
• 结果尚未被误分享或公开。

本章小结

文件工作不是“上传—等待—接受答案”，而是准备安全资料 → 上传/引用 → 读取确认 → 再处理 → 检查版本和分享范围。

下一步

下一章继续处理“要不要使用技能”这个判断：先分清技能和普通 Prompt 的差别，再决定是否授权或启用。阅读第 6 章：技能怎么用。