运行和管理子代理委托
在智能体开发服务平台（AgentWorks）中，主智能体关联子代理并更新实例后，应使用实际任务验证委托是否进入预期实例。运行过程中，可以通过后台任务观察状态、取消不再需要的委托，并结合主智能体回答、Playground 子任务流和 Trace 核对结果。
理解 AgentWorks 如何跟踪每次委托
后台任务是 AgentWorks 为一次子代理委托创建的运行记录。它不是智能体角色，也不是另一种智能体资源。
主智能体每发起一次子代理委托，AgentWorks 都会创建一条后台任务，用于记录目标子代理实例、任务状态以及最终结果或错误。委托发出后，主智能体先获得后台任务标识，而不是立即取得子代理结果。
后台任务处于等待中、运行中或等待审批时，相关结果还不能用于完成依赖该结果的工作。任务结束后，AgentWorks 通知主智能体取得结果；主智能体再汇总所需的已完成结果并继续回答。多个彼此独立的任务可以同时处于运行状态。
每个子代理任务独立运行，也不会自动看到其他子代理的后台任务。需要串联多个专业任务时，主智能体取得前一个结果，再把后续任务所需的信息交给相应子代理。
验证和管理实际委托
委托发生后，在 AgentWorks 控制台中查看后台任务和运行记录；需要通过渠道确认模型选择、汇总或审批行为时，再使用测试会话完成对应检查。
监控和取消当前实例发出的子代理委托
智能体实例详情页的 后台任务 列出当前实例作为主智能体发出的子代理委托。这里不列出当前实例作为子代理时接收的委托，也不用于管理子代理委托之外的后台作业。
- 打开发起委托的智能体实例详情页，选择 后台任务。
- 根据任务 ID 或创建时间找到要检查的委托，核对子代理实例 ID、状态、创建时间和完成时间。各状态的含义和处理方式参见理解后台任务状态。
- 如果不再需要处于 等待中、运行中 或 等待审批 的委托，选择 取消。
- 需要核对最终结果或错误时，检查主智能体的回答、Playground 子任务流以及主智能体和子代理实例的 Trace。后台任务列表不显示最终结果正文或完整错误。
通过渠道验证委托
子代理委托使用主智能体所在渠道的运行上下文，目标子代理不需要另外绑定同一渠道。先把主智能体实例接入飞书或 QQ；如果渠道账号绑定的是智能体模板，测试用户先发送 /init 获得专属实例。
使用固定输入验证以下委托结果：
- 任务不需要子代理：主智能体直接回答，不创建 后台任务。
- 任务只属于一个子代理：只创建对应实例的后台任务。任务完成后，主智能体使用子代理结果回答。
- 任务可以拆给多个子代理：为预期实例分别创建后台任务。主智能体等待必要结果并完成汇总。
- 子代理请求审批或执行失败：后台任务显示对应状态。主智能体在审批完成或取得终态后继续，不把未完成结果当作成功结果。
每次测试都应核对后台任务中的任务 ID、子代理实例 ID、状态和时间，并检查主智能体的最终回答是否实际使用了子代理结果。需要进一步定位结果或错误时，查看 Playground 子任务流以及主智能体和子代理实例的 Trace。
处理子代理的确认审批
子代理在执行需要用户确认的工具操作前，会暂停运行并等待批准。后台任务页只显示委托是否正在等待审批，不能在这里批准或拒绝。
如果任务来自飞书渠道，AgentWorks 会把审批卡片发送到主智能体所在会话，也就是触发此次委托的飞书会话。子代理不会另外创建一个飞书会话；对应后台任务显示为 等待审批。
- 回到触发此次委托的主智能体飞书会话，核对审批卡片中的操作和参数。
- 选择 ✅ 允许、⭐ 加白执行 或 ❌ 拒绝。允许前确认操作符合当前用户权限和业务规则。
- 回到智能体实例的 后台任务，确认任务从 等待审批 恢复运行或结束。
- 等待主智能体取得子代理结果并完成回复，再检查相关 Trace。
这里处理的是子代理发出的确认型审批。用户工具包产生的工具中断仍需通过 Invoke API 或 WebSocket 接入的业务系统返回 RESPOND 或 ERROR。通过渠道运行的子代理需要在 AgentWorks 内执行工具时，应使用平台工具包、MCP 或沙箱。
理解后台任务状态
后台任务状态用于判断委托正在等待、运行、等待审批还是已经结束。
| 状态 | 含义和处理 |
|---|---|
| 等待中 | 委托已创建，等待子代理开始执行；等待状态变化，不要立即重复提交同一任务 |
| 运行中 | 子代理正在执行；等待完成后再判断是否需要重试 |
| 等待审批 | 子代理运行需要批准；在飞书会话中核对并处理审批卡片，再继续观察任务 |
| 已完成 | 子代理已返回结果；确认主智能体实际使用了该结果 |
| 失败 | 直接测试目标子代理实例，并检查其 Trace、凭证和插件 |
| 已取消 | 任务不会继续等待结果；根据业务需要重新发起新任务 |
后台任务列表用于确认委托已经发生并观察状态；它不显示最终结果正文或完整错误。要验证最终结果，还应核对主智能体的回答、Playground 子任务流和相关 Trace。
排查子代理委托
先根据问题发生在目标选择、任务传递、子代理执行还是结果汇总阶段，检查对应配置。
- 没有后台任务：确认主智能体模板保存了 子代理 关联、主智能体实例已更新；再检查子代理名称和描述是否明确，以及主智能体系统提示词是否说明何时委托。
- 委托给错误的子代理：检查多个子代理的名称或描述是否过于相似、职责范围是否重叠；修改后重新执行容易混淆的边界输入测试。
- 选择了正确子代理，但收到的任务缺少必要信息：在主智能体系统提示词中说明委托时需要传递的输入和上下文，再核对测试输入和子代理收到的任务。
- 提示主智能体实例未初始化：模板绑定渠道用户先发送
/init。 - 长时间处于等待中或运行中：先检查目标子代理实例是否可以直接运行，再查看相关 Trace 和后台任务状态；不要连续重复提交。
- 处于等待审批：在主智能体所在飞书会话中查找审批卡片，处理后再确认任务是否继续。
- 选择正确，但子代理无法完成任务：直接调用目标子代理实例复现问题，检查其模型、系统提示词、插件、权限、凭证和输入是否有效；名称和描述不能代替这些实际配置。
- 目标实例单独测试正常，但委托持续运行：检查目标实例是否调用了用户工具包；需要在 AgentWorks 内完成的操作应改用平台工具包、MCP 或沙箱。
- 委托成功但最终回答未使用结果：在主智能体系统提示词中说明需要等待哪些结果以及如何汇总，并重新执行固定测试。
名称、描述和委托规则的设计方法参见设计并关联子代理。