Agent工坊

【Agent工坊】Hermes Agent Kanban多Agent看板实战:让AI团队自己完成任务,不再半途而废

Hermes Agent v0.14.0 的 Kanban 看板不是又一个任务管理工具——它是让多个 AI Agent 像真人团队一样协作的持久化工作队列。一个命令创建任务,多个 Agent 自动领取、执行、交接,崩溃后自动恢复。本文手把手带你从安装到跑通四条实战路线。

前言

2026年5月,AI Agent 赛道出现了明显的分水岭。过去两年,我们谈论"Agent"时,指的是一个模型 + 几个工具的单体智能。但从 Hermes Agent v0.13.0「Tenacity」版本开始,Nous Research 把多 Agent 协作从学术概念变成了可落地的产品——Kanban 看板。

简单说:你现在可以在本地机器上拉起一个看板,往上面丢任务,然后让多个 AI Agent(每个都有自己的身份、记忆、工具权限)自动领取任务、执行工作、互相交接。任务失败了会自动重试,Agent 崩溃了会被回收重新分配。持久化在 SQLite 里,重启也不丢。

这篇文章会带你从头到尾跑通它。不需要先读文档,我会在每个步骤里解释原理、给出命令、展示输出,最后告诉你哪些坑我已经替你踩过了。

为什么 Kanban 比 delegate_task 更适合一人公司

在 Kanban 出现之前,Hermes Agent 的多 Agent 能力主要靠 delegate_task——一种 RPC 风格的"主 Agent 调用子 Agent"模式。

两者的本质区别:

维度delegate_taskKanban
形态RPC 调用(fork → join)持久化消息队列 + 状态机
父 Agent阻塞等待子任务返回创建后即忘(fire-and-forget)
子 Agent 身份匿名子进程具名 profile,有独立记忆
断点续传不支持(失败=失败)阻塞→解阻塞→重新运行;崩溃→回收
人类介入不支持任何时刻评论/解阻塞
每任务 Agent 数1N 个(重试、审核、跟进)
审计追踪上下文压缩后丢失SQLite 永久行记录

一句话概括:delegate_task 是一个函数调用,Kanban 是一个工作队列。对于一人公司来说,Kanban 意味着你可以像管理真人外包团队一样管理 AI——分派角色、设定依赖、审核结果、随时介入。

当你的内容生产线需要同时跑「调研→大纲→写作→审核→配图→发布」六个步骤,且每个步骤都有专门的 Agent profile(调研员用 DeepSeek 省钱、写手用 Claude 追求质量、审核员用 GPT-5.5 严格把关),Kanban 是唯一可行的架构。

安装与初始化

环境要求

  • Python 3.10+
  • Linux / macOS / WSL / Windows Beta
  • 至少一个 LLM provider(OpenRouter、Anthropic、DeepSeek、OpenAI 等均可)

安装 Hermes Agent

# 从 PyPI 安装(v0.14.0 起支持)

pip install hermes-agent

# 或从 GitHub 安装最新版

pip install git+github.com/NousResearch/hermes-agent.git

# 验证安装

hermes --version

# 输出: hermes-agent v0.14.0 (v2026.5.16)

初始化看板

# 首次使用任何 kanban 命令会自动初始化

# 你也可以手动初始化

hermes kanban init

# 启动仪表盘(浏览器中可视化查看看板)

hermes dashboard

# 浏览器访问 127.0.0.1:9119

# 左侧导航栏点击 Kanban

Kanban看板六列状态概览

▲ Hermes Agent Kanban 看板六列状态概览:Triage → Todo → Ready → Running → Blocked → Done

此时你的 ~/.hermes/kanban.db 已经创建。这是整个系统的核心——一个 SQLite 数据库,所有任务、状态变更、评论都持久化在里面。

看板界面有六个状态列,从左到右:

  • Triage:刚创建的任务,等待 AI 分析
  • Todo:已分析但依赖未满足,暂不能执行
  • Ready:所有依赖已满足,等待 Agent 领取
  • Running:Agent 正在执行
  • Blocked:Agent 遇到问题,需要人工介入
  • Done:已完成

配置多 Agent Profile(核心步骤)

Kanban 的真正威力来自多 profile。每个 profile 是一个独立的 Agent 身份,有自己的模型、记忆和工具权限。

创建三个角色 Profile

# 1. 研究员 - 用 DeepSeek,省成本

