跳转到内容

文件与产物

查看 Markdown

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

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

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

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

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

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

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

文件通常用来:

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

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

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

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

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

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

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

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

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

版本

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

标注要改的地方,交给 Agent 修改

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

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

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

收藏

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

分享到互联网

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

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