Spring AI Agent Utils：为 Spring AI 应用提供 Claude Code 风格的工具与 Agent 技能

核心能力与快速开始

★ 640 · Java

能做什么

提供一组可组合的 Agent 工具与配套组件：AgentEnvironment 向系统提示注入运行时环境与 Git 状态；FileSystemTools 读写编辑文件；ShellTools 执行 shell 命令，支持超时控制、后台进程管理与输出正则过滤；GrepTool 为纯 Java grep 实现，支持正则、glob 过滤与多种输出模式；GlobTool 按 glob 语法匹配文件；SmartWebFetchTool 提供带缓存的 AI 驱动网页内容摘要；BraveWebSearchTool 支持带域名过滤的网页搜索；AskUserQuestionTool 在执行中向用户提出多选澄清问题；SkillsTool 用 Markdown + YAML front-matter 定义可复用、可组合的 Agent 技能；AutoMemoryTools 以沙箱目录下的类型化记忆文件（user、feedback、project、reference）配合 MEMORY.md 索引实现跨对话长期记忆，AutoMemoryToolsAdvisor 可将记忆工具与配套系统提示自动接入 ChatClient 请求管线并支持记忆整合触发；TodoWriteTool 提供带状态跟踪的结构化任务管理；TaskTools 提供可扩展子 Agent 体系，支持多模型路由与可插拔后端（含 Markdown 定义的本地子 Agent、A2A 协议远程子 Agent、Docker ExecBackend 沙箱执行）。项目按 common、core、a2a、bom 等 Maven 模块拆分，并提供代码助手、问答、技能、子 Agent、待办、记忆等多个示例工程。

适用场景

适用于在 Java / Spring Boot 项目中构建 AI Agent 应用，例如开发具备文件操作、命令执行与代码检索能力的 AI 编程助手；通过 SkillsTool 将领域知识封装为可复用技能模块并按需加载；借助 TaskTools 将复杂任务拆解并委派给具备不同工具子集的专用子 Agent，或通过 A2A 协议调用远程 Agent；使用 AutoMemoryTools / AutoMemoryToolsAdvisor 让 Agent 在多次会话间保留用户偏好、反馈与项目上下文；结合网页抓取与搜索工具为 AI 应用补充实时信息；使用 TodoWriteTool 跟踪多步骤任务进度，或用 AskUserQuestionTool 在执行过程中向用户确认需求。

项目形态

开发框架

部署方式

以 Maven 依赖形式集成，可通过 BOM（spring-ai-agent-utils-bom）统一管理版本，或直接引入 spring-ai-agent-utils 核心库；源代码可直接 mvn clean install 构建，示例工程可用 mvn spring-boot:run 运行。运行 Agent 应用的具体环境与部署方式 README 未详细说明。

主要依赖

Java 17+；Spring Boot 3.x / 4.x；Spring AI 2.0.0 或更高版本（README 中另有一处提示的 Spring AI 版本号为空）；Maven 3.6+。使用 BraveWebSearchTool 需要提供 BRAVE_API_KEY。

使用限制

材料未说明各工具的完整功能边界、工具与模型的具体兼容性、Brave 搜索等外部 API 的配额与费用、性能表现及生产环境可用性；项目自述为对 Claude Code 能力的重新实现与演示，未说明稳定性与支持周期。许可证为 Apache-2.0，但材料未说明其他商用条件与限制。

许可证

Apache-2.0

最近推送

2026-08-31 06:49

资料检查：2026-09-27 07:00 · 卡片整理：2026-09-27 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

在 Spring Boot / Spring AI 应用中构建具备工具调用与多 Agent 协作能力的 AI 应用，使用文件读写编辑、Shell 命令执行、Grep/Glob 代码搜索、网页抓取与搜索、结构化任务管理、子 Agent 编排、可复用 Markdown 技能模块以及跨会话长期记忆等能力，并参考 code-agent-demo 等示例工程实现 AI 编码助手。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证