Skip to content
Back to search

ai4j

Java 8+ agentic SDK: unified LLM access (OpenAI/Anthropic/DashScope/Doubao/DeepSeek...),unified AI service(image/video/audio...), Tool Calling, MCP, RAG, SKILLS,Agent Runtime, A2A, agent blueprint, agent harness, and a built-in Coding Agent CLI/TUI/ACP.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lnyo-cly--ai4j/badge.svg)](/listings/lnyo-cly--ai4j)

HTML

<a href="/listings/lnyo-cly--ai4j"><img src="/api/listings/lnyo-cly--ai4j/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- Gradle:`implementation 'io.github.lnyo-cly:ai4j:2.8.1'` - Maven:`<dependency><groupId>io.github.lnyo-cly</groupId><artifactId>ai4j</artifactId><version>2.8.1</version></dependency>`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 179 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center"><img src="https://capsule-render.vercel.app/api?type=waving&color=0:6A5ACD,100:2E86C1&height=180&section=header&text=ai4j&fontSize=46&fontColor=ffffff&animation=fadeIn&desc=Java%20AI%20Agentic%20SDK%20for%20JDK%208%2B&descAlignY=68" alt="ai4j banner" /></p>
  2. <p align="center">
  3. <a href="https://search.maven.org/artifact/io.github.lnyo-cly/ai4j"><img src="https://img.shields.io/maven-central/v/io.github.lnyo-cly/ai4j?color=2E86C1&label=Maven%20Central" alt="Maven Central" /></a>
  4. <a href="https://www.apache.org/licenses/LICENSE-2.0.txt"><img src="https://img.shields.io/badge/License-Apache%202.0-1F6FEB" alt="License" /></a>
  5. <img src="https://img.shields.io/badge/JDK-8%2B-2EA043" alt="JDK 8+" />
  6. <a href="https://lnyo-cly.github.io/ai4j/"><img src="https://img.shields.io/badge/Docs-GitHub%20Pages-0A7EA4" alt="Docs" /></a>
  7. <a href="https://deepwiki.com/LnYo-Cly/ai4j"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki" /></a>
  8. </p>
  9. <p align="center">
  10. <img src="https://img.shields.io/badge/Agentic-Enabled-6F42C1" alt="Agentic Enabled" />
  11. <img src="https://img.shields.io/badge/MCP-Supported-0F766E" alt="MCP Supported" />
  12. <img src="https://img.shields.io/badge/A2A-Supported-DC2626" alt="A2A Supported" />
  13. <img src="https://img.shields.io/badge/RAG-Built--in-B45309" alt="RAG Built-in" />
  14. <img src="https://img.shields.io/badge/CLI%20%2F%20TUI%20%2F%20ACP-Built--in-475569" alt="CLI TUI ACP Built-in" />
  15. </p>
  16. # ai4j
  17. 面向 **JDK 8+** 的 Java AI Agentic 开发套件:统一接入主流大模型服务,内置从工具调用、RAG、MCP、Skill、沙箱到 Agent 编排与长时任务治理的完整能力,支撑快速构建专属的 Agent 与 Harness 应用。
  18. [English README](README-EN.md)
  19. ## 核心优势
  20. - **统一接入 12+ 模型平台**:OpenAI、Anthropic、DeepSeek、智谱、豆包、Ollama 等由同一工厂提供服务;Chat / Responses / Messages 三套协议完整支持,Function Calling、SSE 流式原生具备;Embedding、Rerank、图像/音频/视频/音乐生成、实时对话等十类服务接口按需取用;切换平台仅需修改 `PlatformType`,多组 API Key 可并存并按名称路由。
  21. - **完整的 Agent 编排能力**:ReAct、CodeAct、Deep Research 三种执行模式,StateGraph 图编排支持条件分支与循环,subagent 委派与多智能体团队协作——从简单问答到多步研究型 Agent 均有现成实现。
  22. - **独创 `ai4j-harness` 长时运行 Harness**:使 Agent 从一次性调用转变为可暂停、可恢复、可验收的长期任务([详见专节](#ai4j-harness把-agent-变成可运维的长期任务))。
  23. - **内置完整 RAG**:文档加载(可选 Tika 解析 PDF/Word/Excel,或 MinerU 云端解析扫描件/公式/复杂版面为 Markdown)、切块、八大向量库适配(Pinecone / Qdrant / pgvector / Milvus / Redis / Elasticsearch / Chroma / InMemory)、混合检索、重排、引用标注,整条链路在 SDK 内实现,无需外挂检索框架。
  24. - **生态互联**:MCP 客户端与服务端(Stdio / SSE / Streamable HTTP 三种传输),既可调用外部工具,也可对外暴露自身能力;A2A 协议支持 Agent 间协作;并可反向接入 Dify / Coze / n8n 已有的 AgentFlow 编排,附带联网搜索增强。
  25. - **可控可观测**:沙箱执行、权限审批、Hook、Skill、记忆压缩策略、checkpoint 断点续跑、全链路调用追踪、事件溯源会话日志(可投影回放、fork 新会话、离线检索)——长任务的可控性与可观测性均为内置能力。
  26. - **开箱即用**:Spring Boot starter 单行配置即可注入 `AiService`;内置 Coding Agent 提供 CLI / TUI / ACP 三种入口;插件化扩展覆盖 Tool / Command / Skill / Prompt 四类扩展点,引入依赖不会自动启用。
  27. 此外还有 RAG 在线评估(LLM-as-judge)、提示词缓存、Agent Blueprint 声明式装配、确定性回放测试(`ai4j-testing` 录制回放 golden 夹具,无需真实密钥即可回归 Agent 行为)、TypeSafe System One(Jev)决策模型接入(`choice`/`score`/`noul` 并行求值,置信度门控路由与 Noul 护栏)、FlowGram 可视化工作流集成等——完整能力清单见[能力地图](docs-site/docs/getting-started/feature-map.md)。
  28. ## ai4j-harness:把 Agent 变成可运维的长期任务
  29. 常规 Agent 调用在一次返回后即结束;`ai4j-harness` 将其转变为**持久化、受治理、可恢复**的长期任务:
  30. - **可中断、可恢复**:任务状态持久化到 File/JDBC 存储,进程重启或迁移机器后可从断点继续执行
  31. - **多实例安全并行**:多个 worker 通过租约认领任务,避免重复执行;worker 故障时任务自动回到可认领状态
  32. - **"完成"不等于"验收"**:Agent 提交结果后须经评审与验收门禁方可视为完成,未通过则退回重做
  33. - **全程可审计**:任务依赖、事实、决策、证据均有台账记录,支持回放与追溯
  34. - **按任务类型定治理**:任务级 preset 让退款、查询等不同任务挂不同验收链;ACCEPTED 的 Decision 可经人工晋升为运行时规则(LEARN 回流),失败教训直接约束后续执行
  35. 适用于审批流、长链路业务编排、需要人工介入确认的自动化等场景。详见 [Harness 运行时](docs-site/docs/agent/harness-runtime.md)。
  36. ## 安装
  37. - Gradle:`implementation 'io.github.lnyo-cly:ai4j:2.8.1'`
  38. - Maven:`<dependency><groupId>io.github.lnyo-cly</groupId><artifactId>ai4j</artifactId><version>2.8.1</version></dependency>`
  39. ## 30 秒跑通
  40. 设置 `OPENAI_API_KEY` 后,下面代码即可发出第一条请求:
  41. ```java
  42. import io.github.lnyocly.ai4j.config.OpenAiConfig;
  43. import io.github.lnyocly.ai4j.platform.openai.chat.entity.ChatCompletion;
  44. import io.github.lnyocly.ai4j.platform.openai.chat.entity.ChatCompletionResponse;
  45. import io.github.lnyocly.ai4j.platform.openai.chat.entity.ChatMessage;
  46. import io.github.lnyocly.ai4j.service.Configuration;
  47. import io.github.lnyocly.ai4j.service.IChatService;
  48. import io.github.lnyocly.ai4j.service.PlatformType;
  49. import io.github.lnyocly.ai4j.service.factory.AiService;
  50. public class Ai4jFirstChat {
  51. public static void main(String[] args) {
  52. OpenAiConfig openAiConfig = new OpenAiConfig();
  53. openAiConfig.setApiKey(System.getenv("OPENAI_API_KEY"));
  54. Configuration configuration = new Configuration();
  55. configuration.setOpenAiConfig(openAiConfig);
  56. AiService aiService = new AiService(configuration);
  57. IChatService chatService = aiService.getChatService(PlatformType.OPENAI);
  58. ChatCompletion request = ChatCompletion.builder()
  59. .model("gpt-4o-mini")
  60. .message(ChatMessage.withUser("用一句话介绍 ai4j"))
  61. .build();
  62. ChatCompletionResponse response = chatService.chatCompletion(request);
  63. System.out.println(response.getChoices().get(0).getMessage().getContent().getText());
  64. }
  65. }
  66. ```
  67. 输出示例:
  68. ```
  69. ai4j 是一套面向 JDK 8+ 的 Java AI Agentic 开发套件,统一接入多种大模型服务,内置完整的 Agent 能力。
  70. ```
  71. > 换成 DashScope / DeepSeek / Ollama 等其他平台?只需替换 `PlatformType` 与对应 Config,其余代码不变。
  72. ## Spring Boot 接入
  73. ```xml
  74. <dependency>
  75. <groupId>io.github.lnyo-cly</groupId>
  76. <artifactId>ai4j-spring-boot-starter</artifactId>
  77. <version>2.8.1</version>
  78. </dependency>
  79. ```
  80. ```yaml
  81. ai:
  82. openai:
  83. api-key: ${OPENAI_API_KEY}
  84. ```
  85. ```java
  86. @Autowired
  87. private AiService aiService;
  88. ```
  89. 凭据也可不落盘:命名平台配置 `ai.platforms[].api-key-env` 声明环境变量名,装配期解析且优先于明文 key(见[服务入口配置](docs-site/docs/capabilities/service-entry.md))。详见 [Spring Boot 快速开始](docs-site/docs/integrations/spring-boot/quickstart.md)。
  90. ## Coding Agent CLI / TUI / ACP
  91. `ai4j-cli` 是开箱即用的本地 Coding Agent,而非单纯的 API 封装:提供交互式 CLI、TUI 界面、ACP(供 IDE 接入)三种入口。开发者也可将 `ai4j-cli` 作为依赖引入自有项目,在其基础上构建自己的 Coding Agent 应用——TUI 界面支持自定义配置。
  92. **安装**(需 Java 8+,脚本从 Maven Central 拉取 `ai4j-cli` 并生成 `ai4j` 命令):
  93. ```bash
  94. curl -fsSL https://lnyo-cly.github.io/ai4j/install.sh | sh # Linux / macOS / Git Bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 120 on GitHub
  95. irm https://lnyo-cly.github.io/ai4j/install.ps1 | iex # Windows PowerShell
  96. ```
  97. **三种入口**:
  98. ```bash
  99. ai4j code --provider openai --protocol responses --model gpt-5-mini --prompt "总结这个项目的结构" # one-shot / 交互式 CLI
  100. ai4j tui --provider zhipu --protocol chat --model glm-4.7 --base-url https://open.bigmodel.cn/api/coding/paas/v4 --workspace . # TUI
  101. ai4j acp --provider openai --protocol responses --model gpt-5-mini --workspace . # ACP,供 IDE 接入
  102. ```
  103. 能力:one-shot 与持续会话、provider profile 持久化(`~/.ai4j/providers.json`)、workspace model override、subagent / agent teams、session resume / fork / replay、skills 目录、MCP 对接、工具审批、后台 process 管理。
  104. 完整说明:[Coding Agent CLI 文档](docs/readme/zh/coding-agent-cli.md) · [快速开始](docs-site/docs/products/coding-agent/quickstart.md) · [总览](docs-site/docs/products/coding-agent/overview.md)
  105. ## 插件生态
  106. 插件是 ai4j 的代码级扩展点:可向 Agent / Coding Agent 注入新的**工具**(Tool)、**斜杠命令**(Command)、**Skill**、**Prompt** 四类内容。典型场景:
  107. - 把内部系统封装成 Agent 可调用的工具——查工单、读 CRM、调内部 API
  108. - 为 CLI/TUI 增加自定义命令——如 `/review`、`/deploy`
  109. - 实现 SDK 尚未内置的执行机制——如 [`ai4j-plugin-dynamic-workflow`](https://github.com/LnYo-Cly/ai4j-plugin-dynamic-workflow) 的动态工作流
  110. - 将「工具 + Skill + Prompt」打包成领域扩展包分发——他人引入一个 jar 即得整套能力
  111. 插件为普通 Maven jar:经 `ServiceLoader` 发现,由 `ExtensionRegistry` 三段门禁(discover → enable → exposeTool)控制启用——引入依赖不等于启用。每个插件由独立类加载器加载,apply 失败事务化回滚并清理类加载器;暴露的工具强制 `plugin__<id>__<tool>` 命名空间,插件间互不污染(隔离≠安全沙箱,详见扩展 SPI 文档)。
  112. | 插件 | 归属 | 说明 |
  113. |---|---|---|
  114. | `ai4j-plugin-ask-user` | 本仓 reactor | 官方样例插件 |
  115. | [`ai4j-plugin-dynamic-workflow`](https://github.com/LnYo-Cly/ai4j-plugin-dynamic-workflow) | 独立仓库 | 旗舰参考插件:动态工作流 |
  116. | 社区插件(如 `you-search`) | [LnYo-Cly/ai4j-plugins](https://github.com/LnYo-Cly/ai4j-plugins) | 社区维护、统一 Central 发布 |
  117. - 使用插件:[插件包与门禁](docs-site/docs/extending/plugins/plugin-packages.md)
  118. - 编写插件:[插件作者实战指南](docs-site/docs/extending/plugins/plugin-author-cookbook.md)
  119. - 向社区仓提交插件:见 [ai4j-plugins README](https://github.com/LnYo-Cly/ai4j-plugins#readme)
  120. ## 支持的平台
  121. OpenAI / OpenAI-compatible, Anthropic, DashScope(通义/百炼), Doubao(火山方舟/豆包), DeepSeek, Moonshot, Zhipu(智谱), Hunyuan(腾讯混元), Lingyi(零一万物), Ollama, MiniMax, Baichuan, Suno;Rerank(Jina / Ollama / Doubao);AgentFlow(Dify / Coze / n8n);VectorStore(Pinecone / Qdrant / pgvector / Milvus / Redis)。完整能力列表见 [feature-map](docs-site/docs/getting-started/feature-map.md)。
  122. ## 文档与链接
  123. ai4j 提供两个文档入口,按需取用:
  124. - **[官方文档站](https://lnyo-cly.github.io/ai4j/)**:中英双语,从 5 分钟跑通到各能力详解,配有大量与源码对齐的架构/时序图,适合系统学习和查 API 用法
  125. - **[DeepWiki](https://deepwiki.com/LnYo-Cly/ai4j)**:AI 问答式仓库导览,适合直接用自然语言提问——比如"某个功能是怎么实现的"、"如何用 ai4j-harness 开发某场景的专属 Agent",每周自动跟随仓库刷新
  126. 快速入口:
  127. - **新手起步**:[Java 快速开始](docs-site/docs/getting-started/quickstart-java.md) · [路径选择](docs-site/docs/getting-started/choose-your-path.md) · [能力地图](docs-site/docs/getting-started/feature-map.md) · [FAQ](docs-site/docs/reference/faq.md)
  128. - **模型调用**:[Chat](docs-site/docs/capabilities/models/chat.md) · [Responses](docs-site/docs/capabilities/models/responses.md) · [Messages](docs-site/docs/capabilities/models/messages.md) · [流式](docs-site/docs/capabilities/models/streaming.md) · [多模态](docs-site/docs/capabilities/models/multimodal.md) · [Function Calling](docs-site/docs/capabilities/tools/function-calling.md)
  129. - **检索与互联**:[RAG](docs-site/docs/capabilities/rag/overview.md) · [MCP](docs-site/docs/capabilities/mcp/overview.md) · [Skills](docs-site/docs/capabilities/skills/overview.md) · [A2A](docs-site/docs/agent/observability/a2a.md)
  130. - **Agent**:[Agent 总览](docs-site/docs/agent/overview.md) · [Agent 快速开始](docs-site/docs/agent/quickstart.md) · [Harness 运行时](docs-site/docs/agent/harness-runtime.md) · [多智能体团队](docs-site/docs/agent/orchestration/agent-teams.md)
  131. - **产品**:[Coding Agent CLI / TUI / ACP](docs/readme/zh/coding-agent-cli.md) · [FlowGram](docs-site/docs/products/flowgram/overview.md) · [插件开发指南](docs-site/docs/extending/plugins/plugin-author-cookbook.md)
  132. - **参考**:[排障指南](docs-site/docs/production/troubleshooting.md) · [生产检查清单](docs-site/docs/production/production-checklist.md) · [选型对比](docs-site/docs/reference/about/comparison.md) · [Releases](https://github.com/LnYo-Cly/ai4j/releases) · [CONTRIBUTING](CONTRIBUTING.md)
  133. ## License
  134. [Apache License 2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.