Hermes Agent Demo

这是什么？适合谁？

Hermes Agent Demo（git-syl/hermes-agent-demo）是一个Spring Boot 4 多模型 Agent 运行时：基于 Spring Boot 4 / Spring AI 2.0 的多模型 Agent 运行时，含模型路由、Task 子 Agent、热插拔 Skills、Docker 沙箱、MCP、pgvector RAG 与 Human-in-the-Loop 审批。

核心价值：给 Java 技术栈提供一个企业级 Agent 运行时参考实现，把多模型、子 Agent、Skills、沙箱、RAG、审批串成一条链路。

适合人群：

• Java/Spring 技术栈团队
• 想落地企业级 Agent 运行时的架构师
• 研究 Spring AI 2.0 的开发者

使用前提：Java 21+、Docker、PostgreSQL(pgvector) 与模型 API

准备工作

1. 安装：clone 仓库并配置
2. 模型：Anthropic/DeepSeek/OpenAI API key
3. 环境：Java 21+、Docker、PostgreSQL + pgvector
4. 成本：Apache-2.0 开源免费；模型按量计费
5. 时间：完整跑通约 1 小时

快速上手（3 步）

第一步：安装依赖

git clone https://github.com/git-syl/hermes-agent-demo
cd hermes-agent-demo
# 按 README 配置 pgvector 与模型 key

克隆并配置数据库与模型

第二步：启动服务

启动 Spring Boot 服务

第三步：运行 Agent 任务

下发任务，走模型路由与子 Agent

成功判定：服务启动后，一个任务经模型路由由 Agent 完成并流式返回 SSE 事件。

初级用法

模型路由

在 Anthropic / DeepSeek / OpenAI 间路由。

thinking 开关

按任务开关思考模式。

Task 子 Agent

把任务拆给子 Agent。

高级玩法

热插拔 Skills

运行时动态加载 Skills。

Docker 沙箱 + 代码解释器

在沙箱中执行代码。

pgvector RAG + HITL

检索增强 + 人工审批。

小技巧

1. 先跑最小示例，再逐步开模块
2. 模型 key 用环境变量，别进代码
3. Docker 沙箱注意资源限制
4. HITL 审批节点要设超时
5. 关注 SSE 事件流的错误处理

常见踩坑

踩坑 1：环境依赖重

• 现象：启动失败
• 原因：Java/Docker/pgvector 缺一
• 解决：按 README 完整准备环境

踩坑 2：模型路由错误

• 现象：请求发到错误模型
• 原因：路由配置错
• 解决：核对路由规则与模型 key

踩坑 3：沙箱资源失控

• 现象：Docker 沙箱占满资源
• 原因：未设资源限制
• 解决：给沙箱设 CPU/内存上限

踩坑 4：RAG 检索偏差

• 现象：pgvector 检索不准
• 原因：嵌入模型与数据
• 解决：核对向量化配置

踩坑 5：项目较新

• 现象：功能未完全稳定
• 原因：2026-08 新建
• 解决：以 README 为准

常见问题 FAQ

Q1: 为什么用 Spring AI？

A: A: 面向 Java/Spring 技术栈，提供企业级 Agent 运行时参考实现。

Q2: 免费吗？

A: A: Apache-2.0 开源免费，模型调用按量计费。

Q3: 支持哪些模型？

A: A: Anthropic / DeepSeek / OpenAI，具体见 README。

Q4: 需要什么环境？

A: A: Java 21+、Docker、PostgreSQL + pgvector。

Q5: 适合生产吗？

A: A: 作为参考实现较完整，但项目新，生产前需充分评估。

进阶学习建议

掌握基础后，建议深入：

1. 研究 Spring AI 2.0 的 Agent 抽象

2. 把 HITL 审批接入企业流程

3. 对比 Java 与 Python Agent 生态

参考链接

• 官方仓库

最后更新：2026-08-31 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成