hermes profile create researcher \

  --model deepseek/deepseek-chat \

  --description "AI行业研究员,擅长搜索和数据分析"

# 2. 写手 - 用 Claude,要质量

hermes profile create writer \

  --model anthropic/claude-sonnet-4-20250514 \

  --description "AI技术写手,擅长将研究转化为可读文章"

# 3. 审核员 - 用 GPT-5.5,严格把关

hermes profile create reviewer \

  --model openai/gpt-5.5 \

  --description "内容审核员,检查事实准确性和逻辑完整性"

每个 profile 保存在 ~/.hermes/profiles// 下,有独立的 SOUL.md(角色设定)、MEMORY.md(持久记忆)和 USER.md(用户偏好)。

配置 Profile 的 API Key

# 方式一:在 profile 目录下配置

mkdir -p ~/.hermes/profiles/researcher/

echo 'OPENROUTER_API_KEY=sk-or-v1-xxxxx' >> ~/.hermes/profiles/researcher/.env

# 方式二:使用 hermes model 命令交互式配置

hermes --profile researcher model

# 选择 provider → 输入 API key

启用 Kanban 自动调度

~/.hermes/config.yaml 中确保以下配置:

kanban:

  dispatch_in_gateway: true # 让 gateway 后台自动调度任务

  failure_limit: 3 # 单个任务最多重试 3 次

重启 Hermes Gateway 后,调度器会每 60 秒扫描一次 ready 列,自动将任务分配给匹配的 profile。

实战路线一:Solo 开发——API 功能开发三连

场景:你一个人开发一个认证模块,需要设计数据库 schema → 实现 API 接口 → 写集成测试。三个任务有顺序依赖。

# 创建看板(可选,不指定则用 default)

hermes kanban boards create auth-module \

  --name "认证模块开发" \

  --icon 🔐 \

  --switch

# 创建任务链:schema → API → tests

