coze

Coze 是用于搭建 AI Agent、工作流和应用的开发平台，适合把提示词、模型、插件和业务步骤组织成可复用的功能。本条目对应 coze.com 国际站，不是国内版扣子：账号、模型、渠道和收费条件不能在两个版本之间直接照搬。

如果你的任务是“输入一段活动公告，按指定语言改写并返回”，Coze 的价值不只是替你生成一次文字，而是让输入字段、处理步骤和输出形式固定下来，供 Agent 或应用重复调用。能稳定交付同一种结果，比堆叠很多节点更重要。

先分清 Agent、App 和工作流的职责

Agent 面向对话，可以在交流中调用插件和工作流，也可以结合知识资料回答问题。App 更接近一个有业务逻辑和界面的应用：用户通过页面提交输入，后台流程完成处理，再把结果交回界面。Workflow 则是可以被调用的一组功能步骤，本身不等于完整聊天产品。

国际站提供现成模板，但应先看模板标注的是 Agent 还是 Workflow。一个文章生成工作流不会因为复制成功，就自动变成带用户界面、账号体系和发布渠道的应用；模板可以免费复制，也不代表之后的模型、插件或运行消耗都免费。模型支持情况应看当前账号的实际选择和文档，不宜根据某个模板名称推断所有账号都具备相同版本。

用一个公告翻译工作流，说明输入和输出怎样接起来

以下是依据官方编辑器机制设计的配置示例，未在账号中实际运行。目标不是做通用翻译产品，而是把“活动公告翻译”变成一个输入清楚、结果可以核对的小功能。在工作空间的 Library 中新建 Workflow，命名并写明用途后，就会进入包含 Start 和 End 的画布。

Start：不要让调用方猜该提交什么

可声明两个必填字符串参数：content 表示原始公告，target_language 表示目标语言，并分别写清说明。例如，输入内容为“活动将于 9 月 20 日 14:00 在线上举行”，目标语言为“英语”。如果必填值缺失，工作流不能被当作一次完整请求直接触发。

把目标语言单独设成参数，比把所有要求混在一段自由文本里更方便复用。调用者知道应该填哪一项，调试时也能分辨是正文缺失还是目标语言不明确。若只保留默认的 input 字段，同样可以运行，但需要自己约定文本格式，而不是期待平台自动理解任意输入。

LLM：变量要接到节点输入，再进入提示词

在 LLM 节点的输入区引用 Start 的两个参数，再在提示词中使用对应变量，例如要求“将 {{content}} 翻译成 {{target_language}}，保留原文日期、时间和专有名称，不添加原文没有的报名方式”。系统提示词可写稳定的角色和约束，用户提示词承接本次输入。

模型看到的是被传进节点的值，而不是你在画布其他地方写过的任何内容。变量名拼错、引用了错误的上游字段，都会造成看似合理但与请求无关的输出。这个例子只需要文本结果；如果业务要同时返回译文、语言代码和缺失信息，则应选择结构化输出并定义字段类型，不能只让模型“尽量写成 JSON”就结束配置。

End：返回文字，还是交回一个数据对象？

End 支持返回变量，也支持返回文本。返回变量适合把结果继续交给应用或其他逻辑处理；绑定到 Agent 时，返回的数据还可能由 Agent 整理成回答。返回文本则适合明确希望工作流直接交付一段回复的情况。应按调用方需要选择，而不是认为两种方式只有显示格式不同。

在这个翻译例子里，可以把 LLM 的文本输出接到 End 的文本回复。以后如果改成“译文加风险提示”的结构化结果，也要同步调整 End 和调用方的读取方式，否则模型虽然生成了多个字段，用户仍可能只看到其中一项。

Test run：绿色节点之外，还要核对什么？

试运行后，成功节点会显示相应状态，可展开查看实际输入和输出。应检查输入中的“9 月 20 日”和“14:00”是否被保留，是否无故新增时区、地点或链接；再试一次缺少正文、语言要求模糊的请求，看看错误发生在哪一步。绿色状态说明节点执行结束，不说明译文一定准确。

把这类样例保存为测试用例，有助于后续更换模型或修改提示词时检查结果。若某个节点使用了失败兜底，也要区分兜底结果与正常生成，避免把错误提示当作正式译文继续交付。

需要连续聊天时，为什么要看 Chatflow？

Workflow 和 Chatflow 都能组织节点，但后者围绕对话设计，能与指定会话的消息历史关联。不要因为一个普通工作流用了 LLM，就认定它天然拥有完整的多轮对话上下文。

例如，用户第二次只说“再简短一点”，是否能准确引用上一版译文，取决于你如何传入历史或绑定会话。把 Workflow 转成 Chatflow 也不是只换名字；反向转换时还要考虑对话上下文能力的变化。普通 App 工作流不能直接被当作已支持所有社交渠道或 Web SDK 的聊天服务。

发布、复制与知识接入，分别会影响什么？

工作流完成测试后，需要发布才能供 Agent 按相应流程选用。在 Agent 的工作流区域加入已发布工作流，并在 Persona & Prompt 中说明何时调用、需要收集哪些输入，比只添加一个资源名称更明确。真正对外开放，还要另行配置目标渠道或 API 接入及其权限。

资源复用也有版本边界：应用项目中可以导入 Library 的已发布工作流，但导入得到的是副本。修改项目内副本，不会自动改写 Library 的原始工作流。多个应用使用类似流程时，应记录各自版本，避免以为修正一次就已同步所有入口。

知识库、插件和记忆不是同一种能力。知识资料用于为回答提供内容；插件用于调用外部服务或获取实时信息；数据库和变量等记忆机制用于保留需要持续使用的数据。给翻译工作流加一个术语知识库可能有帮助，但为了显得功能丰富而加入无关插件，只会增加权限和故障环节。

国际站按功能与实际使用条件计费，外部工具也可能需要独立账号或授权。适合从一个输入输出明确的任务开始，确认它能被稳定调用，再扩展成客服、内容助手或业务应用。如果还不确定该选托管式平台还是可自建编排工具，可参考AI Agent 平台选型指南；比较时应使用同一地区版本和同一种任务作为依据。