（续）Spring AI Agent Utils 环境与配置 _ Spring Agent 工具库

Spring AI Agent Utils _ Spring Agent 工具库 ， 用Java开发 Agent 的全套工具集

https://blog.csdn.net/D1237890/article/details/160636082

Spring AI Agent Utils是一个基于Java开发的AI智能体工具库，为Spring AI应用提供Claude Code风格的智能体功能。该库0.7.0版本包含文件系统操作、Shell命令执行、Web搜索、任务管理等核心工具，支持可扩展的子智能体系统和技能模块。开发者可通过Maven依赖快速集成，利用其丰富的API构建复杂的智能体工作流。

该工具要求Java 17+和Spring Boot 3.x/4.x环境，与Spring AI 2.0.0兼容，适用于开发具有高级交互能力的AI应用。

<?xml version="1.0" encoding="UTF-8"?> <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <modelVersion>4.0.0</modelVersion> <groupId>org.springaicommunity</groupId> <artifactId>spring-ai-agent-utils</artifactId> <version>0.7.0</version> <name>spring-ai-agent-utils</name> <description>Spring AI Agent Utilities</description> <url>https://github.com/spring-ai-community/spring-ai-agent-utils</url> <organization> <name>Spring AI Community</name> <url>https://github.com/spring-ai-community</url> </organization> <licenses> <license> <name>Apache License 2.0</name> <url>https://www.apache.org/licenses/LICENSE-2.0</url> </license> </licenses> <developers> <developer> <name>Christian Tzolov</name> </developer> </developers> <scm> <connection>git://github.com/spring-ai-community/spring-ai-agent-utils.git</connection> <developerConnection>git@github.com:spring-ai-community/spring-ai-agent-utils.git</developerConnection> <url>https://github.com/spring-ai-community/spring-ai-agent-utils</url> </scm> <dependencies> <dependency> <groupId>org.springaicommunity</groupId> <artifactId>spring-ai-agent-utils-common</artifactId> <version>0.7.0</version> <scope>compile</scope> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>7.0.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.springframework.ai</groupId> <artifactId>spring-ai-client-chat</artifactId> <version>2.0.0-M3</version> <scope>provided</scope> </dependency> <dependency> <groupId>com.vladsch.flexmark</groupId> <artifactId>flexmark-html2md-converter</artifactId> <version>0.64.8</version> <scope>compile</scope> </dependency> </dependencies> </project>

Overview

Spring AI Agent Utils brings Claude Code-inspired tools and agent skills to Spring AI applications. This library reimplements core Claude Code capabilities as Spring AI tools, enabling sophisticated agentic workflows with file operations, shell execution, web access, task management, and extensible agent skills.

Spring AI Agent Utils为Spring AI应用带来了受Claude Code启发的工具与智能体技能。该库重构了Claude Code的核心功能作为Spring AI工具，支持文件操作、命令行执行、网络访问、任务管理等复杂智能体工作流，并具备可扩展的智能体技能体系。

Version: 0.4.0 • Requires Spring AI 2.0.0-SNAPSHOT or 2.0.0-M2

Quick Start

​

Add Dependency

<dependency> <groupId>org.springaicommunity</groupId> <artifactId>spring-ai-agent-utils</artifactId> <version>0.4.0</version> </dependency>

​

Configure Your Agent

ChatClient chatClient = chatClientBuilder // System prompt with environment context .defaultSystem(p -> p.text(agentSystemPrompt) .param(AgentEnvironment.ENVIRONMENT_INFO_KEY, AgentEnvironment.info()) .param(AgentEnvironment.GIT_STATUS_KEY, AgentEnvironment.gitStatus())) // Core Tools .defaultTools( ShellTools.builder().build(), FileSystemTools.builder().build(), GrepTool.builder().build(), GlobTool.builder().build(), SmartWebFetchTool.builder(chatClient).build(), BraveWebSearchTool.builder(braveApiKey).build()) // Task Management .defaultTools(TodoWriteTool.builder().build()) // Skills System .defaultToolCallbacks(SkillsTool.builder() .addSkillsDirectory(".claude/skills") .build()) // Sub-Agents .defaultToolCallbacks(TaskToolCallbackProvider.builder() .chatClientBuilder("default", chatClientBuilder.clone()) .subagentReferences(ClaudeSubagentReferences.fromRootDirectory(".claude/agents")) .build()) .build();