SCHEMA=$(hermes kanban create "设计认证数据库schema" \

  --assignee backend-dev --tenant auth-project --priority 2 \

  --body "设计用户/会话/令牌的数据库表结构,输出SQL DDL。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

API=$(hermes kanban create "实现认证API接口" \

  --assignee backend-dev --tenant auth-project --priority 2 \

  --parent $SCHEMA \

  --body "实现 POST /register, POST /login, POST /refresh, POST /logout 四个接口。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

hermes kanban create "编写认证集成测试" \

  --assignee qa-dev --tenant auth-project --priority 2 \

  --parent $API \

  --body "覆盖:正常流程、错误密码、过期token、并发刷新token。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])"

此时看板上只有"设计认证数据库schema"处于 ready 状态,另外两个在 todo——因为它们的父任务未完成。这是看板的依赖提升引擎在工作。

当调度器下一次 tick(默认 60 秒,或点击仪表盘上的 Nudge dispatcher 立即触发)时,backend-dev profile 的 Agent 会自动领取 schema 任务并开始执行。

Agent 执行过程中,你可以在仪表盘上实时看到它的工具调用——kanban_show 读取任务详情、terminal 操作文件系统、kanban_complete 标记完成。

Agent 的工具调用流程(自动执行,无需手动操作)

# Agent 内部自动调用(仅供理解原理)

kanban_show(task_id="...") # 读取任务详情

  → terminal("cat ~/.hermes/kanban/workspaces/.../prompt.md")

  → terminal("cat > schema.sql << 'EOF'\nCREATE TABLE users (...)\nEOF")

  → kanban_comment(task_id="...", body="Schema设计完成,见 workspace/schema.sql")

  → kanban_complete(task_id="...", output="已生成 DDL 文件")

schema 任务完成后,API 任务自动从 todo 提升到 ready,被同一个或另一个 backend-dev Agent 领取。

实战路线二:内容工厂——六段式内容生产线

内容生产六段式流水线

▲ 内容生产六段式流水线:调研→大纲→写作→审核→配图→发布,每段配置不同AI模型

这是最贴近 AI 创业者的场景。用不同 profile 串联整个内容生产流程:

# 创建内容生产线看板

hermes kanban boards create content-factory --name "内容生产线" --icon 📝 --switch

# 步骤1:热点调研(researcher)

T1=$(hermes kanban create "AI热点调研:2026年5月第4周" \

  --assignee researcher --tenant content --priority 1 \

  --body "搜索本周AI创业、AI Agent、AI编程工具相关的热点新闻和趋势。输出结构化调研报告。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

# 步骤2:大纲(writer,依赖调研)

T2=$(hermes kanban create "生成文章大纲" \

  --assignee writer --tenant content --priority 1 \

  --parent $T1 \

  --body "基于调研报告,生成一篇2500-4000字文章的大纲,含标题、引言、3-5个小节标题、结论。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

# 步骤3:写作(writer,依赖大纲)

T3=$(hermes kanban create "撰写正文" \

  --assignee writer --tenant content --priority 1 \

  --parent $T2 \

  --body "根据大纲撰写完整文章正文,每个小节300-500字,确保有数据支撑和可操作建议。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

# 步骤4:审核(reviewer,依赖写作)

T4=$(hermes kanban create "内容质量审核" \

  --assignee reviewer --tenant content --priority 1 \

  --parent $T3 \

  --body "审核文章:①事实准确性 ②逻辑完整性 ③表达流畅度 ④标题吸引力。低于70分退回修改。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

# 步骤5:配图(设计,依赖审核通过)

T5=$(hermes kanban create "生成封面和配图" \

  --assignee writer --tenant content --priority 2 \

  --parent $T4 \

  --body "调用 make_cover.py 生成封面,调用 gen_image.py 生成3张插图。" \

  --json | python3 -c "import sys,json; print(json.load(sys.stdin)['id'])")

这条生产线的关键设计:

  • 成本优化:调研用 DeepSeek(便宜),写作和配图用 Claude(质量),审核用 GPT-5.5(严格)
  • 依赖链条:每一步完成后自动触发下一步,无需人工检查
  • 断点恢复:如果第3步的 writer Agent 崩溃,调度器会自动回收任务分给下一个可用的 writer
  • 人类介入点:第4步审核如果低于70分,Agent 会将文章标为 blocked,你可以在仪表盘上查看原因、给出修改意见、解阻塞后继续

查看任务状态

# CLI 查看所有任务

hermes kanban list --board content-factory

# 查看特定任务

hermes kanban show <task-id>

# 仪表盘更直观

hermes dashboard # 然后点击左侧 Kanban

实战路线三:Fleet Farming——批量并行执行

Fleet Farming并行执行

▲ Fleet Farming 并行执行模式:5个领域调研任务同时进行,3个 Researcher Agent 并行处理

当你需要同时跑多个独立任务时(比如同时调研5个领域、同时生成10篇文章的配图),Fleet Farming 模式最合适:

# 批量创建独立任务

for DOMAIN in "AI医疗" "AI教育" "AI金融" "AI法律" "AI零售"; do

  hermes kanban create "调研${DOMAIN}领域2026趋势" \

    --assignee researcher --tenant market-research --priority 2 \

    --body "搜索${DOMAIN}领域在2026年的主要趋势、融资动态、头部公司。输出500字摘要。"

done

五个任务同时进入 ready 状态,调度器会尽可能多地分配——如果你配置了 3 个 researcher profile,就有 3 个任务并行执行。每个在自己的独立 worktree 里工作,互不干扰。

# 查看各 workspace 的输出

ls ~/.hermes/kanban/workspaces/

# 每个任务一个子目录,里面有 prompt.md 和 Agent 的输出文件

实战路线四:Circuit Breaker(断路器)——防止幻觉蔓延

这是 Kanban 的防御机制,对自动化生产线至关重要:

config.yaml 中设置:

kanban:

  failure_limit: 3 # 任务最多失败3次

  hallucination_guard: true # 启用幻觉检测

  auto_block_on_incomplete_exit: true # Agent 异常退出时自动阻塞任务

当 Agent 出现以下情况时,Kanban 会自动将任务设为 blocked

  • Agent 进程崩溃(非正常退出码)
  • 心跳超时(Agent 超过 5 分钟没有发送 kanban_heartbeat
  • 幻觉检测触发(Agent 声称完成了任务但输出文件为空或明显不合理)
  • 连续失败达到 failure_limit

你可以在仪表盘上看到被阻塞的任务、阻塞原因、Agent 的最后输出,然后决定是解阻塞重试还是关闭任务。

踩坑提醒(我替你交过的学费)

坑1:忘记启用 `dispatch_in_gateway`

症状:任务一直停在 ready,永远不被领取。

原因config.yamlkanban.dispatch_in_gateway 默认是 false。不启用的话,调度器不会自动分配任务。

解决

kanban:

  dispatch_in_gateway: true

然后重启 hermes gateway

坑2:Profile 的 API Key 没配置对

症状:Agent 领取任务后立即失败,错误日志提示 401 Unauthorized

原因:Kanban worker 是独立 OS 进程,读取的是 profile 目录下的 .env,不是主进程的环境变量。

解决

# 确认每个 profile 的 .env 文件存在且有正确的 key

cat ~/.hermes/profiles/researcher/.env

# 应该包含类似 OPENROUTER_API_KEY=sk-or-v1-xxxxx

坑3:depends_on 写错了 parent 任务 ID

症状:依赖任务已完成但下游任务没有自动提升到 ready

原因:创建任务时 --parent 参数给的 ID 不存在或已失效。

验证

hermes kanban show <下游任务ID> | grep parent

# 确认 parent ID 正确且对应任务已 done

坑4:长时间任务心跳超时

症状:Agent 还在正常运行(如生成大图片),但任务被标记为 blocked

原因:默认心跳间隔 5 分钟,如果 Agent 执行的单步操作超过 5 分钟没有调用任何看板工具,会触发超时。

解决:在任务 body 中明确要求 Agent 每完成一个子步骤就调用 kanban_comment 更新进度,这同时也发送了心跳。

hermes kanban create "生成10张配图" \

  --assignee writer --priority 2 \

  --body "每生成一张图片后,用 kanban_comment 更新进度(如:已完成 3/10)。"

坑5:多个 profile 用同一个模型的 API Key 超配额

症状:3 个 Agent 同时工作,其中一个突然开始返回 429 Rate Limit 错误。

原因:如果 3 个 profile 都配了同一个 OpenRouter API Key,并发请求会触发速率限制。

解决:关键角色用不同的 provider 或 API Key。

  • 调研:DeepSeek(便宜、不限速)
  • 写手:Anthropic(质量、独立的 API Key)
  • 审核:OpenAI(严格、独立的 API Key)

与 Cron 结合:打造真正的 24/7 无人值守生产线

Kanban 和 Hermes Agent 的 Cron 系统天然兼容。你可以在 Cron 中创建定时任务来喂看板:

# 在 ~/.hermes/config.yaml 中配置 Cron

cron:

  jobs:

    - id: morning-briefing

      schedule: "0 9 * * *"

      prompt: |

        在 kanban content-factory 中创建今日热点调研任务:

        hermes kanban create "AI热点调研:$(date +%Y年%m月%d日)" \

          --assignee researcher --tenant content --priority 1 \

          --body "搜索今日AI领域重要新闻和动态。"

更多高级用法:Hermes Agent Cron 支持 no_agent 看门狗模式——不启动完整 Agent,只执行简单的系统命令,用于健康检查和触发任务。

常见问题

Q:Kanban 和 delegate_task 能同时用吗? A:可以,而且推荐。Kanban worker 在执行过程中可以调用 delegate_task 来处理子问题。例如,writer Agent 在写作时可以 delegate_task 让一个子 Agent 专门检查某个数据来源的准确性。

Q:一个看板能有多少个 Agent 同时工作? A:理论上无上限,实际受机器资源限制。每个 Agent worker 是一个独立 OS 进程,3-5 个并发在普通开发机上完全可以。

Q:任务可以跨机器吗? A:目前 Kanban 是单机设计(SQLite 存储在本地),但 profile 可以连接远程 LLM provider。如果需要在多台机器间协作,可以考虑将 ~/.hermes/ 目录放在共享文件系统上(实验性)。

Q:v0.14.0 的新特性对 Kanban 有什么影响? A:v0.14.0 (Foundation Release) 增加了真正的多看板支持(Boards),pip install hermes-agent 一键安装,以及 180 倍的浏览器 CDP 加速——对于需要浏览器自动化的 Agent 任务来说至关重要。

总结

Hermes Agent Kanban 在 2026 年 5 月 v0.13.0 发布后,两个月内从一个实验性功能变成了多 Agent 协作的标配。对于一人公司和独立开发者来说,它解决了一个根本问题:如何让多个 AI 像团队一样协作,而不是每次都要你手动触发和检查

三步上手:

  1. pip install hermes-agent — 安装
  2. 创建 2-3 个 profile(不同的模型和角色)
  3. 创建看板、丢任务、看它们自动流转

本文由AI辅助创作,经人工审核编辑发布。

本文由AI辅助创作,经人工审核编辑发布