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
在项目中添加 Maven Central 依赖
implementation 'io.github.lnyo-cly:ai4j:2.8.1' - 2
将 OpenAI API 密钥设置为环境变量
export OPENAI_API_KEY=your-api-key - 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 数据每日更新。
相关项目
基于 Java、LangChain4j、Spring Boot 与 Vue 3 的开源 AI Agent 应用平台,整合模型、智能体、RAG、Skills、MCP 与智能问数。
一个 Python 库和命令行工具,让 OpenAI、Anthropic、Ollama、LMStudio 等模型通过自然语言调用 MCP 服务器上的工具。
基于 TypeScript 的开源智能体框架,用于构建有状态的 LLM 智能体,内置编程智能体、CLI、Web UI 和 SDK。
开源免费的 AI Agent 设计原理与工程实践中文书,配有 109 个可运行实验与 PDF/EPUB 电子书。
面向 DeepSeek API 的 Java SDK,支持对话、函数调用、结构化输出,并提供 Spring Boot Starter。