1. AI 服务开发最大的问题不是模型不够聪明而是“接进来”太难我见过太多 Java 团队评估 AI 落地的时候第一步就卡住了。模型 API 文档动辄几十页不同厂商的请求格式不统一要接入一个工具得自己写联网逻辑、解析模型返回值、维护会话上下文……明明只是想把“发送文本、拿到结果”这件事做对结果写出来的胶水代码比业务代码还多。这也是为什么 SpringAI MCP Server 这个组合一出来我就觉得方向对了MCP 负责把“工具调用”这件事标准化SpringAI 负责把 MCP 变成 Spring 生态里那种“加个依赖、写个配置”的体验。这句话翻译成人话就是以前你要让大模型帮用户查订单、审核内容你得自己去实现一套工具调用链路现在你只需要写一个普通方法加上 Tool 注解把它交给 SpringAI模型就能在回答问题时自动调用这个方法剩下的协议、传输、回调都由框架处理。这篇文章适合谁已经会用 Spring Boot 写接口、但还没接触过 AI 工程化的 Java 后端团队里准备做“AI 智能审核”“AI 客服”“AI Agent 搭建”的项目负责人想赶在 2025 年把 AI 能力真正落到业务系统里的开发者。我默认你了解 Spring Boot 的基本概念比如自动装配、starter、依赖管理。MCP 和 SpringAI 的细节我会从头讲保证你看完能照着搭。2. 别急着写代码MCP 的四个关键概念决定你后面是否踩坑2.1 Host、Client、ServerAI 应用里的“浏览器-网页-接口”MCP 的全称是 Model Context Protocol模型上下文协议。它解决的是一个大模型应用和外部数据源、外部工具之间“怎么聊天”的问题。在这个协议里有三个角色你要记住Host、Client、Server。Host 是模型真正运行在哪里、用户在哪个界面上操作的程序比如 Claude 桌面端、你自己的 Web 应用。Server 是你把业务能力暴露出来的程序比如一个提供“订单查询”“内容审核”能力的服务。Client 则是两者之间负责通信的组件它实现协议细节把 Server 暴露的工具列表同步给 Host再把 Host 的调用请求转发给 Server。我用一个类比来记Host 相当于浏览器Server 相当于一个网站的后端接口Client 相当于浏览器里的网络请求库。你上网时不会关心 HTTP 是怎么握手、怎么分包的同样模型调用你的工具时也不该关心你的服务是 Java 还是 Python、是在本机还是远程。协议标准化之后任何支持 MCP 的客户端都可以直接连接你暴露出来的能力。2.2 Tools、Resources、PromptsMCP 的三种能力原语MCP 协议定义了三种“能力原语”理解它们对后续设计特别重要。Tools 是带输入参数定义的函数。模型根据你的说明决定是否调用调用后拿到结构化结果继续生成回答。这是 MCP Server 最重要的能力也是本项目的核心。Resources 是提供给模型的只读上下文资源比如你有一份产品手册、一份规章制度可以当作资源注入让模型回答时自动参考。Prompts 是预设的提示词模板用户通过 Host 触发这些模板快速开始一个任务比如“审核这段文本”“生成周报”。我个人强烈建议先只用 Tools 起步把资源和提示词往后放。因为 Tools 的收益最直接而且 SpringAI 对工具调用的支持最成熟资源和提示词在不同客户端上的兼容性反而不如 Tools 稳定。你做 MCP Server 的第一阶段只需要关注工具列表够不够用、描述够不够清楚其他能力可以后面再补。2.3 为什么 SpringAI 选了 SSE 而不是 HTTP 短连接MCP 协议的传输方式主要有 stdio 和 HTTP。stdio 多用于本地进程比如本地桌面应用调一个脚本HTTP 多用于远程服务。在 HTTP 传输的基础上SpringAI 的 MCP Server 默认使用的是 SSE也就是 Server-Sent Events即服务端单向事件推送。为什么不直接用简单的 JSON 接口因为模型调用工具往往不是一次请求就能结束经常需要多轮对话而且大模型的生成是流式的你把结果打成一个大 JSON 返回用户在界面上还要傻等全部生成完。SSE 的好处是服务端可以持续推送客户端边接收边处理体验和效率都好得多。你把它理解成广播和点播的区别HTTP 短连接是点一次播一次SSE 是连上以后有内容就持续推送。明白了这些再看 SpringAI 的 MCP Server就清晰了它本质上是把一个 Spring Boot 应用变成 MCP 协议里的一个 Server通过 /mcp 这个 SSE 端点对外暴露能力。接下来聊设计你要先想清楚服务边界和技术选型这直接决定后面划分代码模块时痛不痛快。3. 项目设计与技术选型先想清楚你的 Server 该怎么“切”3.1 三种落地形态内嵌、独立网关、领域拆分动手之前先回答一个问题MCP Server 要单独建一个工程还是直接塞进现有业务系统根据我这段时间的经验有三种形态可以参考。第一种内嵌到现有 Spring Boot 应用里。比如你有一个商城系统直接在商城服务里加一个 MCP Server 配置把已有的订单、售后、物流 Service 方法暴露成工具。优点是省运维缺点是如果模型调用频率高工具调用会占用业务系统资源一个满负荷的 AI 调用可能把商城接口拖慢。第二种做一个独立的 AI 网关服务。所有 AI 相关能力集中放在这个服务里它既充当 MCP Server也充当 MCP Client连接多个模型和多个业务工具。这种形态适合已经有多个系统、需要统一治理 AI 入口的团队也是我推荐多数项目先采用的方案。第三种按领域拆成多个 MCP Server。审核一个 Server、客服一个 Server、推荐一个 Server各管各的工具客户端按需连接。优点是隔离性好缺点是部署维护成本高除非模型调用量已经大到单进程撑不住否则前期不用急着拆。我自己的选择是第二种起步。原因很现实AI 能力刚上线时调用量不大独立成一个网关服务不会影响现有业务的发布节奏后面如果某个领域突然爆量再把它拆出去也很快。你千万别一开始就追求完美架构MCP Server 拆来拆去最终只会把自己拆进流程里。3.2 技术栈与版本选择JDK 17 起步Spring Boot 3.x 是底线SpringAI 对底层的技术要求比较明确JDK 17 起步Spring Boot 3.2 以上最好直接上 3.3 或 3.4。原因是 MCP 的自动装配模块大量使用了 Spring Boot 3.x 的新基础设施很多类在 2.x 里根本不存在。模型接入方面我建议先用一个兼容 OpenAI 协议的大模型或本地模型比如 OpenAI、通义千问、Ollama 跑起来的 Qwen。SpringAI 的 model starter 会帮你把不同厂商的差异抹平你只管在配置里写 API Key 和模型名。版本选择是新手最容易翻车的地方。SpringAI 的版本迭代很快命名带有 M1、M6、GA 等后缀不同版本的配置项和 API 会有变化。我写这篇文章时以 1.0.0-M6 为例你在生产环境尽量选择已经 GA 的正式版本并锁定 BOM 版本不要偷偷升级。Spring AI 的里程碑版本发布在 Spring 官方仓库如果 Maven 拉不到依赖就要检查仓库地址有没有配对。3.3 模块划分别把工具代码和业务代码揉在一个包即使是单模块工程我也建议你把工具相关代码集中放在几个包里这样后续拆分独立服务时成本很低。我在项目里用的包结构是这样的com.example.mcpserver ├── config # MCP 配置、模型配置 ├── tool # 所有 Tool 方法集合 ├── service # 工具内部调用的业务服务 ├── client # MCP Client 配置或外部服务调用 └── model # 入参出参、DTO工具层只做“把模型传进来的参数翻译成业务调用”业务逻辑放 service这样你用单元测试测 service用集成测试测 tool职责清晰。很多项目后来代码一团乱就是因为审核逻辑、订单查询逻辑直接写在 Tool 方法体里一个方法几百行根本没法维护。到后面你手里有十几个工具的时候这种分层带来的好处会非常明显。4. 核心实现解析Tool 背后的自动装配是怎么转起来的4.1 一个 Tool 注解省掉了你手写 JSON Schema 的时间先看一个最简单的工具例子Component public class ContentAuditTool { Tool(description 审核用户发布的文本内容返回是否通过以及原因) public String audit(String content, String scene) { // 具体审核逻辑 return {\result\:\pass\,\reason\:\ok\}; } }这里最重要的不是那个方法体而是 Tool(description ...)。MCP 协议要求每个工具都有一份 JSON Schema描述方法名、参数、参数类型、说明。如果你手写 Schema既容易出错又和代码脱节。SpringAI 会在启动时用反射读取 Tool 注解、方法签名和参数的 javadoc自动生成这份 Schema。description 写得不好模型就根本不会调用你的工具。模型本质上是在读描述做选择描述写得像“审核文本并返回结果”这种含混的表述模型既不确定参数怎么填也不确定返回值长什么样。我建议描述里写清楚这个工具是干什么的、什么时候该调用、参数分别代表什么、返回结果是什么格式。宁可写长一点也别省。模型理解接口的方式和我们给同事写代码注释是一样的越清楚越好。4.2 ToolCallbackProvider把工具丢给 SpringAI 的更优雅方式SpringAI 官方推荐的注册方式不是把组件直接扫进来而是通过 ToolCallbackProvider 统一提供给 MCP Server 自动装配。Configuration public class McpToolConfig { Bean public ToolCallbackProvider auditTool(ContentAuditTool auditTool) { return MethodToolCallbackProvider.builder() .toolObjects(auditTool) .build(); } }这个方法返回的是一个 providerSpringAI 的 MCP Server 自动装配会扫描容器里的 ToolCallbackProvider把它提供的所有工具注册到 MCP Server 上。这样做的优势是你可以对一个 provider 里的工具做统一控制比如加载顺序、调试开关后续增加新工具不需要改自动装配逻辑只要保证新工具对象在 Spring 容器里能被找到。这里有个细节MethodToolCallbackProvider.builder().toolObjects(...) 接收的是对象实例不是 Class。如果你传了 ClassSpringAI 会尝试自己创建实例但这样一来工具类里面依赖的 service、repository 就注不进去了。你千万别把工具类在工具类里自己 new 出来一定要让 Spring 管理它再把这个实例传给 builder。4.3 Server 端自动装配从注解到 /mcp 端点项目引入了 spring-ai-starter-mcp-server 之后SpringAI 会做三件事创建 MCP Server 的核心对象扫描容器里的工具定义把协议端点暴露到 Web 层。默认情况下SSE 端点是 /mcp。Spring Boot 启动时自动装配会生成一个专门处理 MCP 协议请求的 Controller处理 /mcp 的 GET 请求建立 SSE 连接处理 POST 请求接收模型端的工具调用结果。配置项里可以调整端点路径spring: ai: mcp: server: sse-endpoint: /mcp如果你在网关前面又套了 context-path要注意路径千万别写重。曾有同事把 context-path 设为 /api又保留了默认的 /mcp结果客户端连了 /api/mcp工具就是调不通。原因就是没搞明白自动装配生成的端点是相对于 context-path 的路径拼接多了一层。改完路径后用 curl 直接访问端点看返回内容比用客户端排错快得多。4.4 Client 端接入HttpMcpTransport 一行搞定服务端只是故事的一半你总得有个地方让模型真的去调用这些工具。SpringAI 也提供了 MCP Client 的 starter连接远程 MCP Server 的方式非常简单var mcpClient McpClient.using( new HttpMcpTransport(http://localhost:8080/mcp) ).sync();HttpMcpTransport 是 SpringAI 内置的 HTTP 传输实现你只需要传 URL。调用 sync() 会得到一个同步版本的客户端可以直接用它列出工具、调用工具。要把这些工具接到模型上需要将 McpClient 的 toolCallback 合并进 ChatClient 的 defaultTools具体 API 在不同版本略有差异IDE 里会有提示。这个模式和你调用第三方 HTTP 接口很像你定义一个远程服务的地址拿到一个客户端对象之后所有协议细节都被封装了。差别在于这里“接口”不是你自己定义的 URL而是对方暴露的工具列表模型会动态决定调哪个。我调试 Client 端时经常打印工具列表确认连接是否正常这是最快验证服务端是否“活着”的方法。4.5 系统提示词配置与多 Agent 协作SpringAI 里配置系统提示词可以直接通过 ChatClient 的 builderChatClient chatClient ChatClient.builder(chatModel) .defaultSystem(你是内容安全审核助手只负责审核文本不要回答与审核无关的问题。) .build();搜索词里有人问 springai 系统提示词怎么配置答案就这么直接。但要注意系统提示词决定了模型的角色边界你要把“什么时候必须调用工具、什么时候不能调用工具”写进去。否则模型可能拿着一个不需要审核的问题也硬调工具或者需要审核的问题反而直接给出答案这会让日志很难看。比如你可以明确写“用户要求审核内容时必须调用 audit 工具其他闲聊直接回答不需要工具。”多 Agent 协作是另一个热门需求。你可以把多个 MCP Server 看成不同的“专家”比如审核专家、订单专家、推荐专家。在 Client 端把多个 Server 的工具都注册到同一个 ChatClient 里模型就会根据问题自己决定调用哪个专家。这种模式下每个 Server 保持轻量编排逻辑集中在客户端是目前实现 AI Agent 搭建成本比较低的方式。多个模型也可以各干各的一个负责理解意图一个负责生成回复Model 层由 SpringAI 统一管理你不用自己拼胶水代码。5. 实操记录从空目录跑出一个可用的 MCP Server5.1 Spring Initializr 初始化 IDEA 社区版的建项目流程很多新手卡在第一步用 IntelliJ IDEA 社区版建不了 Spring Boot 项目怎么办我直接讲我实际跑通的过程。社区版本身没有 Spring Initializr 向导但不影响你可以打开 start.spring.io在浏览器里选好参数然后下载 zip 解压再用 IDEA 社区版以普通 Maven 项目的方式打开。页面上的关键参数Project 选 MavenLanguage 选 JavaSpring Boot 选 3.x 最新稳定版Group 和 Artifact 按自己习惯填依赖先只加一个 Spring Web 和一个 Spring Boot Actuator。SpringAI 相关依赖后面手动加因为官方初始化页面不一定集成了最新的 SpringAI 版本。下载后解压IDEA 里 File - Open选中工程目录等 Maven 索引跑完。如果你本机 JDK 版本低于 17记得在 Project Structure 里把 SDK 切到 17 或 21不然编译会报错。这一步在社区版和旗舰版没有任何区别工具链一样用。5.2 依赖与配置仓库、BOM、端口修改要点SpringAI 的多数正式版本发布在 Maven 中央仓库里程碑版本在 Spring 官方的里程碑仓库里。为了稳定我建议直接锁定一个版本并配置 BOMdependencyManagement dependencies dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-bom/artifactId version1.0.0-M6/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement然后加两个核心依赖dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-starter-mcp-server/artifactId /dependency dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-starter-model-openai/artifactId /dependency如果你的模型走的是 OpenAI 兼容接口而不是官方 OpenAI记得在 application.yml 里把 base-url 指到自己的地址。端口修改也是新手常问的直接改 Spring Boot 的 server.port比如我本地 Client 端不想和 Server 端冲突就把 Client 端口设为 8181Server 设为 8080。配置示例server: port: 8181 spring: ai: openai: base-url: https://your-model-host api-key: ${AI_API_KEY} chat: options: model: gpt-4o mcp: server: sse-endpoint: /mcpAPI Key 别写死在配置文件里用环境变量引用这是所有项目都应该养成的习惯。仓库地址如果嫌 Maven 中央仓库慢可以在 pom 的 repositories 里加上 Spring 官方的 releases 仓库和 milestones 仓库需要哪个版本就配哪个不会冲突。5.3 第一个智能审核工具规则优先模型兜底我们以搜索词里反复出现的 springai 智能审核做一个完整案例。场景社区产品里用户每天要发大量帖子需要自动识别广告营销、辱骂攻击、联系方式泄露等违规内容。设计上我采用两层方案第一层用规则匹配快速拦截明确违规的词第二层用大模型对模糊内容做判断。规则层成本低、速度快、可解释模型层能处理规则覆盖不到的语义攻击比如变体词、谐音、间接暗示。代码结构Component public class ContentAuditTool { private final ChatClient chatClient; public ContentAuditTool(ChatClient.Builder chatClientBuilder) { this.chatClient chatClientBuilder.build(); } Tool(description 审核用户发布文本对广告、辱骂、联系方式泄露等风险内容进行判断返回结构化 JSON。) public String audit(String content, String scene) { if (ruleHit(content)) { return {\result\:\block\,\level\:\high\,\reason\:\命中规则词\}; } String prompt 你是内容安全审核员只做文本风险判断。 文本%s 场景%s 如果存在广告营销、辱骂攻击、联系方式泄露等风险输出 block否则输出 pass。 直接输出 JSON。 .formatted(content, scene); return chatClient.prompt().user(prompt).call().content(); } private boolean ruleHit(String content) { return content.contains(加V) || content.contains(转账) || content.contains(代开发票); } }核心点在于工具返回的一定是结构化 JSON模型拿到这个结果后才能把它编成一段自然的审核结论。你如果返回一串中文散文模型就不知道该往哪里放这段内容。还有一点要注意千万别在工具方法里直接做耗时很久的操作。模型调用工具通常有超时限制如果一个审核请求要等十几秒前端早就断了。耗时操作要么异步化要么做成快速反馈加后续回调别让用户等到怀疑人生。5.4 客户端联调看模型怎么自动把工具“调”起来服务端写好后我在客户端工程里模拟了一次完整调用。客户端也是一个 Spring Boot 应用加上 mcp-client 的依赖通过 HttpMcpTransport 连接服务端 8080 的 /mcp然后把工具注册到 ChatClientConfiguration public class McpClientConfig { Bean public ChatClient chatClient(ChatModel chatModel) { var mcpClient McpClient.using( new HttpMcpTransport(http://localhost:8080/mcp) ).sync(); return ChatClient.builder(chatModel) .defaultTools(mcpClient.getAllTools()) .build(); } }注意不同版本的 SpringAI 里获取工具的方法名略有不同有的版本是 getAllTools()有的版本是 listTools() 再转成 ToolCallback 列表你在 IDE 里按提示补全就行以你锁定的版本为准。联调时最直观的观察方式是打印模型和工具之间的整个调用过程。你发一句“请审核这句话加V领红包”模型应该先调用 audit 工具拿到 block 结果然后告诉你“这段话疑似广告已拦截”。从日志里你能看到工具参数、工具返回值和最终回答这时候才能真正理解什么叫“模型自动选择工具”。5.5 顺手接入 Spring Boot Admin 做监控搜索词里有不少人在问 spring boot 实现监控都有哪些需求和功能。如果你做的是 AI 服务监控诉求会更集中工具调用成功率、平均耗时、模型报错数、SSE 连接数。最简单的方案是给 MCP Server 加上 actuator再配一个 Spring Boot Admin Server 来做界面展示。Spring Boot Admin 的核心功能包括服务注册发现、健康检查、指标面板、日志查看、线程栈查看。对 AI 服务来说我最常用的是指标面板和每次调用的耗时曲线。接入步骤就三步监控端加 spring-boot-admin-starter-server被监控端加 spring-boot-admin-starter-client 和 spring-boot-starter-actuator被监控端配置 spring.boot.admin.client.url。再配合 Micrometer 统计工具调用次数比如定义 Counter 指标 mcp_tool_call_total在工具方法入口 counter.increment()这样每次审核调用都能在监控面板上看到。这套组合不需要写什么花哨代码但排查问题时非常靠谱。模型返回了错误、SSE 连接断了、工具报错了都在面板上一眼能看到。6. 常见问题与排查实录这些坑我都替你踩过6.1 六个高频问题速查表我在实际跑这个项目时把踩过的坑和网上常见的问题整理成了一张表现象可能原因排查方向服务启动了但客户端连不上sse 端点路径不对或 context-path 叠加重了检查配置与实际访问 URL先用 curl 打 /mcp 看响应模型始终不调用工具工具 description 太模糊或模型不支持 function calling优化描述换支持工具调用的模型工具能调用但参数全是空的方法参数名和模型传参不一致或参数类型太复杂参数用 String、integer 等简单类型避免自定义对象SSE 连接一会儿就断代理服务器超时或服务端返回间隔过长调长网关超时配置 keep-alive加心跳客户端版本比服务端版本新工具协议版本不匹配统一 SpringAI 版本尽量用同一 BOM 管理中文参数乱码请求编码问题检查启动参数 -Dfile.encodingUTF-8 和 HTTP 字符集这张表不算完整但覆盖了我遇到的八成问题。每一条都是项目现场里真实出现过的尤其是“模型不调用工具”大多数时候问题不在模型而在你给工具写的描述和参数说明。6.2 工具描述写的不好模型就是“看不见”你的工具有个现象很典型你明明注册了审核工具模型却对你说“我无法审核内容建议联系人工”。这时候不要怀疑代码九成是工具描述有问题。模型读工具说明时就像一个人在看一叠需求文档。文档写得清楚它知道什么时候该用文档写得含糊它会直接跳过。我总结的 description 模板是这样的第一部分说明工具用途和适用场景第二部分说明每个参数的含义、取值格式第三部分说明返回值的结构第四部分写上“仅在用户提出 XX 需求时调用”。你把它想成面试的自我介绍一个工具一个自我介绍。别让模型在理解你的接口上浪费时间。6.3 工具内部别做大杂烩还有一个习惯性问题有人喜欢把多个能力塞进一个工具方法里。审核工具里顺手做了关键词统计订单工具里顺手算了用户等级。这样确实让工具数量减少了但问题很快暴露模型不知道什么时候该调用这个工具返回结果也变得很难解析。我后来给自己定了条规矩一个工具只做一件可以被清晰描述的事。如果审核和统计是两件事就拆成两个工具如果一个事儿确实需要两步那就用工作流的思路让模型连续调用两个工具。这个约束执行下来模型的调用准确率明显提升排查日志也轻松得多。工具数量变多一点不是问题每个工具都意义明确才是关键。7. 扩展思路把 MCP Server 接到真实业务系统里7.1 给多商户跨境商城加一个智能客服有些团队的项目是典型的 Spring Boot MyBatis 多商户跨境商城。这种商城天然适合 MCP Server。原因很简单买家的问题天南海北但底层数据就那几种——订单、物流、商品、售后。你把这些查询逻辑包装成工具比如 queryOrderByOrderNo、queryLogisticsByTrackNo、queryRefundStatus再把它们暴露成 MCP 工具客服助手就能自动查单、自动解释退款进度。商户端还能加一个 querySettlements 工具帮助商户快速看账单。这一套不用推翻原有业务系统只需要在商城服务里加一个 MCP Server 模块把已有的 MyBatis Mapper 方法包装成工具。这比重新开发一套 AI 客服系统节省太多成本。7.2 用 MCP 给就业推荐系统换一个“AI 大脑”基于 Spring Boot 的大学生就业推荐系统这类项目在毕设和企业内部系统里都很常见。传统做法大多是看个关键词匹配给出一堆专业对口的岗位用户还得自己一个个点进去看体验比较死板。我见过一个比较舒服的做法保留原有 Spring Boot 系统做数据管理和展示把推荐服务抽成一个独立的 MCP Server。这个 Server 里的工具负责按条件查岗位、按简历标签匹配、按薪资范围过滤。模型收到用户描述后先调用工具拿到候选岗位再用自然语言解释“为什么推荐这几个岗位”。这样原来很死板的推荐列表就变成了真正有解释的个性化建议用户的接受度也高很多。7.3 作为第三方接口对外暴露时和普通 HTTP 接口的区别很多公司会问既然已经有 REST 接口为什么要用 MCP Server我的看法是MCP Server 不是替代 REST 接口而是给 AI 模型用的接口格式。普通 HTTP 接口是给人调的字段和文档都要人去读MCP 工具是给模型读的描述和 Schema 都会被模型自动理解。如果你的业务接口要同时服务人和其他系统那就老老实实出 REST如果目标是让 AI 助手、Agent 能自动调用你的能力那 MCP Server 是更省事的选择。两者可以共存同一个 Spring Boot 应用完全可以既提供 REST Controller又暴露 MCP 端点只是各自服务于不同消费者。很多系统的做法是REST 接口服务前端MCP 工具服务智能助手互不干扰。我个人在实际项目中的体会是不要先入为主觉得 MCP 复杂也不要一开始就想把全部能力都暴露出去。先把一两个最有价值的业务能力做成工具跑通一条“模型调用工具→工具返回数据→模型生成结论”的链路团队理解了这套机制后再逐步扩大工具范围。MCP 解决的是连接标准化的最后一公里业务分析和模型提示词的质量还是得靠人一版一版调出来。后面再想多 Agent 协作、再想 AI Agent 搭建你手里这套基础地基就是最大的底气。
1. AI 服务开发最大的问题不是模型不够聪明而是“接进来”太难我见过太多 Java 团队评估 AI 落地的时候第一步就卡住了。模型 API 文档动辄几十页不同厂商的请求格式不统一要接入一个工具得自己写联网逻辑、解析模型返回值、维护会话上下文……明明只是想把“发送文本、拿到结果”这件事做对结果写出来的胶水代码比业务代码还多。这也是为什么 SpringAI MCP Server 这个组合一出来我就觉得方向对了MCP 负责把“工具调用”这件事标准化SpringAI 负责把 MCP 变成 Spring 生态里那种“加个依赖、写个配置”的体验。这句话翻译成人话就是以前你要让大模型帮用户查订单、审核内容你得自己去实现一套工具调用链路现在你只需要写一个普通方法加上 Tool 注解把它交给 SpringAI模型就能在回答问题时自动调用这个方法剩下的协议、传输、回调都由框架处理。这篇文章适合谁已经会用 Spring Boot 写接口、但还没接触过 AI 工程化的 Java 后端团队里准备做“AI 智能审核”“AI 客服”“AI Agent 搭建”的项目负责人想赶在 2025 年把 AI 能力真正落到业务系统里的开发者。我默认你了解 Spring Boot 的基本概念比如自动装配、starter、依赖管理。MCP 和 SpringAI 的细节我会从头讲保证你看完能照着搭。2. 别急着写代码MCP 的四个关键概念决定你后面是否踩坑2.1 Host、Client、ServerAI 应用里的“浏览器-网页-接口”MCP 的全称是 Model Context Protocol模型上下文协议。它解决的是一个大模型应用和外部数据源、外部工具之间“怎么聊天”的问题。在这个协议里有三个角色你要记住Host、Client、Server。Host 是模型真正运行在哪里、用户在哪个界面上操作的程序比如 Claude 桌面端、你自己的 Web 应用。Server 是你把业务能力暴露出来的程序比如一个提供“订单查询”“内容审核”能力的服务。Client 则是两者之间负责通信的组件它实现协议细节把 Server 暴露的工具列表同步给 Host再把 Host 的调用请求转发给 Server。我用一个类比来记Host 相当于浏览器Server 相当于一个网站的后端接口Client 相当于浏览器里的网络请求库。你上网时不会关心 HTTP 是怎么握手、怎么分包的同样模型调用你的工具时也不该关心你的服务是 Java 还是 Python、是在本机还是远程。协议标准化之后任何支持 MCP 的客户端都可以直接连接你暴露出来的能力。2.2 Tools、Resources、PromptsMCP 的三种能力原语MCP 协议定义了三种“能力原语”理解它们对后续设计特别重要。Tools 是带输入参数定义的函数。模型根据你的说明决定是否调用调用后拿到结构化结果继续生成回答。这是 MCP Server 最重要的能力也是本项目的核心。Resources 是提供给模型的只读上下文资源比如你有一份产品手册、一份规章制度可以当作资源注入让模型回答时自动参考。Prompts 是预设的提示词模板用户通过 Host 触发这些模板快速开始一个任务比如“审核这段文本”“生成周报”。我个人强烈建议先只用 Tools 起步把资源和提示词往后放。因为 Tools 的收益最直接而且 SpringAI 对工具调用的支持最成熟资源和提示词在不同客户端上的兼容性反而不如 Tools 稳定。你做 MCP Server 的第一阶段只需要关注工具列表够不够用、描述够不够清楚其他能力可以后面再补。2.3 为什么 SpringAI 选了 SSE 而不是 HTTP 短连接MCP 协议的传输方式主要有 stdio 和 HTTP。stdio 多用于本地进程比如本地桌面应用调一个脚本HTTP 多用于远程服务。在 HTTP 传输的基础上SpringAI 的 MCP Server 默认使用的是 SSE也就是 Server-Sent Events即服务端单向事件推送。为什么不直接用简单的 JSON 接口因为模型调用工具往往不是一次请求就能结束经常需要多轮对话而且大模型的生成是流式的你把结果打成一个大 JSON 返回用户在界面上还要傻等全部生成完。SSE 的好处是服务端可以持续推送客户端边接收边处理体验和效率都好得多。你把它理解成广播和点播的区别HTTP 短连接是点一次播一次SSE 是连上以后有内容就持续推送。明白了这些再看 SpringAI 的 MCP Server就清晰了它本质上是把一个 Spring Boot 应用变成 MCP 协议里的一个 Server通过 /mcp 这个 SSE 端点对外暴露能力。接下来聊设计你要先想清楚服务边界和技术选型这直接决定后面划分代码模块时痛不痛快。3. 项目设计与技术选型先想清楚你的 Server 该怎么“切”3.1 三种落地形态内嵌、独立网关、领域拆分动手之前先回答一个问题MCP Server 要单独建一个工程还是直接塞进现有业务系统根据我这段时间的经验有三种形态可以参考。第一种内嵌到现有 Spring Boot 应用里。比如你有一个商城系统直接在商城服务里加一个 MCP Server 配置把已有的订单、售后、物流 Service 方法暴露成工具。优点是省运维缺点是如果模型调用频率高工具调用会占用业务系统资源一个满负荷的 AI 调用可能把商城接口拖慢。第二种做一个独立的 AI 网关服务。所有 AI 相关能力集中放在这个服务里它既充当 MCP Server也充当 MCP Client连接多个模型和多个业务工具。这种形态适合已经有多个系统、需要统一治理 AI 入口的团队也是我推荐多数项目先采用的方案。第三种按领域拆成多个 MCP Server。审核一个 Server、客服一个 Server、推荐一个 Server各管各的工具客户端按需连接。优点是隔离性好缺点是部署维护成本高除非模型调用量已经大到单进程撑不住否则前期不用急着拆。我自己的选择是第二种起步。原因很现实AI 能力刚上线时调用量不大独立成一个网关服务不会影响现有业务的发布节奏后面如果某个领域突然爆量再把它拆出去也很快。你千万别一开始就追求完美架构MCP Server 拆来拆去最终只会把自己拆进流程里。3.2 技术栈与版本选择JDK 17 起步Spring Boot 3.x 是底线SpringAI 对底层的技术要求比较明确JDK 17 起步Spring Boot 3.2 以上最好直接上 3.3 或 3.4。原因是 MCP 的自动装配模块大量使用了 Spring Boot 3.x 的新基础设施很多类在 2.x 里根本不存在。模型接入方面我建议先用一个兼容 OpenAI 协议的大模型或本地模型比如 OpenAI、通义千问、Ollama 跑起来的 Qwen。SpringAI 的 model starter 会帮你把不同厂商的差异抹平你只管在配置里写 API Key 和模型名。版本选择是新手最容易翻车的地方。SpringAI 的版本迭代很快命名带有 M1、M6、GA 等后缀不同版本的配置项和 API 会有变化。我写这篇文章时以 1.0.0-M6 为例你在生产环境尽量选择已经 GA 的正式版本并锁定 BOM 版本不要偷偷升级。Spring AI 的里程碑版本发布在 Spring 官方仓库如果 Maven 拉不到依赖就要检查仓库地址有没有配对。3.3 模块划分别把工具代码和业务代码揉在一个包即使是单模块工程我也建议你把工具相关代码集中放在几个包里这样后续拆分独立服务时成本很低。我在项目里用的包结构是这样的com.example.mcpserver ├── config # MCP 配置、模型配置 ├── tool # 所有 Tool 方法集合 ├── service # 工具内部调用的业务服务 ├── client # MCP Client 配置或外部服务调用 └── model # 入参出参、DTO工具层只做“把模型传进来的参数翻译成业务调用”业务逻辑放 service这样你用单元测试测 service用集成测试测 tool职责清晰。很多项目后来代码一团乱就是因为审核逻辑、订单查询逻辑直接写在 Tool 方法体里一个方法几百行根本没法维护。到后面你手里有十几个工具的时候这种分层带来的好处会非常明显。4. 核心实现解析Tool 背后的自动装配是怎么转起来的4.1 一个 Tool 注解省掉了你手写 JSON Schema 的时间先看一个最简单的工具例子Component public class ContentAuditTool { Tool(description 审核用户发布的文本内容返回是否通过以及原因) public String audit(String content, String scene) { // 具体审核逻辑 return {\result\:\pass\,\reason\:\ok\}; } }这里最重要的不是那个方法体而是 Tool(description ...)。MCP 协议要求每个工具都有一份 JSON Schema描述方法名、参数、参数类型、说明。如果你手写 Schema既容易出错又和代码脱节。SpringAI 会在启动时用反射读取 Tool 注解、方法签名和参数的 javadoc自动生成这份 Schema。description 写得不好模型就根本不会调用你的工具。模型本质上是在读描述做选择描述写得像“审核文本并返回结果”这种含混的表述模型既不确定参数怎么填也不确定返回值长什么样。我建议描述里写清楚这个工具是干什么的、什么时候该调用、参数分别代表什么、返回结果是什么格式。宁可写长一点也别省。模型理解接口的方式和我们给同事写代码注释是一样的越清楚越好。4.2 ToolCallbackProvider把工具丢给 SpringAI 的更优雅方式SpringAI 官方推荐的注册方式不是把组件直接扫进来而是通过 ToolCallbackProvider 统一提供给 MCP Server 自动装配。Configuration public class McpToolConfig { Bean public ToolCallbackProvider auditTool(ContentAuditTool auditTool) { return MethodToolCallbackProvider.builder() .toolObjects(auditTool) .build(); } }这个方法返回的是一个 providerSpringAI 的 MCP Server 自动装配会扫描容器里的 ToolCallbackProvider把它提供的所有工具注册到 MCP Server 上。这样做的优势是你可以对一个 provider 里的工具做统一控制比如加载顺序、调试开关后续增加新工具不需要改自动装配逻辑只要保证新工具对象在 Spring 容器里能被找到。这里有个细节MethodToolCallbackProvider.builder().toolObjects(...) 接收的是对象实例不是 Class。如果你传了 ClassSpringAI 会尝试自己创建实例但这样一来工具类里面依赖的 service、repository 就注不进去了。你千万别把工具类在工具类里自己 new 出来一定要让 Spring 管理它再把这个实例传给 builder。4.3 Server 端自动装配从注解到 /mcp 端点项目引入了 spring-ai-starter-mcp-server 之后SpringAI 会做三件事创建 MCP Server 的核心对象扫描容器里的工具定义把协议端点暴露到 Web 层。默认情况下SSE 端点是 /mcp。Spring Boot 启动时自动装配会生成一个专门处理 MCP 协议请求的 Controller处理 /mcp 的 GET 请求建立 SSE 连接处理 POST 请求接收模型端的工具调用结果。配置项里可以调整端点路径spring: ai: mcp: server: sse-endpoint: /mcp如果你在网关前面又套了 context-path要注意路径千万别写重。曾有同事把 context-path 设为 /api又保留了默认的 /mcp结果客户端连了 /api/mcp工具就是调不通。原因就是没搞明白自动装配生成的端点是相对于 context-path 的路径拼接多了一层。改完路径后用 curl 直接访问端点看返回内容比用客户端排错快得多。4.4 Client 端接入HttpMcpTransport 一行搞定服务端只是故事的一半你总得有个地方让模型真的去调用这些工具。SpringAI 也提供了 MCP Client 的 starter连接远程 MCP Server 的方式非常简单var mcpClient McpClient.using( new HttpMcpTransport(http://localhost:8080/mcp) ).sync();HttpMcpTransport 是 SpringAI 内置的 HTTP 传输实现你只需要传 URL。调用 sync() 会得到一个同步版本的客户端可以直接用它列出工具、调用工具。要把这些工具接到模型上需要将 McpClient 的 toolCallback 合并进 ChatClient 的 defaultTools具体 API 在不同版本略有差异IDE 里会有提示。这个模式和你调用第三方 HTTP 接口很像你定义一个远程服务的地址拿到一个客户端对象之后所有协议细节都被封装了。差别在于这里“接口”不是你自己定义的 URL而是对方暴露的工具列表模型会动态决定调哪个。我调试 Client 端时经常打印工具列表确认连接是否正常这是最快验证服务端是否“活着”的方法。4.5 系统提示词配置与多 Agent 协作SpringAI 里配置系统提示词可以直接通过 ChatClient 的 builderChatClient chatClient ChatClient.builder(chatModel) .defaultSystem(你是内容安全审核助手只负责审核文本不要回答与审核无关的问题。) .build();搜索词里有人问 springai 系统提示词怎么配置答案就这么直接。但要注意系统提示词决定了模型的角色边界你要把“什么时候必须调用工具、什么时候不能调用工具”写进去。否则模型可能拿着一个不需要审核的问题也硬调工具或者需要审核的问题反而直接给出答案这会让日志很难看。比如你可以明确写“用户要求审核内容时必须调用 audit 工具其他闲聊直接回答不需要工具。”多 Agent 协作是另一个热门需求。你可以把多个 MCP Server 看成不同的“专家”比如审核专家、订单专家、推荐专家。在 Client 端把多个 Server 的工具都注册到同一个 ChatClient 里模型就会根据问题自己决定调用哪个专家。这种模式下每个 Server 保持轻量编排逻辑集中在客户端是目前实现 AI Agent 搭建成本比较低的方式。多个模型也可以各干各的一个负责理解意图一个负责生成回复Model 层由 SpringAI 统一管理你不用自己拼胶水代码。5. 实操记录从空目录跑出一个可用的 MCP Server5.1 Spring Initializr 初始化 IDEA 社区版的建项目流程很多新手卡在第一步用 IntelliJ IDEA 社区版建不了 Spring Boot 项目怎么办我直接讲我实际跑通的过程。社区版本身没有 Spring Initializr 向导但不影响你可以打开 start.spring.io在浏览器里选好参数然后下载 zip 解压再用 IDEA 社区版以普通 Maven 项目的方式打开。页面上的关键参数Project 选 MavenLanguage 选 JavaSpring Boot 选 3.x 最新稳定版Group 和 Artifact 按自己习惯填依赖先只加一个 Spring Web 和一个 Spring Boot Actuator。SpringAI 相关依赖后面手动加因为官方初始化页面不一定集成了最新的 SpringAI 版本。下载后解压IDEA 里 File - Open选中工程目录等 Maven 索引跑完。如果你本机 JDK 版本低于 17记得在 Project Structure 里把 SDK 切到 17 或 21不然编译会报错。这一步在社区版和旗舰版没有任何区别工具链一样用。5.2 依赖与配置仓库、BOM、端口修改要点SpringAI 的多数正式版本发布在 Maven 中央仓库里程碑版本在 Spring 官方的里程碑仓库里。为了稳定我建议直接锁定一个版本并配置 BOMdependencyManagement dependencies dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-bom/artifactId version1.0.0-M6/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement然后加两个核心依赖dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-starter-mcp-server/artifactId /dependency dependency groupIdorg.springframework.ai/groupId artifactIdspring-ai-starter-model-openai/artifactId /dependency如果你的模型走的是 OpenAI 兼容接口而不是官方 OpenAI记得在 application.yml 里把 base-url 指到自己的地址。端口修改也是新手常问的直接改 Spring Boot 的 server.port比如我本地 Client 端不想和 Server 端冲突就把 Client 端口设为 8181Server 设为 8080。配置示例server: port: 8181 spring: ai: openai: base-url: https://your-model-host api-key: ${AI_API_KEY} chat: options: model: gpt-4o mcp: server: sse-endpoint: /mcpAPI Key 别写死在配置文件里用环境变量引用这是所有项目都应该养成的习惯。仓库地址如果嫌 Maven 中央仓库慢可以在 pom 的 repositories 里加上 Spring 官方的 releases 仓库和 milestones 仓库需要哪个版本就配哪个不会冲突。5.3 第一个智能审核工具规则优先模型兜底我们以搜索词里反复出现的 springai 智能审核做一个完整案例。场景社区产品里用户每天要发大量帖子需要自动识别广告营销、辱骂攻击、联系方式泄露等违规内容。设计上我采用两层方案第一层用规则匹配快速拦截明确违规的词第二层用大模型对模糊内容做判断。规则层成本低、速度快、可解释模型层能处理规则覆盖不到的语义攻击比如变体词、谐音、间接暗示。代码结构Component public class ContentAuditTool { private final ChatClient chatClient; public ContentAuditTool(ChatClient.Builder chatClientBuilder) { this.chatClient chatClientBuilder.build(); } Tool(description 审核用户发布文本对广告、辱骂、联系方式泄露等风险内容进行判断返回结构化 JSON。) public String audit(String content, String scene) { if (ruleHit(content)) { return {\result\:\block\,\level\:\high\,\reason\:\命中规则词\}; } String prompt 你是内容安全审核员只做文本风险判断。 文本%s 场景%s 如果存在广告营销、辱骂攻击、联系方式泄露等风险输出 block否则输出 pass。 直接输出 JSON。 .formatted(content, scene); return chatClient.prompt().user(prompt).call().content(); } private boolean ruleHit(String content) { return content.contains(加V) || content.contains(转账) || content.contains(代开发票); } }核心点在于工具返回的一定是结构化 JSON模型拿到这个结果后才能把它编成一段自然的审核结论。你如果返回一串中文散文模型就不知道该往哪里放这段内容。还有一点要注意千万别在工具方法里直接做耗时很久的操作。模型调用工具通常有超时限制如果一个审核请求要等十几秒前端早就断了。耗时操作要么异步化要么做成快速反馈加后续回调别让用户等到怀疑人生。5.4 客户端联调看模型怎么自动把工具“调”起来服务端写好后我在客户端工程里模拟了一次完整调用。客户端也是一个 Spring Boot 应用加上 mcp-client 的依赖通过 HttpMcpTransport 连接服务端 8080 的 /mcp然后把工具注册到 ChatClientConfiguration public class McpClientConfig { Bean public ChatClient chatClient(ChatModel chatModel) { var mcpClient McpClient.using( new HttpMcpTransport(http://localhost:8080/mcp) ).sync(); return ChatClient.builder(chatModel) .defaultTools(mcpClient.getAllTools()) .build(); } }注意不同版本的 SpringAI 里获取工具的方法名略有不同有的版本是 getAllTools()有的版本是 listTools() 再转成 ToolCallback 列表你在 IDE 里按提示补全就行以你锁定的版本为准。联调时最直观的观察方式是打印模型和工具之间的整个调用过程。你发一句“请审核这句话加V领红包”模型应该先调用 audit 工具拿到 block 结果然后告诉你“这段话疑似广告已拦截”。从日志里你能看到工具参数、工具返回值和最终回答这时候才能真正理解什么叫“模型自动选择工具”。5.5 顺手接入 Spring Boot Admin 做监控搜索词里有不少人在问 spring boot 实现监控都有哪些需求和功能。如果你做的是 AI 服务监控诉求会更集中工具调用成功率、平均耗时、模型报错数、SSE 连接数。最简单的方案是给 MCP Server 加上 actuator再配一个 Spring Boot Admin Server 来做界面展示。Spring Boot Admin 的核心功能包括服务注册发现、健康检查、指标面板、日志查看、线程栈查看。对 AI 服务来说我最常用的是指标面板和每次调用的耗时曲线。接入步骤就三步监控端加 spring-boot-admin-starter-server被监控端加 spring-boot-admin-starter-client 和 spring-boot-starter-actuator被监控端配置 spring.boot.admin.client.url。再配合 Micrometer 统计工具调用次数比如定义 Counter 指标 mcp_tool_call_total在工具方法入口 counter.increment()这样每次审核调用都能在监控面板上看到。这套组合不需要写什么花哨代码但排查问题时非常靠谱。模型返回了错误、SSE 连接断了、工具报错了都在面板上一眼能看到。6. 常见问题与排查实录这些坑我都替你踩过6.1 六个高频问题速查表我在实际跑这个项目时把踩过的坑和网上常见的问题整理成了一张表现象可能原因排查方向服务启动了但客户端连不上sse 端点路径不对或 context-path 叠加重了检查配置与实际访问 URL先用 curl 打 /mcp 看响应模型始终不调用工具工具 description 太模糊或模型不支持 function calling优化描述换支持工具调用的模型工具能调用但参数全是空的方法参数名和模型传参不一致或参数类型太复杂参数用 String、integer 等简单类型避免自定义对象SSE 连接一会儿就断代理服务器超时或服务端返回间隔过长调长网关超时配置 keep-alive加心跳客户端版本比服务端版本新工具协议版本不匹配统一 SpringAI 版本尽量用同一 BOM 管理中文参数乱码请求编码问题检查启动参数 -Dfile.encodingUTF-8 和 HTTP 字符集这张表不算完整但覆盖了我遇到的八成问题。每一条都是项目现场里真实出现过的尤其是“模型不调用工具”大多数时候问题不在模型而在你给工具写的描述和参数说明。6.2 工具描述写的不好模型就是“看不见”你的工具有个现象很典型你明明注册了审核工具模型却对你说“我无法审核内容建议联系人工”。这时候不要怀疑代码九成是工具描述有问题。模型读工具说明时就像一个人在看一叠需求文档。文档写得清楚它知道什么时候该用文档写得含糊它会直接跳过。我总结的 description 模板是这样的第一部分说明工具用途和适用场景第二部分说明每个参数的含义、取值格式第三部分说明返回值的结构第四部分写上“仅在用户提出 XX 需求时调用”。你把它想成面试的自我介绍一个工具一个自我介绍。别让模型在理解你的接口上浪费时间。6.3 工具内部别做大杂烩还有一个习惯性问题有人喜欢把多个能力塞进一个工具方法里。审核工具里顺手做了关键词统计订单工具里顺手算了用户等级。这样确实让工具数量减少了但问题很快暴露模型不知道什么时候该调用这个工具返回结果也变得很难解析。我后来给自己定了条规矩一个工具只做一件可以被清晰描述的事。如果审核和统计是两件事就拆成两个工具如果一个事儿确实需要两步那就用工作流的思路让模型连续调用两个工具。这个约束执行下来模型的调用准确率明显提升排查日志也轻松得多。工具数量变多一点不是问题每个工具都意义明确才是关键。7. 扩展思路把 MCP Server 接到真实业务系统里7.1 给多商户跨境商城加一个智能客服有些团队的项目是典型的 Spring Boot MyBatis 多商户跨境商城。这种商城天然适合 MCP Server。原因很简单买家的问题天南海北但底层数据就那几种——订单、物流、商品、售后。你把这些查询逻辑包装成工具比如 queryOrderByOrderNo、queryLogisticsByTrackNo、queryRefundStatus再把它们暴露成 MCP 工具客服助手就能自动查单、自动解释退款进度。商户端还能加一个 querySettlements 工具帮助商户快速看账单。这一套不用推翻原有业务系统只需要在商城服务里加一个 MCP Server 模块把已有的 MyBatis Mapper 方法包装成工具。这比重新开发一套 AI 客服系统节省太多成本。7.2 用 MCP 给就业推荐系统换一个“AI 大脑”基于 Spring Boot 的大学生就业推荐系统这类项目在毕设和企业内部系统里都很常见。传统做法大多是看个关键词匹配给出一堆专业对口的岗位用户还得自己一个个点进去看体验比较死板。我见过一个比较舒服的做法保留原有 Spring Boot 系统做数据管理和展示把推荐服务抽成一个独立的 MCP Server。这个 Server 里的工具负责按条件查岗位、按简历标签匹配、按薪资范围过滤。模型收到用户描述后先调用工具拿到候选岗位再用自然语言解释“为什么推荐这几个岗位”。这样原来很死板的推荐列表就变成了真正有解释的个性化建议用户的接受度也高很多。7.3 作为第三方接口对外暴露时和普通 HTTP 接口的区别很多公司会问既然已经有 REST 接口为什么要用 MCP Server我的看法是MCP Server 不是替代 REST 接口而是给 AI 模型用的接口格式。普通 HTTP 接口是给人调的字段和文档都要人去读MCP 工具是给模型读的描述和 Schema 都会被模型自动理解。如果你的业务接口要同时服务人和其他系统那就老老实实出 REST如果目标是让 AI 助手、Agent 能自动调用你的能力那 MCP Server 是更省事的选择。两者可以共存同一个 Spring Boot 应用完全可以既提供 REST Controller又暴露 MCP 端点只是各自服务于不同消费者。很多系统的做法是REST 接口服务前端MCP 工具服务智能助手互不干扰。我个人在实际项目中的体会是不要先入为主觉得 MCP 复杂也不要一开始就想把全部能力都暴露出去。先把一两个最有价值的业务能力做成工具跑通一条“模型调用工具→工具返回数据→模型生成结论”的链路团队理解了这套机制后再逐步扩大工具范围。MCP 解决的是连接标准化的最后一公里业务分析和模型提示词的质量还是得靠人一版一版调出来。后面再想多 Agent 协作、再想 AI Agent 搭建你手里这套基础地基就是最大的底气。
