Java LLM 开发框架全景指南:Spring AI 与 Agents-Flex 全收录

1. 引言

过去两年，大语言模型（llm）已从实验室走向企业核心业务，chatgpt 的爆火引发了全球性的 ai 应用浪潮。在 python 生态中，langchain、llamaindex 等框架迅速崛起，成为构建 llm 应用的标配。然而，在企业级市场中，java 仍然是后端服务的主力语言——全球超过 90% 的财富 500 强企业运行着 java 系统。当这些企业希望将 llm 能力集成到现有微服务、数据管道和业务逻辑中时，直接在 java 侧开发 ai 应用就成为刚性需求。

本文将系统梳理当前主流的 java llm 开发框架——从 spring 官方的 spring ai，到社区最活跃的 langchain4j，再到国内轻量级新秀 agents-flex，同时涵盖 quarkus langchain4j、jai 等新兴力量。我们将深入解析它们的核心特性、编程模型、集成能力，并结合实际代码示例给出选型建议，帮助开发者在企业 ai 应用落地时做出最优选择。

2. java 做 llm 开发的现实需求

当企业尝试将 llm 集成到现有系统中时，面临的挑战远不止“调用一个 api”那么简单：

• 安全与合规：金融、医疗等行业要求数据不出内网，私有化部署是刚需；api 密钥管理、内容审核、审计日志缺一不可。
• 遗留系统集成：大量核心业务逻辑已经用 java 写成，重写成本极高。最务实的做法是在 java 服务中“嵌入” ai 能力。
• 性能与稳定性：java 虚拟机的成熟 gc、完善的监控体系（micrometer、prometheus）、强类型系统，让生产环境更可控。
• 团队技能栈：企业内部 java 开发者占据绝大多数，重新培训 python 的成本和风险往往难以承受。

这些需求催生了一批 java llm 框架，它们在以下维度上展开竞争：

• 统一模型接入：屏蔽 openai、azure、ollama、本地模型（如 vllm）等的差异，支持灵活切换。
• 链式调用与 agent：prompt 模板、多步推理链（chain）、工具调用（function calling）、记忆管理（memory）。
• rag（检索增强生成）：向量数据库（pinecone、milvus、elasticsearch）、文档解析、嵌入模型管理。
• 企业级特性：可观测性、安全、多租户、流式响应（sse/websocket）、aot 编译（graalvm 原生镜像）等。

下面我们逐一剖析当前最值得关注的框架。

3. spring ai（spring 官方的 ai 中间件）

spring ai 是 spring 官方推出的统一 ai 编程模型，目标是为 java 开发者提供类似 spring data、spring security 的 ai 抽象。它的设计哲学非常“spring”：通过自动配置和接口抽象，让开发者以最小的学习成本接入各类大模型。整个项目由多个子模块构成：spring-ai-core 定义核心接口，spring-ai-openai、spring-ai-ollama 等提供具体模型实现，spring-ai-pgvector-store、spring-ai-redis-store 等提供存储适配。

3.1 核心特性

• 多模型适配：通过 chatmodel 接口统一接入 openai、azure openai、ollama、anthropic、mistral ai、google vertex ai 等，只需切换依赖和配置。同时还支持图像生成（imagemodel）和语音转录（audiotranscriptionmodel）。
• prompt 模板：支持类似 stringtemplate 的占位符机制，可与 chatclient 配合使用，还内置了 prompttemplate 和 outputparser 的组合。
• 输出解析：可将 llm 响应自动转换为 bean 或 list<bean>，极大简化 json 解析，支持泛型类型。
• rag 支持：内置 vectorstore 抽象，支持 pinecone、weaviate、chroma、redis、postgresql（pgvector）等向量库；提供 questionansweradvisor、retrievalaugmentationadvisor 等 advisor 组件实现基于检索的问答。
• 函数调用：通过 @tool 注解将普通 java 方法暴露为 llm 工具，并由框架自动处理参数 json schema 的生成与解析。
• 可观测性：深度集成 micrometer 和 opentelemetry，可以监控 token 用量、延迟、错误率等指标，并提供 spring boot actuator 端点。
• spring boot 原生支持：提供一系列 starter，自动装配、属性绑定（application.yml 即可配置模型参数），与 spring 生态无缝融合。

3.2 示例：从对话到工具调用

依赖（pom.xml）：

<dependency>
    <groupid>org.springframework.ai</groupid>
    <artifactid>spring-ai-openai-spring-boot-starter</artifactid>
    <version>1.0.0-m8</version>
</dependency>

配置（application.yml）：

spring:
  ai:
    openai:
      api-key: ${openai_api_key}
      chat:
        options:
          model: gpt-4o-mini

