24 篇文档带有标签（标签：reference）

以源码视角导航 Agent Teams runtime：AgentTeamBuilder 字段如何映射到运行链、task board 状态机、team 工具面、持久化恢复与扩展点。

ai4j-agent 核心类源码导航图：按装配、运行、模型适配、工具、memory、workflow、subagent、team、trace 分层，给出该先读哪条线、按问题类型选入口。

用声明式 YAML 描述单 Agent 的模型、指令、工具、memory、compact、sandbox 与 workflow 参数，支持加载、校验与模板化，并由宿主提供依赖后创建可运行 Agent。

ai4j-agent 技术路线图：从 P0 运行内核（Session/Memory/Compact/Plugin/Permission）到 P1 Blueprint YAML、P2 Sandbox SPI、P3 Coding 沙箱路由、P4 CLI 与 P5 远端 Runner 的分阶段演进。

Versioned Javadoc entry points for each AI4J Maven module, indexed by capability for Core SDK, Agent, Coding Agent, and extension SPI Java types and signatures.

面向外部调用者的 task 控制面 contract：validate/run/report/result/cancel 五个 HTTP 入口、DTO 经 adapter 与 facade 的变形，以及真正改变外部行为的配置项。

讲透 ai4j 的 RAG 回答质量评判层：RagJudge SPI、内置 ChatRagJudge 的三维评分协议（faithfulness/contextRelevance/answerRelevance，temperature 0、json_object、容错解析、分数钳制 [0,1]）、RagOnlineEvaluator 如何把评判写进 RagTrace，以及它与离线 RagEvaluator 检索指标的分工。

区分 mcp-servers-config.json 里哪些字段真正进入 transport/client/gateway 运行时，哪些只是治理元数据，避免把字段存在误写成能力已生效。

按 ai.* 能力面前缀梳理 AI4J 的 Spring Boot 配置，说明单实例与多实例注册表配置的流向与分层判断。

AI4J 功能地图：用成熟度标记（stable/advanced/preview/experimental）列出每个能力的状态、所属模块、适合场景与继续阅读入口，帮助按需取用最小模块。

把 AI4J 历史 CSDN 博客文章映射到结构化文档，方便持续维护与版本同步。覆盖 Spring Boot + OpenAI 快速接入、DeepSeek/Qwen/Llama 本地模型接入等历史内容与对应新文档路径。

AI4J 的发布 artifact、Maven 坐标与 BOM 版本对齐策略，说明各模块角色、依赖引入方式与版本升级顺序。

维护者把 AI4J 发布到 Maven Central 与 GitHub Release 的前后检查清单，覆盖版本策略、本地验证与发布后核对。

汇总 Coding Agent 已实现的高频 slash 命令（provider/model/mcp/session/process/team/compact 等）的作用域、常用参数与 CLI/TUI/ACP 三种宿主的命令可见性差异。

AI4J 文档站常见问题收敛：第一次该看哪里、SDK 与 AI 基座的关系，以及 Chat/Responses、Function Call/Tool、MCP/Agent、Skill/Tool、ACP/MCP 等概念辨析与路径判断。

以 AiService 实现为准列出各 provider 对 Chat、Responses、Messages、Embedding、Rerank、Audio、Realtime、Image、Video、Music 的支持矩阵。

讲清插件发现与资源读取的两层内部 SPI：ExtensionLoader 接口允许用非 ServiceLoader 方式发现插件（默认 ServiceLoaderExtensionLoader 标注 Internal），ExtensionResourceResolver 公共助手按插件 classloader -> TCCL -> resolver classloader 顺序读取 classpath 文本资源并隔离各插件 jar，以及发现之后 ExtensionRegistry.list() 返回的检视投影 DiscoveredExtension（manifest + extension + enabled）。

AI4J 文档站的正式阅读地图：八个顶层分区各回答什么问题、每个能力的唯一入口在哪，以及旧链接如何自动跳转。

AI4J 文档核心术语统一表：定义 Agent、AiService、Chat、Coding Agent、Function Call、MCP、Memory、Skill、Responses、Tool Registry 等关键概念，避免跨专题混淆。

AI4J 的版本评估与升级前检查：基线、模块兼容矩阵、Java 8 兼容说明、provider 能力差异与升级顺序建议。

AI4J 接入真实项目前的上线检查清单。不要求一次性启用所有能力，而是按已使用的模块确认风险边界：最小模块选择、密钥管理、网络隔离、Tool 暴露、本地文件边界。

AI4J 文档站从旧 getting-started/ai-basics/guides 结构收敛到按模块组织的 canonical 结构。说明迁移规则：不直接删除强内容、先迁稳定结论、加 legacy notice、以 sidebar 为正式阅读路径。

讲清 Coding Agent 配置的三层（全局 provider 资产、全局 MCP 定义、工作区绑定）、逐字段求值优先级，以及哪些改动会触发当前 session runtime 重绑。

ai4j-agent 事件流上的四层生产能力逐个讲透：节点 I/O 捕获与重放（IoCaptureAgentListener/NodeReplayer/NodeIoRecord）、resume-cache 故障恢复（ResumeCache/ResumableModelClient/ResumableToolExecutor，内容寻址、副作用不重放）、持久化 session store、以及 SHA-256 哈希链防篡改审计（HashChainedEventLog）。