了解子代理和动态委托
在智能体开发服务平台（AgentWorks）中，子代理是一个以受委托角色运行的已有智能体实例。构建者在主智能体模板中通过 子代理 关联这个实例；运行时，主智能体的模型决定是否委托，并在取得所需结果后继续回答用户。
理解主智能体和子代理的关系
主智能体和子代理都是智能体实例。这两个名称表示智能体实例在当前委托关系中承担的不同角色，不是不同的资源类型。
| 角色 | 在委托关系中的职责 |
|---|---|
| 主智能体 | 接收原始请求、判断是否委托，并在取得所需结果后组织最终回答 |
| 子代理 | 使用自己的模型、提示词和能力，执行主智能体委托的专业任务 |
把一个智能体实例添加为子代理，不会创建新实例，也不会改变原来的实例。你仍然可以单独运行和测试它；当另一个智能体把任务交给它时，它才作为子代理运行。
把智能体实例作为子代理使用，不要求它绑定飞书、QQ 或 WebSocket 渠道。渠道只在用户需要直接向这个实例发送消息时配置；主智能体委托任务和取得结果不依赖目标实例自己的渠道。
主智能体会根据当前任务决定是否把工作交给子代理。子代理完成任务后，AgentWorks 把结果交回主智能体，再由主智能体整理并回复用户。子代理不会一直在后台等待任务，也不会直接接管主智能体与用户的对话。
了解主智能体如何认识子代理
主智能体不会先检查或试运行一个子代理，再决定是否委托。建立关联后，AgentWorks 会在运行时向主智能体提供每个子代理的名称和描述。
主智能体结合以下信息判断是否委托：
- 当前用户请求；
- 主智能体自身的系统提示词；
- 已关联子代理的名称和描述。
| 主智能体可以用于判断的信息 | 主智能体不会自动读取的信息 |
|---|---|
| 当前用户请求 | 子代理的完整系统提示词 |
| 主智能体系统提示词 | 子代理使用的模型、插件和工具 |
| 子代理名称和描述 | 子代理的凭证、权限和测试结果 |
| 子代理返回的任务结果 | 构建者对实例可靠性的内部判断 |
子代理的实际配置决定它能完成哪些任务，但不会代替名称和描述向主智能体说明职责。因此，名称和描述是主智能体选择委托目标时使用的能力说明，不是对子代理能力的自动检查，也不是权限控制。写法和验证方法参见设计并关联子代理。
判断是否适合使用子代理
根据任务是否需要独立能力、动态分工或固定流程控制，选择单个智能体、子代理或可选的外部编排。
| 需要的结果 | 适合的方式 |
|---|---|
| 同一套指令、上下文和能力可以完成整个任务 | 在一个智能体中使用模型和工具 |
| 一部分工作需要独立的提示词、模型或能力，或者多个专业任务可以彼此独立地执行 | 让主智能体按需委托一个或多个子代理 |
| 需要预先规定节点顺序、条件分支、重试、循环或终止条件 | 在 AgentWorks 之外使用编排系统，并按需调用智能体实例 |
使用子代理时，主智能体负责判断是否委托和怎样汇总，目标智能体实例负责完成受委托任务。需要固定流程控制时，参见区分平台单次运行和可选的外部编排。
理解模型驱动的动态委托
添加子代理关联后，主智能体的模型在每次运行中根据当前输入、系统提示词以及子代理的名称和描述重新判断是否委托。下图展示可能发生的运行行为，不表示 AgentWorks 管理控制台提供可以编辑的固定工作流。
添加关联不表示每次运行都会调用子代理。模型决定是否委托以及如何使用返回结果；AgentWorks 创建和更新每次委托的后台任务，并把结果交回主智能体。
区分子代理、可选的外部编排和工具调用
以下三种方式都可能把工作交给另一个执行方，但控制位置、目标对象和下一步由谁决定并不相同。
| 方式 | 控制位置 | 下一步由谁决定 | 适用情况 |
|---|---|---|---|
| 子代理 | AgentWorks 的一次平台运行中 | 主智能体的模型根据提示词、用户输入以及子代理名称和描述决定是否委托 | 动态选择专业智能体，并异步取得结果 |
| 外部编排（可选） | AgentWorks 之外；通常通过 Invoke API 调用智能体实例 | 业务应用或编排系统按照固定状态和规则决定下一步 | 精确控制顺序、分支、并行、重试和终止条件 |
| MCP | AgentWorks 发起调用，外部 MCP Server 执行工具 | 主智能体的模型选择工具，MCP Server 执行具体能力 | 调用工具、API 或数据资源，而不是委托给另一个智能体实例 |
子代理 关联选择的是已经存在的 AgentWorks 智能体实例。需要组合独立部署的外部智能体时，在外部系统中保留协调逻辑，并通过目标部署提供的 Invoke API 调用 AgentWorks；需要双向长连接时，可以使用 WebSocket。相关接口边界参见选择业务系统接入方式。
了解每次委托如何运行
一次子代理委托通常经过以下过程：
- 主智能体的模型选择目标子代理并发出任务。
- AgentWorks 创建一条后台任务，记录目标实例和任务状态。
- 子代理完成任务、等待审批、失败或被取消后，AgentWorks 更新后台任务。
- 主智能体取得可用结果并继续组织回答。
智能体实例详情页的 后台任务 用于查看当前实例发出的子代理委托。它显示任务标识、目标子代理实例、状态、时间和取消操作；最终结果和完整错误需要结合主智能体回答、Playground 子任务流和相关 Trace 核对。完整操作参见运行和管理子代理委托。
先设计适合委托的子代理
子代理选择器会列出已有智能体实例，但能够被选择不表示该实例已经适合承担目标任务。为了让委托结果更稳定，建议先围绕预期任务设计和验证目标智能体实例，再把它关联到主智能体。
如果某个已有实例已经具备清晰的职责、稳定的输入和输出、所需能力以及明确边界，可以直接复用。重点不是必须新建实例，而是关联前确认它已经为这类委托做好准备。
- 要明确职责、选择复用或新建实例并完成关联，参见设计并关联子代理。
- 要验证实际委托、查看后台任务、处理审批或排查失败，参见运行和管理子代理委托。