Core Tools

FileSystemToolsRead, write, and edit files with precise control:

FileSystemTools.builder() .allowedPaths(List.of("/project")) // Restrict access .build();

Operations:readFile,writeFile,editFile,listDirectory

ShellToolsExecute shell commands with timeout control and background process management:

ShellTools.builder() .defaultTimeout(Duration.ofMinutes(2)) .allowBackgroundProcesses(true) .build();

Features: timeout control, background execution, regex output filtering

GrepToolPure Java grep implementation for code search:

GrepTool.builder() .maxResults(100) .build();

Features: regex patterns, glob filtering, multiple output modes (content, files, count)

GlobToolFast file pattern matching:

GlobTool.builder().build();

Supports patterns like**/*.java,src/**/*.ts

​

SmartWebFetchToolAI-powered web content summarization with caching:

SmartWebFetchTool.builder(chatClient) .cacheDuration(Duration.ofMinutes(15)) .build();

​

BraveWebSearchToolWeb search with domain filtering:

BraveWebSearchTool.builder(braveApiKey) .maxResults(10) .build();

​

User Interaction

​

AskUserQuestionToolAsk users clarifying questions during agent execution:

AskUserQuestionTool.builder() .questionHandler(questions -> { // Display questions to user, collect answers return answers; }) .build();

Supports multiple-choice options and free-form input.

​

Task Management

​

TodoWriteToolStructured task management with state tracking:

TodoWriteTool.builder().build();

Track tasks with states:pending,in_progress,completed

​

TaskTools (Sub-Agents)Extensible sub-agent system for delegating complex tasks to specialized agents:

TaskToolCallbackProvider.builder() .chatClientBuilder("default", chatClientBuilder) .chatClientBuilder("haiku", haikuBuilder) // Multi-model support .subagentReferences(ClaudeSubagentReferences.fromRootDirectory(".claude/agents")) .skillsDirectories(".claude/skills") .build();

Features:

• Multi-model routing- Use different models for different sub-agents
• Pluggable backends- Claude-style, A2A protocol, or custom implementations
• Background task execution- Run sub-agents asynchronously
• Task output retrieval- Get results from background tasks

​

A2A Protocol SupportThe sub-agent architecture supports the A2A (Agent-to-Agent) protocol for interoperability with external agents:

// Custom A2A subagent integration (see subagent-demo example) public class A2ASubagentExecutor implements SubagentExecutor { @Override public String execute(TaskCall taskCall, SubagentDefinition subagent) { AgentCard agentCard = ((A2ASubagentDefinition) subagent).getAgentCard(); // Send message via A2A protocol Client client = Client.builder(agentCard) .withTransport(JSONRPCTransport.class, config) .build(); client.sendMessage(message); // ... } }

The extensible architecture uses three interfaces:

• SubagentResolver- Discovers and loads sub-agent definitions
• SubagentExecutor- Executes tasks on sub-agents
• SubagentDefinition- Describes a sub-agent’s capabilities

​

Agent SkillsExtend AI capabilities with reusable knowledge modules:

--- name: code-review description: Reviews code for best practices tools: [FileSystemTools, GrepTool] --- # Code Review Skill When reviewing code, check for: 1. Security vulnerabilities 2. Performance issues 3. Code style consistency ...

Load skills from directories:

SkillsTool.builder() .addSkillsDirectory(".claude/skills") .addSkillsDirectory("/shared/skills") .build();

​

AgentEnvironmentDynamic context utility for system prompts:

.defaultSystem(p -> p.text(systemPrompt) .param(AgentEnvironment.ENVIRONMENT_INFO_KEY, AgentEnvironment.info()) .param(AgentEnvironment.GIT_STATUS_KEY, AgentEnvironment.gitStatus()) .param(AgentEnvironment.AGENT_MODEL_KEY, "claude-sonnet-4-5") .param(AgentEnvironment.AGENT_MODEL_KNOWLEDGE_CUTOFF_KEY, "2025-01-01"))

Provides: working directory, platform info, git status, model information

​

Examples

​

Requirements

• Java 17+
• Spring Boot 3.x / 4.x
• Spring AI 2.0.0-SNAPSHOT or 2.0.0-M2

https://central.sonatype.com/artifact/org.springaicommunity/spring-ai-agent-utils