代码：

@restcontroller
public class chatcontroller {
    private final chatclient chatclient;
    public chatcontroller(chatclient.builder builder) {
        this.chatclient = builder.build();
    }
    @getmapping("/chat")
    public string chat(@requestparam string message) {
        return chatclient.prompt()
                .user(message)
                .call()
                .content();
    }
}

若要启用函数调用，只需定义一个 @component 并注解方法：

@component
public class weathertools {
    @tool(description = "获取指定城市的实时天气")
    public string getweather(string city) {
        // 模拟调用天气 api
        return city + "：26℃，多云";
    }
}

然后在 controller 中注入 weathertools，并通过 .tools(weathertools) 将其绑定到 chatclient。spring ai 会自动将 getweather 方法的签名、参数说明和描述转换为 llm 可理解的 function schema，并在对话中自动决策是否调用该工具。

3.3 示例：基于向量库的问答（rag）

spring ai 的 rag 集成非常简单。以下示例使用 pgvector 作为向量存储，从文档中检索相关知识片断辅助模型回答。

依赖（额外添加）：

<dependency>
    <groupid>org.springframework.ai</groupid>
    <artifactid>spring-ai-pgvector-store</artifactid>
</dependency>
<dependency>
    <groupid>org.springframework.ai</groupid>
    <artifactid>spring-ai-tika-document-reader</artifactid>
</dependency>

代码：

@bean
public vectorstore vectorstore(jdbctemplate jdbctemplate) {
    return new pgvectorstore(jdbctemplate);
}
@restcontroller
public class ragcontroller {
    private final chatclient chatclient;
    public ragcontroller(chatclient.builder builder, vectorstore vectorstore) {
        this.chatclient = builder
            .defaultadvisors(new retrievalaugmentationadvisor(
                vectorstore, searchrequest.defaults()))
            .build();
    }
    @getmapping("/rag")
    public string rag(@requestparam string question) {
        return chatclient.prompt()
                .user(question)
                .call()
                .content();
    }
}

框架会在每次请求时自动根据 question 从向量库中检索相关文档，并将其注入 prompt 上下文，从而实现“带着教材回答”的效果。

3.4 适用场景与局限

spring ai 非常适合已有 spring 技术栈的团队，尤其是企业内部工具、数据查询类 chatbot、以及需要快速从 ai 中台接入多种模型的项目。但目前仍处于 1.0 里程碑之前的快速变化阶段，api 还不完全稳定，高级编排能力（如复杂有状态链、agent 多步规划、条件分支）较弱。如果你的场景需要自定义 agent 工作流（例如先检索再判断再调用工具再汇总），spring ai 当前的原生支持还不够灵活。

4. langchain4j（java 版的 langchain 生态）

langchain4j 是 langchain 在 java 社区的“精神继承者”，它试图将 python langchain 的核心概念（chain、tool、memory、rag）原汁原味地带入 java，同时融入 java 的强类型和同步/异步模型。它的模块化设计非常清晰：langchain4j-core 定义抽象，langchain4j-open-ai、langchain4j-ollama 等提供模型实现，langchain4j-elasticsearch、langchain4j-pinecone 等提供存储集成。

4.1 核心特性

• 丰富的模型适配：支持 openai、azure openai、google vertex ai、huggingface、ollama、claude 等 20+ 模型供应商，并且对国产模型（如智谱 ai、百度千帆）也有社区适配。
• 流式响应：通过 streamingchatmodel 和回调机制原生支持 sse（server-sent events），可以逐 token 推送给前端，提升用户体验。
• 结构化输出：借助 aiservices 将 llm 输出直接映射为 java 接口，通过动态代理生成实现，类似 retrofit 的风格。支持返回复杂对象、列表，甚至配合 json schema 约束。
• 链（chain）与路由器：提供 sequentialchain、routerchain、mapreducechain 等模式，支持多步骤 prompt 编排；用户可以自定义 chain 实现任意流程。
• 工具集成：支持声明式工具（@tool）和程序化注册（toolspecification），内置搜索引擎、数据库查询、文件系统等常用工具。
• 记忆管理：提供 chatmemory 和 chatmemorystore 抽象，支持 messagewindowchatmemory（滑动窗口）和 tokenwindowchatmemory，且可以持久化到数据库，适合长时间对话。
• 嵌入式 & 向量存储：支持多种 embedding 模型和向量存储（pinecone、milvus、elasticsearch、weaviate 等），并提供 contentretriever 和 retrievalaugmentor 构建检索链。
• ai gateway 兼容：可通过 langchain4j-ai-gateway 附加安全、限流、审计等功能，适合在企业中台统一管控。

