💡 前言:小白友好说明!本文全程避开复杂术语,每一步操作都配“通俗解释+具体命令+注意事项”,哪怕你是第一次用Hermes Agent,跟着做也能轻松上手。核心重点:多Agent靠「Profile隔离」实现独立工作,多Agent协作靠「Kanban看板」实现任务分配和跟踪,短任务用简单命令,长任务/多Agent配合必须用Kanban,全程无难点,耐心看完就能会!

一、先搞懂核心概念(小白必看)🤔
在开始操作前,先明确2个关键名词,避免后续 confusion:
- Agent(智能体):可以理解为“一个专属小助手”,每个小助手有自己的“人设”“技能”和“记忆”,比如“研究员小助手”只会做调研,“编码小助手”只会写代码,互不干扰。
- Profile(配置文件):就是“小助手的身份证+说明书”,每个Agent对应一个Profile,里面存着小助手的人设、技能、工具权限,我们创建多个Profile,就相当于创建了多个不同的小助手。
- Kanban(看板):可以理解为“多Agent的任务调度台”,相当于一个可视化的“任务板”,我们把要做的任务写在上面,分配给对应的小助手,还能实时看到任务进度(比如“待做”“正在做”“已完成”),解决多个小助手“分工混乱、不知道谁做什么、做了多少”的问题。
补充:v0.13.0版本中,多Agent协作有2种方式——短任务用「delegate_task命令」(简单直接,小助手做完马上反馈),长任务/多Agent配合用「Kanban看板」(持久化保存任务,不怕重启丢失,还能跟踪进度),小白重点学Kanban,通用性更强!
二、多Agent创建与隔离(Profile机制,小白分步操作)👥
核心逻辑:每个小助手(Agent)对应一个Profile,我们通过“创建Profile”来创建Agent,通过“切换Profile”来使用不同的小助手,操作全靠终端命令,复制粘贴就能执行!
1. 前提准备(必做)✅
确保你的电脑已经安装好 Hermes Agent v0.13.0 版本,打开终端(Windows用CMD/PowerShell,Mac/Linux用终端),输入以下命令,确认版本正确(出现v0.13.0即成功):
hermes --version
❌ 小白踩坑点:如果提示“hermes不是内部或外部命令”,说明没安装好,先重新安装对应版本,再继续操作。
2. 创建多个Agent(两种方式,选一种即可)📥
我们以“创建3个常用小助手”为例(研究员、编码员、撰稿人),全程复制命令,粘贴到终端执行,每执行一条命令,终端会提示“success”,说明创建成功。
方式1:从零创建(推荐小白,空配置,后续可自定义人设)
# 创建“研究员”Agent(负责调研、找资料)
hermes profile create researcher
# 创建“编码员”Agent(负责写代码、做开发)
hermes profile create coder
# 创建“撰稿人”Agent(负责写报告、整理文字)
hermes profile create writer
方式2:从当前配置克隆(适合想快速创建“相似小助手”的场景)
比如你已经有一个“coder”Agent,想再创建一个“coder2”,继承coder的环境配置(但记忆、会话独立),执行:
hermes profile create coder2 --clone
✅ 通俗解释:克隆相当于“复制一个同款小助手”,但两个小助手各自工作,不会互相干扰(比如coder写的代码,coder2看不到)。
3. 管理与切换Profile(使用不同的小助手)🔄
创建好多个Agent后,我们需要“切换”到对应的小助手,才能使用它的功能,以下命令全是高频操作,记好这4条就够了:
- 查看所有已创建的Agent(看看自己创建了哪些小助手,带◆的是当前正在使用的):
hermes profile list执行后,终端会显示类似内容(◆代表当前激活的Agent):◆ researcher (default)coderwriter - 临时切换Agent(比如当前用的是researcher,想临时用coder聊一句,不改变默认设置):
hermes -p coder chat✅ 通俗解释:-p 就是“指定Profile”,这句话的意思是“让coder小助手来和我聊天”,退出聊天后,还是会回到默认的Agent。 - 设置默认Agent(比如想长期用coder,不用每次都临时切换):
hermes profile use coder执行后,再用“hermes profile list”查看,会发现◆跑到coder前面,说明默认Agent已经切换成功。 - 直接用别名启动Agent(更快捷,不用输长命令): 创建Profile后,系统会自动生成别名,比如创建了researcher,直接输入以下命令就能启动:
researcher chat同理,coder chat、writer chat 都能直接启动对应的Agent,小白首选这种方式,更省事!
4. 配置Agent人设(让小助手更“专业”,小白必做)🎯
创建好的Agent默认是“空白人设”,我们需要给它定义“身份和技能”,让它知道自己该做什么、不该做什么,这一步通过编辑「soul.md」文件实现(每个Profile都有独立的soul.md)。
操作步骤:
- 打开终端,输入命令,编辑对应Agent的soul.md文件(以researcher为例):
vim ~/.hermes/profiles/researcher/soul.md✅ 通俗解释:vim是终端的编辑工具,这句话的意思是“打开researcher小助手的人设文件”,输入后会进入编辑界面。 - 进入编辑界面后,按「i」键进入“输入模式”,粘贴以下示例内容(可根据需求修改,≤400字):
你是资深行业研究员,擅长全网信息搜集、竞品分析、数据整理;可使用工具:web_search(网页搜索)、web_fetch(网页内容抓取)、file_read(读取文件);工作规则:不做主观结论,只输出结构化的原始素材,方便后续分析使用。 - 编辑完成后,按「Esc」键退出输入模式,再输入「:wq」(冒号+wq),按回车保存并退出编辑界面。
- 同理,给coder、writer也配置人设(复制命令,替换Profile名即可):
# 编辑coder的人设vim ~/.hermes/profiles/coder/soul.md# 编辑writer的人设vim ~/.hermes/profiles/writer/soul.md示例人设参考:- coder:你是资深后端开发工程师,擅长Python、Java编码,能根据需求实现API接口、设计数据库;工具:code_generate、file_write;只输出可直接运行的代码,附带简单注释。
- writer:你是专业撰稿人,擅长将复杂内容整理成结构化报告,语言简洁、逻辑清晰;工具:file_write、text_edit;能根据原始素材,输出排版规范、重点突出的文档。
❌ 小白踩坑点:编辑完一定要按「Esc」+「:wq」保存,否则编辑的内容会丢失;如果不小心输错,按「Esc」+「:q!」退出,不保存修改,重新编辑即可。
三、Kanban详解(小白必懂:是什么+为什么用)📋
很多小白会疑惑:“我已经创建了多个Agent,直接让它们各自干活不就行了,为什么还要用Kanban?” 这里先把逻辑讲透,再教操作,避免只会用、不会懂。
1. Kanban是什么?
Kanban是Hermes Agent v0.13.0 新增的「持久化多Agent任务看板」,本质是一个“可视化的任务管理工具”,基于SQLite数据库存储(简单说就是“把任务存在电脑里”),哪怕重启电脑、重启Hermes,任务也不会丢失。
可以把它想象成“办公室的任务白板”:
- 白板上有多个“列”(比如“待做”“正在做”“已完成”);
- 我们把要做的任务写成“卡片”,贴在对应的列里;
- 给每个任务分配一个“负责人”(就是我们创建的Agent);
- 任务完成后,把卡片从“正在做”移到“已完成”,所有人都能看到进度。
2. 为什么要用Kanban?(对比delegate_task)
小白不用记复杂原理,记住以下2点,就能判断什么时候用哪种方式:
| 方式 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| delegate_task(命令) | 短任务、简单任务(比如“查一个数据”“写一段简单代码”) | 操作简单、同步反馈(小助手做完马上告诉你结果) | 不能跟踪进度、任务不持久(重启就丢)、不适合多Agent配合 |
| Kanban(看板) | 长任务、复杂任务、多Agent协作(比如“完成一份AI行业报告”) | 可视化进度、任务持久化、支持任务依赖、可多人/多Agent协作 | 需要多几步初始化操作(但小白跟着做也能快速完成) |
💡 小白总结:只要涉及“多个Agent一起干活”或者“任务需要做很久、怕丢失”,就用Kanban;单个小助手做个简单任务,用delegate_task即可(本文重点讲Kanban,因为它是多Agent协作的核心)。
3. Kanban默认6列(必懂,对应任务状态)
看板默认有6个列,每个列对应任务的不同状态,小白不用修改,记住每个列的作用即可:
- 📥 Triage:原始想法列,比如你突然想到“要做一份行业报告”,先把这个想法贴在这里,后续再细化成具体任务。
- 📝 Todo:待分配列,已经细化好的任务,还没分配给Agent,或者任务有依赖(比如要等另一个任务做完才能做)。
- ✅ Ready:就绪列,任务已经分配好Agent,且没有依赖,等待系统调度执行。
- 🔄 In Progress:执行列,Agent正在处理这个任务,小白可以在这里看到“谁在做什么”。
- ⚠️ Blocked:阻塞列,任务卡住了(比如缺少资料、Agent执行失败),需要人工或其他Agent解决后,才能继续。
- ✅ Done:完成列,任务已经做完,Agent输出了结果,可随时查看。
4. Kanban的可靠性保障(小白不用操作,了解即可)
v0.13.0的Kanban有7重保障,不用担心任务丢失、Agent偷懒的问题:
- 心跳检测+超时回收:Agent长时间不干活,系统会自动回收,避免资源浪费;
- 僵尸进程清理:Agent崩溃后,系统会自动清理,不影响其他任务;
- 重试上限:任务执行失败,会自动重试(可设置次数),不用人工重新提交;
- 未完成退出阻塞:Agent退出时,未完成的任务会自动移到Blocked列,避免丢失;
- 幻觉结果拦截:Agent输出错误/无效结果,系统会拦截,不让任务进入Done列;
- 工具所有权检查:避免Agent使用没有权限的工具(比如researcher用编码工具);
- 崩溃重启不丢数据:任务存在本地数据库,重启电脑也不会丢失,可追溯。
四、Kanban快速使用(小白5分钟上手,分步操作)🚀
核心流程:初始化看板 → 启动网关 → 创建任务 → 查看监控 → 调度执行 → 查看结果,全程复制命令,粘贴执行,每一步都有提示,不用担心出错。
1. 初始化看板(必做,创建任务数据库)
第一次使用Kanban,需要先创建一个“任务数据库”(kanban.db),用来存储所有任务,执行以下命令:
hermes kanban init
✅ 执行后,终端提示“success”,说明初始化成功,数据库文件会自动存在「~/.hermes/kanban.db」(不用管这个路径,系统会自动识别)。
❌ 小白踩坑点:不要重复执行这个命令,重复执行会覆盖数据库,导致之前的任务丢失。
2. 启动网关(必做,任务调度核心)
网关(Gateway)相当于“Kanban的大脑”,负责把Ready列的任务分配给空闲的Agent,启动后才能进行任务调度,执行命令:
hermes gateway start
✅ 执行后,终端会显示“Gateway started”,说明启动成功,这个终端窗口不要关闭(关闭会导致网关停止,任务无法调度),可以再打开一个新的终端窗口,进行后续操作。
3. 创建任务(核心操作,给Agent分配活)
创建任务就是“在看板上贴任务卡片”,需要指定“任务标题”“负责人(Agent)”,可选“任务详情”“优先级”“依赖任务”,以下是3种常用场景,小白按需选择:
场景1:基础创建(只指定标题和负责人,最简单)
比如让researcher小助手调研“2026年AI融资趋势”,执行命令:
hermes kanban create "调研2026年AI融资趋势" --assignee researcher
✅ 解释:–assignee 后面跟的是Profile名(即Agent名),表示“这个任务分配给researcher做”,执行后会返回任务ID(一串数字,不用记,后续查看用)。
场景2:带详情+优先级(任务更明确,推荐)
比如让writer小助手基于调研结果,写一份行业报告,指定优先级(1最高,5最低),执行命令:
hermes kanban create "编写2026年AI行业报告" \
--assignee writer \
--body "基于researcher的调研结果,输出3页结构化报告,包含融资数据、行业趋势、核心结论,语言简洁,重点突出" \
--priority 2
✅ 解释:\ 是换行符,方便查看命令;–body 后面是任务详情,让Agent知道具体要做什么;–priority 2 表示优先级中等,系统会优先调度优先级高的任务。
场景3:创建依赖任务(多Agent协作核心,必学)
比如“实现API接口”这个任务,必须等“设计数据库Schema”做完才能做,就需要设置“依赖任务”,执行步骤:
- 先创建父任务(设计数据库Schema),并获取任务ID:
schema_id=$(hermes kanban create "设计数据库Schema" --assignee coder --json | jq -r .id)✅ 解释:–json 表示返回JSON格式的任务信息,jq -r .id 表示提取任务ID,并赋值给schema_id(相当于把任务ID存起来,方便后续使用)。 - 再创建子任务(实现API接口),指定依赖父任务:
hermes kanban create "实现API接口" --assignee coder --parent $schema_id✅ 解释:–parent $schema_id 表示“这个任务依赖于父任务(ID为schema_id)”,只有父任务完成(移到Done列),子任务才会自动从Todo列移到Ready列,等待调度执行。
❌ 小白踩坑点:创建依赖任务时,父任务必须先创建,且父任务的负责人可以和子任务一样(比如都给coder),也可以不一样(比如父任务给coder,子任务给另一个Agent)。
4. 查看与监控看板(实时掌握任务进度)
任务创建后,我们需要查看任务进度、监控任务流转,以下4条命令是小白高频使用,记好:
- 查看所有任务(了解所有任务的状态):
hermes kanban list执行后,会显示所有任务的ID、标题、负责人、状态、优先级,一目了然。 - 实时监控任务流转(动态刷新,推荐):
hermes kanban watch执行后,终端会动态刷新任务状态,比如Agent开始执行任务,会看到任务从Ready列移到In Progress列;任务完成,会移到Done列,不用手动刷新。✅ 退出监控:按「Ctrl+C」即可退出。 - 统计看板(查看任务完成情况):
hermes kanban stats执行后,会显示任务总数、各状态任务数、完成率、阻塞数等,方便了解整体进度。 - 查看单个任务详情(了解任务具体信息):
hermes kanban show <task-id>✅ 替换为具体的任务ID(创建任务时返回的数字),比如:hermes kanban show 123执行后,会显示任务的详细信息,包括标题、负责人、详情、依赖任务、执行记录等。
5. 调度执行(让Agent开始干活,核心步骤)
任务创建好、网关启动后,需要手动调度,让系统把Ready列的任务分配给空闲的Agent,执行以下命令:
- 试运行(预览调度计划,不实际执行,小白推荐先试这个):
hermes kanban dispatch --dry-run执行后,终端会显示“哪些任务会分配给哪个Agent”,确认无误后,再执行正式调度。 - 正式调度(让Agent开始执行任务):
hermes kanban dispatch执行后,系统会自动把Ready列的任务分配给对应的Agent,Agent开始干活,此时用“hermes kanban watch”可以看到任务状态变化。 - 定时自动调度(多Agent长期协作,推荐): 如果任务较多,不想每次手动调度,可以设置“每分钟自动调度一次”,执行命令:
hermes cron add --schedule "*/1 * * * *" \--name kanban-dispatch \hermes kanban dispatch✅ 解释:/1 * * * 表示“每分钟执行一次”;–name 是定时任务的名字(可自定义),设置后,系统会每分钟自动调度一次,不用手动操作。
6. GUI看板(浏览器可视化操作,小白首选)
如果觉得终端操作太麻烦,小白可以用GUI看板(浏览器界面,拖拽式操作),执行命令:
hermes dashboard
执行后,终端会显示一个链接(比如http://localhost:8080),复制这个链接,粘贴到浏览器打开,就能看到可视化的看板:
- 可以用鼠标拖拽任务卡片,在不同列之间移动(比如把Todo列的任务拖到Ready列);
- 可以直接点击任务卡片,编辑任务详情、负责人、优先级;
- 可以直观看到每个Agent的任务负载,操作和我们平时用的任务管理工具一样,非常简单。
❌ 小白踩坑点:打开GUI看板前,必须先启动网关(hermes gateway start),否则浏览器无法访问。
五、多Agent协作实战(小白手把手演练,必做)📝
结合前面的内容,我们用“完成一份2026年AI行业报告”为例,演示3个Agent(researcher、analyst、writer)分工协作的完整流程,小白跟着做,就能掌握多Agent+Kanban的核心用法。
实战目标
3个Agent分工协作:researcher调研数据 → analyst分析数据 → writer撰写报告,通过Kanban设置任务依赖,实现自动流转,最终完成报告。
分步操作(全程复制命令,粘贴执行)
- 创建3个Agent(Profile),并配置人设(前面讲过,这里简化命令):
# 创建3个Agenthermes profile create researcherhermes profile create analysthermes profile create writer# 配置人设(可参考前面的示例,这里省略编辑步骤,直接使用)# 记得按前面的方法,给3个Agent分别编辑soul.md文件,定义技能和人设 - 初始化Kanban并启动网关:
# 初始化看板(只执行一次)hermes kanban init# 启动网关(新终端窗口执行,不要关闭)hermes gateway start - 创建任务链(带依赖,实现分工协作):
# 任务1:调研(researcher,父任务)t1=$(hermes kanban create "调研2026年AI行业核心数据" --assignee researcher --body "搜集2026年AI行业融资数据、主流企业动态、技术趋势,输出结构化素材" --priority 1 --json | jq -r .id)# 任务2:分析(analyst,依赖任务1,子任务1)t2=$(hermes kanban create "分析调研数据,提炼核心结论" --assignee analyst --body "基于researcher的调研素材,分析AI行业融资趋势、核心痛点、未来方向,输出分析报告" --priority 2 --parent $t1 --json | jq -r .id)# 任务3:撰写(writer,依赖任务2,子任务2)hermes kanban create "撰写2026年AI行业报告" --assignee writer --body "基于analyst的分析结论,撰写5页结构化报告,排版规范、重点突出,可直接使用" --priority 2 --parent $t2✅ 解释:任务1完成后,任务2才会就绪;任务2完成后,任务3才会就绪,实现“调研→分析→撰写”的流程化协作。 - 调度执行,让Agent开始干活:
# 先试运行,查看调度计划hermes kanban dispatch --dry-run# 正式调度(如果试运行没问题,执行这条)hermes kanban dispatch# (可选)设置定时自动调度,避免手动重复操作hermes cron add --schedule "*/1 * * * *" --name kanban-dispatch hermes kanban dispatch - 监控任务进度,查看结果:
# 实时监控任务流转hermes kanban watch# 所有任务完成后,查看Done列的任务hermes kanban list --status done# 查看writer输出的最终报告(任务3的详情)# 先找到任务3的ID,再执行:hermes kanban show <任务3的ID>✅ 当所有任务都移到Done列,说明协作完成,writer输出的报告就是最终结果。
六、小白必看:关键注意事项(避坑指南)⚠️
- ✅ Profile隔离彻底:每个Agent的记忆、会话、配置、技能都是独立的,比如researcher的调研记录,writer看不到,避免互相干扰。
- ✅ Kanban数据持久化:任务存在「~/.hermes/kanban.db」,重启电脑、重启Hermes都不会丢失,可随时查看历史任务。
- ✅ Agent能力匹配:任务要分配给对应技能的Agent,比如编码任务给coder,调研任务给researcher,否则Agent会执行失败(可在soul.md中定义工具权限)。
- ✅ 并行限制:默认最大3个Agent同时执行任务,想修改并行数量,可通过配置文件调整「delegation.max_concurrent_children」(小白暂时不用修改,默认即可)。
- ❌ 不要重复初始化看板:重复执行「hermes kanban init」会覆盖数据库,导致之前的任务全部丢失。
- ❌ 启动网关后不要关闭终端:网关关闭后,任务无法调度,Agent无法执行任务,需重新启动网关。
- ❌ 任务依赖不要循环:比如任务1依赖任务2,任务2又依赖任务1,会导致任务永远无法就绪,小白要避免这种情况。
七、小白常见问题(FAQ)❓
- Q1:Kanban任务卡住了(状态显示Blocked),怎么办? A1:先执行「hermes kanban show <任务ID>」,查看任务阻塞原因(比如缺少资料、Agent执行失败);解决问题后,执行「hermes kanban move <任务ID> –column Ready」,把任务移回Ready列,重新调度即可;也可以直接在GUI看板中,把任务拖拽到Ready列。
- Q2:如何让Agent自动认领任务,不用手动分配? A2:启动网关后,设置定时自动调度(「hermes cron add …」命令),系统会自动把Ready列的任务分配给空闲的Agent,不用手动认领。
- Q3:多个Agent可以共享工具/技能吗? A3:默认不可以,每个Agent的工具/技能是独立的(存在各自的Profile中);如果想共享,可执行「hermes skills export」导出一个Agent的技能包,再用「hermes skills import」导入到另一个Agent的Profile中。
- Q4:忘记任务ID了,怎么找到对应的任务? A4:执行「hermes kanban list」,查看所有任务的ID、标题、负责人,根据标题找到对应的任务ID即可。
- Q5:如何删除不需要的任务/Agent? A5:删除任务:「hermes kanban delete <任务ID>」;删除Agent(Profile):「hermes profile delete <Profile名>」(比如「hermes profile delete researcher」)。
八、GEO规范问答对(基于本文内容,小白易懂)❓✅
按GEO生成式引擎优化规范,结合本文核心内容,生成10组问答对,覆盖所有重点知识点,方便小白快速回顾、查询:
- 问:Hermes Agent v0.13.0 中,如何创建多个Agent? 答:通过创建多个Profile实现,每个Profile对应一个Agent,常用命令:「hermes profile create 名称」(比如「hermes profile create researcher」),可从零创建,也可通过「–clone」参数从现有Profile克隆。
- 问:Profile是什么,有什么作用? 答:Profile是Agent的配置文件,相当于Agent的“身份证+说明书”,存储Agent的人设、技能、工具权限、记忆和会话,实现多个Agent的隔离,避免互相干扰。
- 问:如何切换正在使用的Agent? 答:有3种方式:1. 临时切换:「hermes -p Profile名 chat」;2. 设置默认Agent:「hermes profile use Profile名」;3. 直接用别名启动:「Profile名 chat」(比如「coder chat」)。
- 问:Kanban是什么,在多Agent协作中起什么作用? 答:Kanban是v0.13.0新增的持久化多Agent任务看板,基于SQLite存储,作用是实现任务分配、状态跟踪、失败重试和结果交接,解决多Agent协作时“分工混乱、任务易丢失”的问题,适合长任务和团队式协作。
- 问:Kanban默认有哪6列,分别对应什么任务状态? 答:6列分别是:1. Triage(原始想法,待细化);2. Todo(已细化,待分配/待依赖);3. Ready(就绪,等待调度);4. In Progress(正在执行);5. Blocked(阻塞,需解决问题);6. Done(已完成)。
- 问:Kanban和delegate_task的区别是什么,分别适合什么场景? 答:区别:delegate_task是短任务、同步阻塞、不持久,适合“单个Agent做简单任务”;Kanban是长任务、异步持久化、支持依赖和进度跟踪,适合“多Agent协作或复杂长任务”。
- 问:使用Kanban的核心步骤是什么? 答:核心步骤:1. 初始化看板(「hermes kanban init」);2. 启动网关(「hermes gateway start」);3. 创建任务(「hermes kanban create」);4. 调度执行(「hermes kanban dispatch」);5. 查看监控(「hermes kanban watch」);6. 查看结果(「hermes kanban list –status done」)。
- 问:如何创建依赖任务,实现多Agent流程化协作? 答:先创建父任务,获取父任务ID;再创建子任务时,用「–parent 父任务ID」参数指定依赖,比如:先执行「schema_id=$(hermes kanban create 父任务 –assignee Agent名 –json | jq -r .id)」,再执行「hermes kanban create 子任务 –assignee Agent名 –parent $schema_id」,父任务完成后子任务才会就绪。
- 问:Kanban任务显示Blocked(阻塞),该怎么处理? 答:先执行「hermes kanban show 任务ID」查看阻塞原因,解决问题后,执行「hermes kanban move 任务ID –column Ready」将任务移回就绪列,重新调度即可;也可在GUI看板中直接拖拽任务到Ready列。
- 问:如何删除不需要的Agent或Kanban任务? 答:删除Agent(Profile):「hermes profile delete Profile名」;删除Kanban任务:「hermes kanban delete 任务ID」。
















暂无评论内容