spring-ai-community/spring-ai-agent-utils

解决的问题

Spring AI Agent Utils 提供了一套受 Claude Code 启发的预建工具与功能，让 Java 开发人员能够构建复杂的 AI 代理，与本地环境互动、管理任务并维护长期记忆。它弥补了高阶代理框架与 Spring AI 生态系统之间的差距，为代理作为编程助手或通用自主代理提供了必要的“技能”。

运作方式

该库实现了一套可注册至 Spring AI ChatClient 的工具。这些工具允许模型执行诸如读写文件、执行 Shell 指令、搜索网络以及管理结构化待办事项列表等操作。它还引入了一个子代理系统，用于将复杂任务委派给专业代理，以及一个使用沙盒文件存储来跨对话持久化信息的记忆系统。

目标对象

使用 Spring AI 并希望构建代理应用程序的 Java 开发人员，例如 AI 编程助手、自主任务管理器或具有可扩展知识模块的专业 AI 代理。

特色亮点

• 核心环境工具：包含 FileSystemTools、ShellTools、LgrepTool 和 GlobTool，用于与本地文件系统和 Shell 进行深度互动。
• 网络访问：整合 BraveWebSearchTool 和 SmartWebFetchTool，用于现实世界的信息检索。
• 长期记忆：AutoMemoryTools 和 AutoMemoryToolsAdvisor 提供持久的、基于文件的记忆，可在对话间保留。
• 代理编排：TaskTools 和 TodoWriteTool 实现了结构化的任务管理与委派给专业子代理的功能。
• 可扩展技能：SkillsTool 允许新增以 Markdown 定义并包含 YAML front-matter 的可重复使用知识模块。
• 可取消的回合：InterruptAdvisor 允许协作取消代理循环（例如通过停止按钮或预算防护）。
• 可观测性：ToolCallListener 为每次工具调用提供审计日志与指标。