spring-ai-agent-utils

在 Spring 应用里几行代码组装出会调工具的 AI 代理

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开发框架 🍴 复刻 149 🐛 待处理 46 👀 关注 12
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 673
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源免费库,无付费服务

项目预览

spring-ai-agent-utils 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开发框架
开发团队spring-ai-community
定价模式🏷️完全免费
价格说明开源免费库,无付费服务
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议Apache-2.0
主要语言Java
技术栈/模型agentic-patterns,ai-agents,ai-context-management,ai-tools,spring-ai
GitHub 星标★ 673
上线时间2026-01-08 00:00:00
代码更新2026-10-03
仓库体积8.5 MB
本站数据更新2026-11-03
维护状态维护中
收录时间2026-09-12
浏览次数1

项目介绍

spring-ai-agent-utils 是一个基于 Java 的 Spring AI 扩展库,把 Claude Code 中那些好用的工具与代理技能(agent skills)带进普通 AI 应用。它解决的核心问题是:用 Spring AI 搭建 Agent 时,文件读写、命令执行、上下文管理等通用能力往往要自己从零实现,重复且容易出错。该库提供一套开箱即用的工具集与代理模式,包括文件系统操作、Shell 命令执行、上下文压缩与记忆管理、子代理编排等,让开发者只需声明式配置即可组装出具备多步推理和工具调用能力的智能体。它面向 Java/Spring 生态,与 Spring AI 的 ChatClient、ToolCallback 等抽象无缝集成,适合企业级后端团队在已有 Spring 服务中快速嵌入 Agent 能力,而不必切换到 Python 技术栈。项目处于早期阶段,星标约 600,API 可能随 Spring AI 版本演进调整。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 673

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:进阶 约 30 分钟 部署方式:本地安装 4 步

环境要求

  • JDK 17+
  • Spring Boot 3
  • 模型服务密钥

安装与启动步骤

  1. 1加依赖

    把 Claude Code 风格的工具与技能带进 Spring AI 应用。

  2. 2注册工具

    按库的约定声明工具,注意参数描述要写清楚。

  3. 3接进 Spring 应用

    在配置里启用 agent 工具集,先跑一个只读工具验证。

  4. 4处理技能加载

    技能按描述匹配触发,观察是否按预期加载。

如何确认成功

应用能调用注册的工具并返回结果

注意事项

  • Java 生态的 agent 工具链仍在演进,接口可能变。
  • 工具幂等性要在实现里保证,模型可能重复调用。

核心亮点

  • 原生适配 Spring AI 的 ToolCallback 与 ChatClient,Java 团队无需引入 Python 运行时即可落地 Agent
  • 内置 Claude Code 风格的文件读写、Shell 执行、上下文压缩等工具,省去大量样板代码
  • 提供子代理与技能(skills)编排模式,便于把复杂任务拆成可复用的代理单元

不足之处

  • 项目处于早期,API 与模块划分可能随 Spring AI 版本快速变动,生产使用需锁定版本
  • 文档与示例相对有限,复杂编排场景的调试和最佳实践仍依赖阅读源码

适用场景

  • 在已有 Spring Boot 后端中嵌入能读写文件、执行命令的运维/研发助手
  • 构建需要多步推理和工具调用的企业知识问答或流程自动化 Agent
  • 为 Java 团队提供与 Python Agent 框架对等的本地化智能体开发底座

替代项目

LangChain4j、Spring AI、Semantic Kernel

同类项目推荐

sagents 开源

用 Elixir OTP 搭可监督、带人工审批的实时 AI Agent

Build interactive AI agents in Elixir with OTP supervision, middleware composition, ···

★ 279 2026-09-12
omni 开源

给AI编程代理的终端降噪,省token不丢信息

The one place for the skills, keys and memory of every agent you use. Formerly OMNI.

★ 380 2026-08-09
langchain-postgres 开源

用现有 Postgres 跑 LangChain,少搭一套向量库

LangChain abstractions backed by Postgres Backend

★ 282 2026-09-25
connery-sdk 开源

用 TypeScript 快速构建 AI 插件和动作,打通 LLM 与外部 API。

The open-source SDK for creating AI plugins and actions

★ 293 2026-08-09
Agent-Framework-Samples 开源

照着跑,快速上手 Agent 开发

Agent Framework Samples - showcasing ways in which agent framework can be utilized.

★ 390 2026-08-09
SwiftStreamingMarkdown 开源

让 AI 回复边生成边渲染,告别等待完整 Markdown

A performant markdown library for iOS & macOS that supports streaming

★ 388 2026-08-09
js-genai 开源

官方 TS SDK,几行代码接入 Gemini 多模态与流式对话

TypeScript/JavaScript SDK for Gemini and Vertex AI.

★ 1698 2026-10-19
magentic 开源

用装饰器把大模型变成普通 Python 函数,调用即得结果

Seamlessly integrate LLMs as Python functions

★ 2428 2026-08-09
lingmengcan 开源

拖拽搭建AI应用,集成文生图与智能体工作流

AIGC Application Platform: Lingmengcan AI, large language model, aigc, stable diffus···

★ 53 2026-08-09