4.2 示例：aiservices 结构化输出

依赖：

<dependency>
    <groupid>dev.langchain4j</groupid>
    <artifactid>langchain4j-open-ai</artifactid>
    <version>1.0.0-beta1</version>
</dependency>

定义接口：

public interface musicagent {
    @systemmessage("你是一个音乐推荐专家，请用不超过100字回答。")
    string recommendgenre(@v("mood") string mood);
}

使用：

openaichatmodel model = openaichatmodel.builder()
        .apikey(system.getenv("openai_api_key"))
        .modelname("gpt-4o-mini")
        .build();
musicagent agent = aiservices.create(musicagent.class, model);
string result = agent.recommendgenre("疲惫的周五");
system.out.println(result);

对于更复杂的工具调用，可以直接将方法返回值定义为工具的输出，langchain4j 会自动将接口方法注册为工具并使用模型的选择机制来决定是否调用。

4.3 示例：带记忆的对话链

langchain4j 的链式调用可以轻松加入记忆组件。以下例子演示了一个连续对话服务，能够记住之前的上下文。

chatmemory chatmemory = messagewindowchatmemory.withmaxmessages(10);
conversationalchain chain = conversationalchain.builder()
        .chatlanguagemodel(model)
        .chatmemory(chatmemory)
        .build();
string answer1 = chain.execute("我叫张三");
string answer2 = chain.execute("我叫什么名字？"); // 模型会记住“张三”

conversationalchain 内部会自动将历史消息按窗口大小附加到 prompt 中，无需手动拼接。

4.4 社区与成熟度

langchain4j 是目前 java llm 框架中 star 数最高、社区最活跃的项目之一（github 30k+）。它的迭代速度快，文档相对完善，示例丰富，且生态覆盖了主流的模型和向量库。适合希望从 python langchain 迁移到 java 的团队，也适合需要快速构建包含多种组件（数据库、文件、搜索引擎）的复杂 agent 应用。唯一的挑战是：框架版本还在快速演进中，偶尔会有 api 不兼容的情况，升级时需要关注 release notes。

5. agents-flex（轻量级、面向 agent 的框架）

agents-flex 是一个专注于 llm agent 编程的 java 框架，由国内开发者维护，设计目标是提供轻量、直观的 agent 编排体验，与 spring boot 深度集成。与 langchain4j 的“大而全”不同，agents-flex 刻意保持核心库的精简，强调“agent 优先”。

5.1 核心特性

• 声明式 agent 定义：通过 @agent、@tool 等注解快速构建 agent，支持异步和流式输出，且内置了对话管理。
• 灵活的任务编排：内置 agentchain（顺序执行）和 agentgraph（有向无环图），支持顺序、并行、条件分支等流程，可以构建复杂的多 agent 协作。
• 多模型支持：深度适配智谱ai、月之暗面、阿里百炼、ollama 等国内模型，也支持 openai 标准接口，模型切换非常简便。
• 记忆与上下文：提供 chatmemory 和可插拔的持久化方案（支持 redis、数据库等）。
• web 集成：提供 agents-flex-spring-boot-starter，内置 swagger 接口和 sse 通道，开箱即用。
• 轻量无侵入：核心依赖极小，可以与现有 mvc 项目快速整合，无需引入重量级依赖。

5.2 示例：构建一个带工具的多步 agent

依赖：

<dependency>
    <groupid>com.agentsflex</groupid>
    <artifactid>agents-flex-spring-boot-starter</artifactid>
    <version>1.0.0</version>
</dependency>

配置：

agents:
  flex:
    model: zhipu:glm-4
    api-key: ${zhipu_api_key}

定义工具：

@component
public class calculatortools {
    @tool(name = "计算器", description = "执行两个数的四则运算")
    public double calculate(string operand,
                            @toolparam(description = "操作符，支持+、-、*、/") string operator,
                            @toolparam(description = "第二个操作数") double b) {
        return switch (operator) {
            case "+" -> double.parsedouble(operand) + b;
            case "-" -> double.parsedouble(operand) - b;
            case "*" -> double.parsedouble(operand) * b;
            case "/" -> double.parsedouble(operand) / b;
            default -> 0.0;
        };
    }
}

agent 定义：

@agent(name = "math-agent", description = "数学助手",
       tools = calculatortools.class,
       prompt = "你是一个数学专家，需要利用计算器工具回答用户问题。")
@restcontroller
public class mathagent {
    @postmapping("/agent/chat")
    public mono<string> chat(@requestbody string input) {
        return agentsflex().chat(input)
                .onnext(system.out::println)
                .oncomplete(s -> "完成")
                .start();
    }
}

5.3 示例：使用 agentgraph 编排多 agent

