构建 Workflow
Workflow 是 Agent Business 的两种 Capability 类型之一。当一个 Single Agent 不足以完成任务，需要显式步骤、分支、Tool 或结构化中间结果时，选择 Workflow。
1. 创建 Capability
Section titled “1. 创建 Capability”在创作者控制台打开 Agent Business，选择 Capability，然后选择 Workflow。原生 Workflow 会打开 DAG 编辑器。Dify 支持的 Workflow 会打开 Provider Configuration，因为它的图仍由 Dify 管理。
2. 在 Canvas 上构建
Section titled “2. 在 Canvas 上构建”原生编辑器提供六种 v1 节点：
- Input 在 Schema 验证后暴露调用输入。
- Agent 调用一个不可变的 Single Agent Capability Release。
- Tool 调用一个目录或自定义操作。
- Condition 使用受限操作符选择
true或false分支。 - Transform 在不执行任意 JavaScript 的情况下创建结构化数据。
- Output 返回符合 Workflow 输出 Schema 的值。
使用 Canvas 连接并检查图。你可以从节点面板、节点输出端或 Edge 上下文插入步骤。上下文插入会保留所选路径；从节点面板添加则会有意创建一个未连接的 Draft 节点。
未连接的 Draft 节点会显示 Needs connection。在可视化编辑过程中这是不阻塞状态，因此选择一个组件时不会立刻弹出全局错误；但在所有可执行节点都能从 Input 到达前，它会阻止 Save Draft 和 Preview。Validation 会指出相关节点或 Edge，并可把焦点移动到该位置。
只创建一个 Input，并至少创建一个 Output。编辑器会拒绝重复 Edge、不兼容端口、重复使用的 Condition 分支和有向环。
3. 选择并配置 Tool
Section titled “3. 选择并配置 Tool”插入 Tool 时会打开可搜索的 Tool Catalog。选择内置、已连接或 MCP 操作。Inspector 使用 Catalog 的 Schema 和默认值提供 Schema 生成的参数控件，然后创建物化的 v1 执行绑定，其中只包含 Endpoint、Tool 名称、可选的凭据引用与模式，以及结构化输入。Workflow Definition 不会存储 Catalog ID 或 Revision、来源输入 Schema、Catalog 默认值或风险元数据。Catalog 后续变化不会静默改写已经物化的绑定。
需要凭据的 Tool 使用服务端管理的 Workspace Connection。创建 Connection 后先测试；必要时轮换 Secret，不再信任时将其删除。如果创建响应丢失，控制台会使用原始幂等键恢复已经创建的 Connection，而不是提交含义不明的重复请求。响应只暴露状态、凭据引用、时间戳和脱敏后的 Capability，绝不会包含 Secret、Ciphertext、IV 或 Encryption Key。
只有 Endpoint 不在 Catalog 中时，才使用 Custom Tool · Advanced。它要求准确的 HTTPS Endpoint、Tool 名称、结构化输入映射和可选的服务端凭据引用。绝不要把 API Key、密码、Cookie、Authorization Header 或 Token 粘贴到 Workflow Definition。
4. 查看或编辑 Definition JSON
Section titled “4. 查看或编辑 Definition JSON”打开 Definition，查看与 Canvas 同步的完整当前权威的编辑器 Definition，其中包括未保存的 Canvas 变更。你可以折叠 Layout、复制 Definition 或下载文件。
选择 Edit JSON 进入安全的文本编辑会话。JSON Draft 打开时，可视化图变更会暂停，但 Canvas 导航和选择仍然可用。Apply JSON 会验证语法、有界结构、Schema、引用、端口和 DAG 语义，通过后才会替换可视化 Definition。无效 JSON 会保留 Draft，并报告 /nodes/2/config 这类路径，绝不会只应用一部分。
如果可视化 Definition 在 JSON 会话之外发生变化，Apply 会保持阻塞并保留两个版本。你可以重新加载当前 Definition，或保留并下载 JSON Draft 后再合并。应用有效 JSON 会生成一个编辑历史条目，因此可以用单步 Undo恢复之前的 Definition。Discard JSON 不会改变可视化 Definition。
5. Save Draft 与 Preview
Section titled “5. Save Draft 与 Preview”Save Draft 会验证并保存可编辑 Definition。保存不会发布，也不会改变当前激活的 Capability Release。Base Revision 过期时会返回冲突，同时浏览器保留本地 Definition，供复制或明确重新加载。
Preview 会运行编辑器当前显示的 Definition，包括未保存的变更。输入 JSON Object，解决所有阻塞 Validation，然后检查并确认本次 Preview 的每个 Tool。Tool 变化或 Retry 后都必须再次确认。结果只包含脱敏的逐节点 Trace；凭据、认证 Header 和提供商响应正文不会出现。
6. 创建 Capability Release
Section titled “6. 创建 Capability Release”Preview 成功后，在 Release Workspace 创建并激活 Capability Release。Release 会冻结经过验证的 Definition、固定的 Single Agent Release 和物化的 Tool 执行绑定。生产环境执行准确的激活 Release，而不是最新 Draft。
通过以下 Endpoint 调用已发布的 Workflow：
POST https://api.agentaab.com/api/app/{business-slug}/workflows/run先阅读运行时客户端指南了解认证与错误处理，再使用运行时 API 参考查看请求和响应 Schema。
Workflow v1 按拓扑顺序确定性执行。v1 不提供有向环、并行调度、嵌套 Workflow、任意 JavaScript、通用自动 Retry 或实时协作编辑。
Skill 管理当前尚未提供。产品没有 Skill Library 或 Skill node；请使用现有 Tool 操作和 Workflow 编排。
Validation 问题指向某个节点或 Edge
Section titled “Validation 问题指向某个节点或 Edge”激活该问题以选中对应图元素。未连接 Draft 在编排时可以暂时存在，但在 Save Draft 或 Preview 前必须连接或移除。
Connection 需要处理
Section titled “Connection 需要处理”打开 Tool，修复或轮换 Workspace Connection，运行测试，再选择刷新后的 Ready Tool。失败测试只暴露稳定错误码，不会显示提供商凭据或原始失败正文。
生产环境仍在运行旧行为
Section titled “生产环境仍在运行旧行为”检查当前激活的 Capability Release。Save Draft 和 Preview 本身不会替换生产行为。