AI4J 文档中心
AI4J 是一套面向 Java 8+ 的 AI SDK。它不是一个要求全量采用的 AI 平台，
而是一组可以按需取用的 Java AI building blocks：先拿 ai4j 跑通模型调用，
再按项目需要接入 Spring Boot、RAG、MCP、Agent、Coding Agent 或 FlowGram。
如果你只是想先跑通一个模型请求，可以从普通 Java 或 Spring Boot 快速开始。 如果你已经知道要做工具调用、RAG、MCP、Agent 或 Coding Agent，可以直接从功能地图进入。
先从这里开始
| 目标 | 推荐入口 | 你会得到什么 |
|---|---|---|
| 普通 Java 跑通第一条 AI 请求 | Java 快速开始 | 最小依赖、密钥配置、验证标准和第一条模型调用 |
| 普通 Java 项目先跑通 | Java 快速开始 | 最小依赖、配置和第一段调用代码 |
| Spring Boot 项目接入 | Spring Boot 快速开始 | starter、配置项和 Bean 注入方式 |
| 先看完整能力边界 | 功能地图 | AI4J 当前能力、成熟度和继续阅读路径 |
| 查正式文档路径 | 文档地图 | canonical 主线、legacy 来源和迁移方向 |
| 上线前检查 | 生产检查清单 | 版本、密钥、Tool、MCP、RAG、Agent、FlowGram 的检查项 |
| 理解为什么做 AI4J | 为什么选 AI4J | 项目定位、适合场景和与相邻方案的差异 |
用多少，取多少
你不需要一开始理解整个 AI4J，也不需要把所有模块都引入项目。更合理的方式是按当前问题取一个模块， 等需求变复杂后再升级到下一层。
| 你现在只想做什么 | 直接取用 | 什么时候再升级 |
|---|---|---|
| 调通模型、工具、RAG、MCP | ai4j | 需要容器化配置时再接 Spring Boot starter |
| 在 Spring Boot 应用里接 AI | ai4j-spring-boot-starter | 需要复杂状态或编排时再接 Agent |
| 做可嵌入的 Agent runtime | ai4j-agent | 需要代码仓任务时再接 Coding Agent |
| 做本地代码仓任务入口 | ai4j-coding + ai4j-cli | 需要产品化 CLI / TUI 时再扩展命令层 |
| 接 FlowGram 可视化工作流 | ai4j-flowgram-spring-boot-starter | 需要完整 demo 时再看 FlowGram demo |
| 多模块版本统一 | ai4j-bom | 项目同时引入多个 AI4J artifact 时使用 |
AI4J 覆盖哪些能力
AI4J 的能力分为三层。阅读时建议先把 Core SDK 跑通，再按项目需要向上升级。
| 层级 | 能力 | 入口 |
|---|---|---|
| Core SDK | Chat、Responses、流式、多模态、图像、音频、Embedding、Rerank | Core SDK / Model Access |
| 能力接入 | Function Call、本地工具、Skill、MCP | Tools、Skills、MCP |
| 数据增强 | Memory、Search、RAG、VectorStore、Ingestion、Hybrid Retrieval | Search & RAG |
| 应用集成 | Spring Boot starter、配置治理、自动装配 | Spring Boot |
| 上层运行时 | Agent、Coding Agent、FlowGram 工作流 | Agent、Coding Agent、FlowGram |
| 场景方案 | 常见组合方案和可复制集成路径 | Solutions |
| 生产准备 | 版本兼容、发布 artifact、安全、迁移、排障 | 版本兼容性、Security、排障指南 |
三个概念不要混在一起
AI4J 文档会刻意区分三类能力：
Function Call / Tool：让模型调用本地函数或受控工具。Skill：给模型按需读取的说明、模板、流程和经验资产。MCP：通过协议接入外部工具、服务或能力网关。
这三者可以组合，但职责不同。把边界讲清楚，是降低后续使用成本的关键。
仓库模块地图
| 模块 | 角色 |
|---|---|
ai4j/ | Core SDK：provider 接入、Chat、Responses、RAG、MCP、vector、image、audio、realtime |
ai4j-spring-boot-starter/ | Spring Boot 自动配置和应用侧接入 |
ai4j-agent/ | Agent runtime、workflow、trace、memory、team orchestration |
ai4j-coding/ | Coding Agent runtime、workspace 工具、outer loop、compaction |
ai4j-cli/ | CLI、TUI、ACP host 和本地会话入口 |
ai4j-flowgram-spring-boot-starter/ | FlowGram 集成、任务 API、trace bridge |
ai4j-flowgram-demo/ 与 ai4j-flowgram-webapp-demo/ | FlowGram 后端和前端 demo |
ai4j-bom/ | Maven 版本对齐 |
这些模块不是为了展示目录规模，而是为了让使用者只引入当下需要的能力，并保留向上升级的空间。
下一步建议：如果你还没跑过代码，直接看 Java 快速开始； 如果你想先判断 AI4J 是否适合自己的项目，看 为什么选 AI4J。