跳到正文
heng-agent v0.5.0
Esc
使用指南目录

进阶

子智能体

模型把调研类的事交给子智能体去做,只把结论带回来,主对话不被中间过程挤满;最多 4 个并行,可以放到后台;子智能体面板里随时看它在做什么;自定义「测试员」「审查员」这类角色。

预计用时
约 5 分钟
适用版本
v0.5.0 及以上

它什么时候派子智能体

在大项目里找相关代码、梳理调用关系这类调研 / 探索的事,模型会用 task 工具交给子智能体:子智能体独立搜索阅读,只把结论带回来。你不用专门吩咐,想让它多派几个也可以直说:

分头查一下:登录、注册、找回密码三个接口各自是怎么校验参数的
  • 同一轮发出多个会并行执行(最多 4 个);
  • 默认的子智能体只读(读文件、找文件、搜内容),不能改文件、跑命令,也不能再派子智能体;要改代码由主智能体来做;
  • 只读子智能体同样守你的拒绝规则,被拒绝读的文件它也读不了。

放到后台:不等结论接着干

不急着用结论的调研,模型可以放到后台(run_in_background),派出去马上接着干别的。它做完时:

  • 主智能体正在回答:在这批工具跑完时把结论插进去;
  • 主智能体空闲:自动发起一问把结论交给它,显示成一行「◆ 后台子智能体 #1「…」做完了」,你框里敲了一半的字留着。

主对话按 ESC 打断不会把后台的子智能体停掉。

看它在做什么:子智能体面板

有子智能体在跑时,状态栏下面列出 ● main 和每个子智能体(任务、用时、token、是否后台):

  • 在输入框最后一行按 ↓ 选中一个;
  • Enter 看它到现在为止读了哪些、搜了什么、写了什么;
  • ESC 回到输入框。

自定义角色

在 .heng-agent/agents/名字.md(项目)或 ~/.heng-agent/agents/(用户)定义「测试员」「审查员」这类角色。开头写 description(模型据此挑)与 tools(不写就是只读),正文是它的提示词:

---
description: 测试员。改完代码后用它跑测试、分析失败原因(不修改业务代码)
tools: read_file, glob, grep, bash
---
你负责跑测试并分析失败原因。先跑与改动相关的测试,失败时定位到具体断言,给出可能的原因和修改建议。
  • 只读角色不用确认、可以并行;带 write_file / edit_file / bash 的角色按你的权限模式确认、不并行,它改的文件能 /undo;
  • /agents 一行一个角色地列出(名字 · 只读 / 会改动 · 来源 · 一句话说明),方向键选一个看完整说明;/agents 名字 直接看;
  • /agents new 名字 建好模板并打开编辑器,存好马上生效。

.claude/agents/ 里写给 Claude Code 的角色也直接能用,工具名自动对应,见 兼容 Claude Code。

做完是这样

它派出的子智能体出现在状态栏下面的面板里,↓ 选中、Enter 能看到它读了什么;做完后主对话只多了一段结论。/agents 里能看到你定义的角色。

最后更新: