主题
Spring AI 文档
Spring AI —— 把 AI 能力融入 Spring 应用开发的抽象层 —— 的中文文档。
从这里开始
- AI 概念 —— 高层 AI 概念及其在 Spring AI 中的表示
- 入门 —— 创建你的第一个 AI 应用
- Spring AI API —— 各组件参考手册的入口
- ChatClient API —— 流式调用，含聊天记忆与 RAG
- 工具（函数调用） —— 让模型请求执行客户端的工具与函数
- 向量数据库 —— 各家实现与可移植 API
- MCP 概览 —— 模型上下文协议的 Spring 集成
- 可观测性 —— 为 AI 相关操作提供洞察
- AI 模型评估 —— 评估生成内容、防范幻觉
这是什么
Spring AI 项目旨在简化那些融入人工智能能力的应用的开发，且无需引入不必要的复杂性。
本项目的灵感来自 LangChain、LlamaIndex 等知名的 Python 项目，但 Spring AI 并非这些项目的直接移植。 项目的创立基于这样一个信念：生成式 AI 应用的下一波浪潮不会只属于 Python 开发者，而将遍及众多编程语言。
NOTE
Spring AI 应对 AI 集成的根本挑战：把你的企业数据与 API 连接到 AI 模型。
Spring AI 提供作为 AI 应用开发基础的抽象。 这些抽象有多种实现，从而能以极少的代码改动轻松替换组件。
Spring AI 提供以下特性：
- 跨 AI 服务商的可移植 API，覆盖聊天、文生图与嵌入模型。同时支持同步与流式两种 API 选择，也可访问模型特定能力。
- 支持所有主流 AI 模型服务商，如 Anthropic、OpenAI、微软、亚马逊、谷歌与 Ollama。受支持的模型类型包括：
- 结构化输出 —— 将 AI 模型输出映射为 POJO。
- 支持所有主流 向量数据库服务商，如 Apache Cassandra、Azure Vector Search、Chroma、Elasticsearch、GemFire、MariaDB、Milvus、MongoDB Atlas、Neo4j、OpenSearch、Oracle、PostgreSQL/PGVector、Pinecone、Qdrant、Redis、Typesense 与 Weaviate。
- 跨向量库服务商的可移植 API，含一套新颖的类 SQL 元数据过滤 API。
- 工具/函数调用 —— 允许模型请求执行客户端的工具与函数，从而按需访问必要的实时信息并付诸行动。
- 可观测性 —— 为 AI 相关操作提供洞察。
- 用于数据工程的文档摄取 ETL 框架。
- AI 模型评估 —— 帮助你评估生成内容并防范幻觉响应的工具。
- MCP（模型上下文协议） —— 为构建消费 MCP 服务端、或把基于 Spring 的服务暴露给 AI 生态的应用提供无缝集成。
- 面向 AI 模型与向量库的 Spring Boot 自动配置与 Starter。
- ChatClient API —— 与 AI 聊天模型通信的流式 API，风格上与 WebClient、RestClient API 相仿。
- Advisors API —— 封装反复出现的生成式 AI 模式，转换在语言模型（LLM）之间往返的数据，并在各种模型与用例间提供可移植性。
- 支持聊天对话记忆与检索增强生成（RAG）。
这套特性让你能实现诸如 “对你自己的文档做问答（Q&A）” 或 “与你的文档对话” 之类的常见用例。 后续各节以面向代码的方式，深入讲解每个组件与常见用例。
覆盖范围
| 分类 | 内容 |
|---|---|
| 入门与概念 | AI 概念、入门、升级说明 |
| 模型 API | 聊天、嵌入、文生图、音频转写、文本转语音、内容审核 |
| 应用模式 | ChatClient、Advisors、工具调用、结构化输出、RAG、聊天记忆、多模态、提示词 |
| 向量存储 | PGVector、Milvus、Qdrant、Chroma、Elasticsearch、MongoDB Atlas、Neo4j、Redis 等各家实现与元数据过滤 |
| 服务商 | OpenAI、Anthropic、Azure OpenAI、Amazon Bedrock、Google、Mistral AI、Ollama、Minimax 等 |
| MCP | MCP 客户端 / 服务端 / Spring 集成与入门指南 |
| 可观测性与评估 | 可观测性、LLM-as-a-Judge 评估、单元测试与 Testcontainers |
| 指南 | 动态工具发现、MCP 入门等专题 |
来源与许可
- 上游：Spring AI Reference
- 源仓库：spring-projects/spring-ai（文档位于
spring-ai-docs/src/main/antora/modules/ROOT/pages） - 上游许可：Apache-2.0
- 对齐版本：
2.1.0-SNAPSHOT - 本页「这是什么」一节译自官方
index.adoc，其余分区为本站整理
本站为非官方翻译站点，与 Spring、VMware 及其主体无隶属或背书关系。一切以官方英文原文为准。