Repolode
LnYo-Cly

LnYo-Cly/ai4j

面向 JDK 8+ 的 Java AI Agent 开发套件,统一接入多家大模型,内置工具调用、MCP、RAG 与 Coding Agent。

Star
438
Fork
56
未关闭 Issue
4
最近提交
25天前

这是什么?

ai4j 是一套面向 Java 开发者的大模型应用与 Agent 开发 SDK,兼容 JDK 8 及以上版本。它通过统一工厂接口接入 OpenAI、Anthropic、DashScope、豆包、DeepSeek、智谱、Ollama 等十余个平台,Chat、Responses、Messages 三种协议均有支持,切换平台主要修改 PlatformType 与对应配置即可。Function Calling、SSE 流式输出,以及 Embedding、图像、音频、视频生成等服务也都在同一入口下提供。

在模型调用之上,项目提供 ReAct、CodeAct、Deep Research 等执行模式,StateGraph 图编排,subagent 委派与多智能体协作。RAG 链路涵盖文档加载、切块、多个向量库适配、混合检索与重排。MCP 客户端与服务端支持 Stdio、SSE、Streamable HTTP 三种传输,并支持 A2A 协议。Spring Boot starter 可直接注入 AiService。

仓库内还包含 ai4j-cli,这是一个可通过 CLI、TUI 或 ACP(供 IDE 接入)使用的 Coding Agent,也可作为依赖嵌入自有项目。插件机制允许以 jar 形式扩展工具、命令、Skill 与 Prompt,插件需经显式门禁才会启用。

核心功能

  • 01通过统一工厂接入多家大模型平台,支持 Chat、Responses、Messages 三种协议。
  • 02提供 ReAct、CodeAct、Deep Research 执行模式与 StateGraph 图编排。
  • 03内置 RAG 链路,包括文档解析、切块、多种向量库适配与重排。
  • 04支持 Stdio、SSE、Streamable HTTP 三种传输的 MCP 客户端与服务端,以及 A2A 协议。
  • 05提供 Spring Boot starter,少量配置即可注入 AiService。
  • 06内置 Coding Agent,可通过 CLI、TUI 或 ACP 使用。

适用场景

  • 在 Java 或 Spring Boot 后端中接入大模型对话、向量化或多模态生成。
  • 基于 Java 技术栈搭建面向内部文档的检索增强问答。
  • 通过 MCP 或自定义插件把内部系统封装为 Agent 可调用的工具。
  • 在终端中运行本地 Coding Agent,或将其嵌入自有 Java 工具。

快速上手

  1. 1

    在项目中添加 Maven Central 依赖

    implementation 'io.github.lnyo-cly:ai4j:2.8.1'
  2. 2

    将 OpenAI API 密钥设置为环境变量

    export OPENAI_API_KEY=your-api-key
  3. 3

    使用 README 示例创建第一个聊天程序并运行

使用前须知

  • 30 秒示例需要 OpenAI API 密钥,或改用其他已配置的平台。

收录于专题

标签

常见问题

ai4j 是什么?
面向 JDK 8+ 的 Java AI Agent 开发套件,统一接入多家大模型,内置工具调用、MCP、RAG 与 Coding Agent。 ai4j 是一套面向 Java 开发者的大模型应用与 Agent 开发 SDK,兼容 JDK 8 及以上版本。它通过统一工厂接口接入 OpenAI、Anthropic、DashScope、豆包、DeepSeek、智谱、Ollama 等十余个平台,Chat、Responses、Messages 三种协议均有支持,切换平台主要修改 PlatformType 与对应配置即可。Function Calling、SSE 流式输出,以及 Embedding、图像、音频、视频生成等服务也都在同一入口下提供。
ai4j 可以免费使用吗?用的什么许可证?
ai4j 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
ai4j 还在维护吗?
活跃维护中。ai4j 最近一次提交是在 2026年10月13日。
ai4j 适合用来做什么?
在 Java 或 Spring Boot 后端中接入大模型对话、向量化或多模态生成。 基于 Java 技术栈搭建面向内部文档的检索增强问答。 通过 MCP 或自定义插件把内部系统封装为 Agent 可调用的工具。 在终端中运行本地 Coding Agent,或将其嵌入自有 Java 工具。
ai4j 怎么安装和运行?
在项目中添加 Maven Central 依赖: implementation 'io.github.lnyo-cly:ai4j:2.8.1' 将 OpenAI API 密钥设置为环境变量: export OPENAI_API_KEY=your-api-key 使用 README 示例创建第一个聊天程序并运行
在哪里获取 ai4j?
源代码和安装说明在 GitHub 上:https://github.com/LnYo-Cly/ai4j

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目