Spring Boot 4.1 + Spring AI 2.0:我如何用 Java 微服务把 RAG、知识图谱和 MCP 协议串成一个 Agent 平台

做 Java 生态的 AI 应用,最痛苦的不是模型调用,而是把 RAG、Agent 编排、工具协议、知识图谱这些能力在一个工程里干净地组装起来 。Spring AI 生态目前缺少一个覆盖全链路的参考实现,所以我动手做了一个:springboot-agent。

它不是又一个"Spring AI + 一个向量库"的 Demo。项目采用多模块微服务架构,核心模块包括:

  • springboot-rag :基于 Spring AI 2.0 + LangGraph4j 1.8.27 实现检索增强生成与 Agent 工作流编排。用 StateGraph 把意图分流(NORMAL/RAG/AGENT)组织成可执行的状态图,通过 AgentExecutor 接入 Spring AI 工具调用。底层向量库用 Milvus ,知识图谱用 Neo4j ,对话记忆走 Redis ,本地推理用 Ollama (qwen2.5:7b + nomic-embed-text) 。附带 React + TypeScript 前端,支持知识图谱可视化和对话交互。

  • springboot-ocr :集成 MinerU 做 PDF 解析与 OCR,Chinese-CLIP 做图文相似度匹配,MinIO 做对象存储。处理扫描件和复杂版面的文档时,比纯文本抽取多一层保障。

  • springboot-mcp-sse / springboot-mcp-stream :分别基于 Spring AI MCP Server 实现 SSE 和 Streamable-HTTP 两种协议的服务端,覆盖 MCP 工具注册、调用与双向流式通信。

  • springboot-a2a :基于 Spring AI A2A Server + A2A Java SDK 演示多智能体协作------Agent Card 发布能力、Host Agent 发现并委派远程 Agent、任务结果从 Artifacts 中提取。

  • springboot-skills :集成 Spring AI Agent Utils + Agent Sandbox ,把结构化技能说明、工具调用和隔离脚本执行接入 ChatClient,默认用 python:3.12-slim 镜像做沙箱执行。

  • 外围还有 Spring Cloud Gateway 统一网关、Sentinel 流量治理、Kafka 异步任务队列。

技术栈全貌:Java 21 / Spring Boot 4.1.0 / Spring AI 2.0.1 / LangGraph4j 1.8.27 / Spring Cloud 2025.0.1 / Ollama / Milvus / Neo4j / Redis / MinIO / Kafka / Docker。

我知道这套栈很新,也知道依赖组件多意味着上手门槛高。所以想借这篇文章聊聊选型背后的判断:为什么在 Java 生态里选 LangGraph4j 而不是自己写状态机?为什么 MCP 要同时支持 SSE 和 Streamable-HTTP 两种传输?A2A 在多 Agent 协作里解决了什么 A2A 之前的方案解决不了的问题?

项目地址:GitHub - wangdongpeng1/springboot-agent: 基于 Spring Boot 4.1 + Spring AI 2.0 构建的 AI 代理服务平台,采用多模块微服务架构,集成 RAG、LangGraph4j 工作流、MCP、A2A、Skills 沙箱、OCR 与流量治理等能力。。 · GitHub

欢迎拍砖,尤其欢迎在 Issues 里告诉我"哪个模块的启动顺序卡住了"------这比 star 更有价值。

相关推荐
leer16 小时前
我给 agent 加了一道闸,拦住了自己差点删掉的构建目录
mcp
Soari21 小时前
NetPilot:用RAG与验证回路辅助混合TSN和5G网络配置
5g·网络配置·大语言模型·tsn·rag
莪_幻尘1 天前
AI 编程的下一场战争,不在模型,在协议
agent·ai编程·mcp
攒了一袋星辰1 天前
AI 求职长期记忆原理解析:从碎片经历到贝叶斯能力星图
知识图谱·agent·rag·ai工程·校招面试
我不会起名字3222 天前
Agent 总调错工具?MCP 接进 Go 后端的 4 个约束
后端·go·agent·mcp
vivo互联网技术2 天前
研发数字人 Agent:从 0 到 1 的架构与实践
人工智能·agent·mcp
LiaoWL1232 天前
从零搭一个 RAG 知识库(二):换上语义 Embedding——BGE 实测与阈值重校准
python·大模型·numpy·embedding·向量检索·rag
龙腾AI白云3 天前
具身智能的空间导航与未知环境探索
大数据·数据库·人工智能·机器学习·知识图谱
2601_967987373 天前
AI加速波:大模型应用开发主要做哪些工作?
rag·提示词工程·agent开发·ai大模型应用开发·服务封装