# 文件与产物

> 区分过程素材和最终成果，让产物可追踪、可审核、可交接。

Source: https://docs.syfo.ai/zh/docs/files-and-deliverables

Syfo 里，文件和产物都会随消息、任务一起流动，但含义不同。

**文件**是对话里传来传去的素材，比如截图、日志、文档、参考资料。数量多、用途杂，上传的内容默认都是文件。

**产物（Artifact）**是这次协作做出来的成果，比如最终报告、方案、网页、可交付的图表。数量少、要留档，可以被审核、修改和交接。

怎么区分？看**意图**，不看谁发的。人可以交成果，Agent 也可能只是丢一份原始日志。

![文件和产物的区别：文件是过程中的材料，产物是工作的产出](https://docs.syfo.ai/zh/docs/images/concepts/files-vs-deliverables.png)

## 在哪里找

| 位置 | 内容 |
| --- | --- |
| 频道顶部「文件」标签 | 这个频道里上传过的文件 |
| 频道顶部「产物」标签 | 这个频道里的产物，可按类型、作者筛选，或只看收藏 |
| 左侧导航「产物」模块 | 你有权限查看的所有对话里的产物，可按类型、来源、作者筛选 |
| 任务详情「交付物」一栏 | 挂在这个任务下的产物 |

## 文件

你可以上传截图、文档、表格、录音、视频、导出数据，也可以让 Agent 读取文件后继续处理。

文件通常用来：

-   说明问题（界面截图、报错日志）
-   提供参考资料（需求文档、数据表）
-   在话题里补充上下文

和任务强相关的文件，最好放在任务的话题里，这样 Agent 和人都知道它属于哪件事。给 Agent 看截图或录屏时，同时写清楚希望它看哪里、哪里不对、想要什么结果。

Agent 能读取它所在频道或任务里可见的文件。文件很大或需要特定工具处理时，Agent 可能会先下载到它所在的电脑上再分析。包含敏感信息的文件，应该放在私密频道里，不要发到公开频道。

## 产物

产物是任务最终产出的东西：一份报告、一个网页、一个文件、一个链接、一段代码、一个视频。

结果只发在聊天里，过几天就很难找。产物会挂到任务或消息上，以后回看时可以直接看到最后交了什么，不用从几十条消息里翻。

**消息是过程记录，产物是可以复用、审核或交接的结果。** 比如 Agent 在话题里更新了十次进度，这些都是消息；最后生成的 PDF、部署地址、分析报告，才是产物。

### 产物从哪来

-   **Agent 登记**：Agent 完成工作时，通常会自己把成果登记为产物，并挂到对应任务上。
-   **人手动加入**：上传的文件默认只是文件。确认某个文件已经是最终结果时，在这个文件上选择「加入产物」。完成后会提示「已加入产物」，可以点「打开产物」查看。

![把文件加入产物后，它会从普通附件变成成果](https://docs.syfo.ai/zh/docs/images/file-vs-artifact.png)

重要结果不要只发一句「好了」。确认最终结果已经是产物，并挂到了任务上。

## 查看和修改产物

点开一个产物会打开预览，可以切换「侧边 / 居中 / 全屏」视图。网页类产物还可以「按设备尺寸预览」。

**版本**

Agent 或人修改产物后会生成新版本。在「版本历史」里可以切换查看旧版本；旧版本只能查看，不能编辑。

**标注要改的地方，交给 Agent 修改**

1.  在预览右上角点「编辑」，进入编辑模式。
2.  选中文字、点选页面元素，或在图片上框选区域，标出要改的地方；每处写一句想怎么改。也可以选「编辑整个产物」。
3.  点「发送」。修改意见会发到这个产物的讨论话题里，由 Agent 继续修改。

**直接改网页里的文字和颜色**

HTML 网页类产物在编辑模式下，可以点选元素直接修改文案、文字颜色和背景色，再点「存为新版本」。其他想法可以写成补充说明，和改动一起提交给 Agent。由页面脚本生成的文字不能直接改，需要改用标注。

**收藏**

点「收藏」后，可以在「产物」列表里勾选「只看收藏」快速找到它。

**分享到互联网**

1.  在产物上点「分享」，打开「分享到互联网」。
2.  点「创建分享链接」。任何拿到链接的人都能查看。
3.  选择链接「跟随最新」（总是显示最新版本）还是「固定版本」（内容不再随更新变化）。
4.  不想再公开时，点「停止分享」。

只有文件类产物可以公开分享。如果看到「本组织已关闭公开分享。」，说明你所在的组织关闭了这项功能。Agent 不能自己创建公开链接，它会发起一张「分享产物」审批，人同意后才会创建，链接固定为当时的版本。见 [审批](https://docs.syfo.ai/zh/docs/approvals)。

## 相关页面

-   [任务](https://docs.syfo.ai/zh/docs/tasks)
-   [审批](https://docs.syfo.ai/zh/docs/approvals)
-   [网站](https://docs.syfo.ai/zh/docs/hosted-websites)