Skip to content

子智能体

子智能体(Sub-agent)是由主 Agent 派生出来的专项 Agent——主 Agent 在处理复杂任务时,可以将某个子任务交给子智能体独立执行,子任务完成后结果汇总回主流程。

相关基础:对话面板 → 子 Agent 子卡片

一个类比

可以把它想象成:AI 面对一个大工程时,自动雇了几位「专项小助手」分头干活——有人专门查资料、有人专门改代码——各自干完后向主 AI 汇报结果,主 AI 再汇总推进。


对话中的子智能体卡片

这是什么

每当主 Agent 派生一个子智能体,对话区会出现一张折叠子卡片,将子智能体的完整对话过程封装在其中。

怎么看

子卡片的标题行显示子任务的基本信息与运行状态:

  • 运行中:标题右侧出现三点滚动动效(···),表示子 Agent 正在工作
  • 已完成:状态图标变为灰色对勾(✓)
  • 出错:状态图标变为红色叉号(✗)

子卡片默认折叠,点击标题行(或按 Enter / Space)可展开查看子 Agent 的完整输出,再次点击收起。展开后可以看到:

  • 子任务的提示摘要(来自发送给子 Agent 的 prompt)
  • 子 Agent 产生的 thinking 块、回复内容与工具调用

若子 Agent 尚未产生任何输出,展开后会显示占位提示「等待子 Agent 输出…」。

截图:对话面板中一张子 Agent 子卡片处于折叠状态,标题行显示运行中三点动效;右侧箭头图标提示可展开


设置 → 子智能体

这是什么

设置 → 子智能体页面是自定义子智能体的可视化管理中心,你可以在这里新建、编辑、启用/禁用、删除用户级和项目级子智能体,也可以查看插件提供的子智能体。

子智能体按作用域分为三类:

标签含义
用户跨项目可用,存储在用户配置目录
项目仅当前工作区可用(需有活动工作区)
Plugin(界面原文)由插件提供,因此只读,需在插件侧修改

在哪里打开

设置(右上角齿轮图标)→ 左侧导航 → 子智能体

新建子智能体

  1. 点击右上角新建子智能体按钮,打开新建表单。

  2. 填写以下字段:

    字段说明
    名称只能包含字母、数字和连字符,长度 3–50 个字符
    颜色子智能体标识颜色(可选)
    作用域用户 / 项目(选项取决于是否有活动工作区)
    描述简要说明该子智能体的用途
    系统提示词指导子智能体行为的核心指令
    工具允许该子智能体使用的工具分组;不选则不限制,继承全部工具
    模型下拉选择,选项有 inherit、opus、sonnet、haiku;选 inherit 表示继承当前会话模型(选择器下方有提示「inherit 继承当前会话模型」)
  3. 填写完成后点击保存,页面自动返回列表,新建的子智能体出现在列表中并提示「已新建 {name}」。

编辑子智能体

  1. 在列表中找到目标子智能体,点击进入详情。
  2. 详情页显示名称、描述、系统提示词、作用域、状态、模型、工具、文件路径等所有字段。
  3. 点击编辑进入编辑表单,修改后保存即可,提示「已保存 {name}」。

启用 / 禁用

在列表中切换每条子智能体右侧的开关,状态立即变为已启用已禁用。被禁用的子智能体不会被主 Agent 调用。

删除子智能体

在详情页点击删除,弹出确认对话框:

「确定删除「{name}」?文件将移入回收站。」

确认后文件移入系统回收站,列表刷新并提示「已删除 {name}」。

项目级子智能体需有活动工作区

新建「项目」作用域的子智能体时,需要先在主界面打开一个工作区,否则选项置灰并提示「需有活动工作区」。


下一步

了解子智能体之后,可以继续了解 LoongCode 的权限体系,前往权限管理继续学习。