OCI GenAI 是 Oracle Cloud Infrastructure 提供的生成式 AI 服务它支持多种模型调用包括 向量模型Embedding Models。向量模型的核心作用是把文本转为高维向量坐标让语义相近的词在向量空间里“靠近”。1.引言大家好呀上个月我的同事老王在做一个企业内部智能客服项目结果客户老是抱怨说——“问问题搜不到答案”。比如用户问“怎么退款”知识库里却写的是“退费流程”关键词匹配完全歇菜。老王天天被怼最后找到我求救。于是我递给他一个“秘密武器”OCI GenAI 向量模型 SpringAI。没想到上线后客户直呼“哎哟这次客服终于聪明点了”今天这篇文章我就带大家从零开始手把手走一遍——如何在 SpringAI 中接入 OCI GenAI 向量模型。2.OCI GenAI 向量模型OCI GenAI 是 Oracle Cloud Infrastructure 提供的生成式 AI 服务它支持多种模型调用包括 向量模型Embedding Models。向量模型的核心作用是把文本转为高维向量坐标让语义相近的词在向量空间里“靠近”。举个例子“退款” 和 “退费” 的向量距离很近。“苹果水果” 和 “苹果公司” 的向量虽然字一样但语境不同向量表示能区分。所以 Embedding 模型特别适合企业知识库检索RAG检索增强生成语义搜索引擎SpringAI 对 OCI GenAI 向量模型做了封装你只需要轻量配置就能直接调用。是不是很丝滑3.先决条件要跑起来先准备好几样东西Java 17SpringAI 对 JDK 版本有要求。Spring Boot 3.2保证 Starter 能正常使用。OCI 账号和 API Key在 OCI 控制台 注册创建一个 API Key记下 tenancy/region 信息。Maven/Gradle 项目Spring Boot 工程方便依赖管理。准备齐全后就可以开干啦。4.添加存储库和 BOM在 pom.xml 里添加依赖这就相当于“准备锅碗瓢盆”等会就能下厨了。5.自动配置Spring Boot 最爽的就是自动配置。你只要在 application.yml 填好 OCI 的信息SpringAI 就会帮你自动装配好 Embedding Model启动后就能直接 Autowired 注入 OCI 的 Embedding 模型了。6.Embedding 属性配置参数主要分为三类连接、重试、模型。这些属性既能在配置文件里写死也能在代码里灵活调整。7.运行时选项如果你想在运行时切换不同的 Embedding 配置可以使用 OCIEmbeddingOptions这种方式适合多租户、多模型动态切换场景。8.示例代码写一个最简单的 REST 控制器让大家直接调用访问返回的就是一串 1536 维的向量数组看似杂乱无章其实就是智能检索的数学基石9.手动配置有些小伙伴喜欢“搓 Bean”不依赖自动配置那也可以这样你就完全自己掌控配置灵活度更高。10.总结今天小米带大家从故事开场到完整技术实现一步步走完了 SpringAI 集成 OCI GenAI 向量模型 的实战了解了 Embedding 模型的作用。准备好先决条件。添加依赖和 BOM。通过自动配置快速上手。用表格梳理了配置属性。展示了运行时选项。写了一个 REST 控制器示例。最后补充了手动配置方案。一句话总结OCI GenAI 向量模型让搜索更聪明SpringAI 让接入更轻松。 如果你正在做企业搜索、知识库、RAG 系统快把这套组合武器拿去用吧