编排型智能体

什么时候用

当你需要让一个主智能体协调多个子智能体完成复杂任务时——编排型智能体适合：

• 多步骤工作流（如：先写代码再写文档）
• 按场景分配合适的子智能体（如：售前咨询转售后支持）
• 需要多个专业智能体协作的场景

注意： 当前版本仅支持顺序执行模式，智能委派和并行执行在 UI 中已禁用。

你需要准备

• 至少一个已创建好的独立型智能体（作为子智能体，编排型智能体不能把自己设为子智能体）
• 明确工作流的顺序和每个子智能体的职责
• 准备好编排型的 System Prompt，明确委派原则

操作步骤

第 1 步：进入创建流程

左侧菜单 -> 智能体管理 -> 我的智能体 -> 点击「新增智能体」。

第 2 步：填写基础信息并选择类型

在「基础信息」步骤中：

1. 填写智能体名称、描述、System Prompt、模型等信息（参考：创建并配置智能体）
2. 在「智能体类型」下拉框中选择「编排」
3. 点击「下一步」继续

编排型 System Prompt 提示：

• 明确智能体定位（是协调者，不是执行者）
• 说明委派原则（什么时候调哪个子智能体）
• 定义输出格式
• 避免：亲自执行子智能体的任务

第 3 步：关联技能（可选）

这一步与独立型智能体相同，可以为编排型智能体绑定技能（或不绑定直接下一步）。

第 4 步：编排配置（编排型特有）

选择编排类型后，步骤导航会多出「编排配置」这一步。

配置说明：

添加子智能体：

1. 点击「添加子智能体」按钮
2. 在弹窗中选择一个独立型智能体作为子智能体（不能选自己）
3. 填写以下信息：

4. 点击「确认」添加到列表

可以添加多个子智能体，它们会按列表顺序依次执行。也可以编辑或删除已添加的子智能体。

第 5 步：配置关键词匹配（可选）

这一步与独立型智能体相同，可以配置自动触发规则（或不配置直接保存）。

第 6 步：保存

点击「保存」完成创建，编排型智能体将出现在「我的智能体」列表中。

怎么验证成功了

1. 在「我的智能体」列表中找到新创建的编排型智能体
2. 点击「编辑」，确认「编排配置」步骤存在且配置完整
3. 检查子智能体列表是否正确
4. 为该智能体分配用户并创建 API Key，用 OpenAI SDK 调用，观察是否按顺序调用子智能体

常见问题

删除编排型智能体会影响子智能体吗

会。删除主智能体时，系统会一并删除其下属子智能体的关联关系。如果某个子智能体被多个编排共享，删除时要特别小心。

子智能体别名重复会怎样

同一编排内子智能体别名不能重复。保存时如果有重复别名，会返回校验错误，请修改别名后重试。

编排型智能体能把自己设为子智能体吗

不能。在添加子智能体时，列表会自动排除当前正在编辑的智能体，防止递归调用。

当前版本支持并行执行吗

不支持。当前版本仅支持「顺序执行」模式，子智能体按配置列表顺序依次执行。「智能委派」和「并行执行」在 UI 中已禁用，后续版本会开放。

编排型智能体 Temperature 设多少合适

编排型智能体需要精确决策，建议设为 0.1~0.3（表单中有提示）。

深入

编排型 Agent 详解

编排型 Agent 可以将复杂任务拆解为多个子任务，分发给不同的子 Agent 执行。创建编排型 Agent 时必须：

1. 设置 agent_type = orchestrator
2. 填写 orchestration_config，包含以下内容：
   • workers：非空列表，每个 worker 必须包含：
     • agent_id：子 Agent 的 ID
     • alias：子 Agent 的别名（同一编排内不能重复）
     • description：子 Agent 的任务描述
   • parallel_mode / strategy：只能取以下值之一——auto、sequential、parallel_only、parallel

校验规则

创建编排型 Agent 时后端会校验：

1. workers 不能为空（非空列表）
2. 每个 worker 必须有 agent_id、alias、description 三个字段
3. alias 在同一个编排内不能重复
4. parallel_mode / strategy 只能是：auto、sequential、parallel_only、parallel

路由策略说明

权限边界

常见坑

• 编排型 Agent 的校验比较严格：创建编排型 Agent 时，如果 orchestration_config 格式不对、workers 为空、alias 重复等，都会返回 422
• 删除编排型 Agent 会自动删除子 Agent：这是一个向上级联删除（删除父 Agent 时连带删除子 Agent）

排错速查

• 想先创建独立型智能体作为子智能体？参考：创建并配置智能体
• 想从市场克隆编排型智能体？参考：从市场克隆智能体