Hermes Agent多Agent系统搭建指南
HermesAgent框架通过看板机制构建多智能体系统，利用持久化队列与调度器自动拆解、分派和追踪任务。用户需初始化数据库并启动调度服务，创建具备特定技能的智能体角色。提交复合任务后，系统将其解析为子任务并行处理，支持进度监控与人工介入，确保流程可控可靠。
想要构建一个能够协同工作的多智能体系统吗？Hermes Agent框架的看板（Kanban）任务编排机制，正是为此而设计的。该机制通过持久化的任务队列和角色化的智能体调度，能够自动拆解任务、分派给不同专家、并行执行并追踪全过程。接下来，我们将详细解析具体的搭建步骤。
一、启用 Kanban 多智能体编排核心组件
Kanban是Hermes实现多智能体协作的底层运行时。它依赖于SQLite持久化队列和一个调度器协同工作，确保任务可以恢复、可以追溯，甚至在必要时进行人工干预。
首先，请确保你的Hermes已经安装，并且升级到了v0.8.0或更高版本，该版本开始支持Kanban功能。
接着，执行初始化命令来创建默认的看板数据库：hermes kanban init。
完成后，验证数据库文件是否在预期路径生成：~/.hermes/kanban.db，并确认其可读写。
最后，启动调度器后台服务，让它开始监听新任务：hermes dispatcher start --daemon。这样一来，调度引擎就准备就绪了。
二、定义并配置多个专业化智能体角色
在这个系统中，每个智能体角色都代表一个独立的专家，拥有特定的技能和配置。Kanban系统会根据任务类型，自动唤醒对应的角色，实现职责分离。
例如，你可以先创建一个负责研究的角色：hermes profile create researcher。
然后，为这个研究员角色安装网络搜索和摘要整理的技能：hermes -p researcher skills install web-search summarize。
再创建一个负责写作的角色：hermes profile create writer。
为写手角色安装文档生成和语法检查的技能：hermes -p writer skills install doc-gen grammar-check。
请注意，所有需要参与看板协作的角色，都需要统一安装看板交互能力：hermes skills install devops/kanban-worker。这是它们能够接收和反馈任务的基础。
三、配置差异化模型与运行参数
不同的角色，任务性质也不同。为它们绑定不同的大语言模型，既能适配任务复杂度，也能优化资源利用，同时保证推理质量和响应速度。
例如，对于研究员角色，可以指定一个在信息召回方面表现突出的模型：hermes -p researcher config model qwen-max。
而对于写手角色，则可以指定一个文本生成能力更强的模型：hermes -p writer config model deepseek-v3。
运行参数也可以按需调整。研究员可能需要更长的思考时间，可以设置超时阈值：hermes -p researcher config timeout 300。
写手需要生成较长的报告，可以调整最大输出长度：hermes -p writer config max_tokens 4096。
四、构建跨角色任务流并触发执行
配置好角色后，整个系统就可以运转起来。用户只需要输入一个主任务，系统便会自动解析意图，拆解成子任务，并按预设规则分发给对应的角色并行处理。每个智能体完成后，会调用kanban_complete来更新状态。
具体流程如下：
1. 在命令行或Web界面中，提交一个复合指令，例如：请调研2026年Q1国产大模型技术进展，并生成一份面向技术决策者的简报。
2. 系统会自动调用kanban_create，将这个任务拆解为两个子任务：由【researcher】执行信息检索与整理；由【writer】执行简报撰写。
3. 调度器会在60秒内分别拉起研究员和写手的进程，每个进程都会加载对应的角色配置和技能。
4. 两个智能体开始并行工作，它们的执行日志会实时写入看板数据库。你可以随时通过hermes kanban tail
五、启用人工介入与阻塞处理机制
自动化虽好，但完全放手有时并不明智。当某个智能体在执行中遇到模糊指令、数据冲突或需要策略确认时，它可以主动挂起任务，等待人工审核。这保障了流程的可控性和最终结果的可信度。
实现方式如下：
1. 在研究员角色的技能代码中，可以插入阻塞逻辑，例如：kanban_block("原始数据来源不一致，需人工核验权威出处")。
2. 一旦执行到这行代码，该任务状态会立即变更为blocked，并在hermes kanban list的输出列表中清晰显示。
3. 此时，管理员可以介入，执行命令解除阻塞并给出指示：hermes kanban resolve
4. 指令下达后，调度器会自动重新调度这个子任务，研究员则会基于人工确认的信息，继续执行后续步骤。