对于更复杂的场景，可以用 agentgraph 将多个 agent 串联起来，形成工作流。例如：先用一个“意图识别 agent”判断用户问题类型，再路由给不同的专业 agent 处理。

agentgraph graph = new agentgraph();
graph.addnode("intent", intentagent);
graph.addnode("weather", weatheragent);
graph.addnode("calculator", mathagent);
graph.addnode("fallback", fallbackagent);
graph.addconditionaledge("intent",
    ctx -> ctx.getlastoutput().contains("天气") ? "weather" : "calculator"
);
graph.addedge("weather", "fallback");
graph.addedge("calculator", "fallback");
graph.setentrypoint("intent");
string result = graph.execute("今天北京天气怎么样？");

这种图模式极大提升了 agent 应用的可组合性和复用性，而 agents-flex 的 api 设计让开发者无需理解复杂的 dag 底层实现即可快速搭建。

5.4 适用场景

agents-flex 非常适合需要快速构建 agent 化应用的小型团队，尤其是主要使用国内大模型生态的场景。它的学习成本低，注解驱动的方式与 spring 结合紧密，agentgraph 的设计也使其在多 agent 协作方面有一定优势。但框架整体成熟度略低于 langchain4j，生态和文档丰富度有待提升，对于需要深度定制链式逻辑的场景可能还需要更多轮子。

6. 其他值得关注的框架

6.1 quarkus langchain4j 扩展

quarkus 社区已提供对 langchain4j 的官方扩展，支持原生编译和响应式编程。它利用了 quarkus 的构建时特性，可以在 graalvm 中实现毫秒级启动和极低内存占用。适合对资源敏感、需要云原生 serverless 部署的场景。

6.2 java-langchain

一个纯 java 实现的 langchain 移植项目，目标是保持与 python langchain api 的高度一致，让熟悉 python 版的开发者可以几乎无痛迁移。但目前社区活跃度较低，尚未大面积流行，不建议在生产环境核心链路中使用。

6.3 阿里灵积 dashscope java sdk

阿里云灵积（dashscope）提供了官方 java sdk，允许直接调用通义系列模型（如通义千问、通义万相等），支持流式对话、工具调用、多模态等，虽非通用框架，但在阿里云生态中集成度很高，适合全栈使用阿里云服务的企业。

6.4 jai 与新兴框架

jai（java ai）是一个较新的项目，目标是定义一套类似 jpa 的标准化 ai api（jsr 风格），让不同的框架实现可以相互替换。目前还处于早期阶段，但值得关注。此外，像 semantic kernel for java（微软）、google gen ai java sdk 等官方 sdk 也在快速发展，它们虽不是框架，但在特定生态中提供了最直接的集成方式。

7. 框架对比与选型建议

下表从更多维度对主要框架进行对比：

选型建议：

• 如果你的团队以 spring boot 为技术底座，需要统一的 ai 中间件来对接多个模型，并且能接受 api 的短期波动，spring ai 是自然的选择。
• 如果你追求功能最全面的 llm 编排，需要复杂的链式调用、丰富的工具集成和最高的社区活跃度，langchain4j 当前综合实力最强。
• 如果你的项目偏向国内大模型，或者你希望用最轻量的方式快速构建多 agent 工作流，并且对注解驱动的方式情有独钟，agents-flex 值得尝试。
• 对于 quarkus 用户，优先考虑 quarkus langchain4j，可以获得更优的性能和原生编译支持。
• 若主要使用阿里云通义系列，可直接使用 dashscope java sdk，以获得最佳的兼容性和性能。

8. 总结

java llm 开发框架正从“有没有”走向“好不好”的阶段。spring ai 代表官方标准化力量，langchain4j 继承社区丰富经验，agents-flex 则展现了国内开发者的创新活力，而 quarkus、dashscope 等又在特定场景下提供了差异化优势。企业选型时，除了对比表格中的维度，还应结合自身的模型供应商绑定、基础设施现状、团队技能和长期维护成本进行决策。

展望未来，随着 llm 应用从“单模型对话”向“多 agent 协作 + 多模态”演进，java 框架必然要支持更复杂的推理链路、更灵活的模型路由以及跨语言互操作。我们甚至可能看到一个类似 jpa 的统一抽象层出现，让企业在不同框架之间更自由地迁移。但无论怎样，java 在 ai 应用落地中的工程优势会越来越明显。希望本文能帮助你在众多框架中找到最适合自己项目的那一个，并在企业 ai 化的浪潮中抢占先机。

到此这篇关于java llm 开发框架全景指南:spring ai 与 agents-flex 全收录的文章就介绍到这了,更多相关java llm 开发框架内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！