本文是"Spring AI 智能体实战"系列第 3/30 篇。项目采用 Java 17、Spring Boot 3.4.3 和课程示例所使用的 Spring AI 版本。不同 Spring AI 版本的依赖名称和部分 API 可能存在差异,请以自己项目的版本为准。
前言
理解模型地址、模型名称、温度参数和 API Key 的配置方式,并使用环境变量保护密钥。
本文将沿用同一个实战项目逐步完成相关功能。所有密钥均使用环境变量表示,复制代码后请在本地配置真实值,不要把 API Key 或数据库密码提交到代码仓库。
本文目标
-
理解本节功能解决的实际问题。
-
掌握关键配置、接口与代码结构。
-
完成可验证的运行结果,为下一节功能做好准备。
配置模型信息application.yaml
以openai为例,我们将application.properties修改为application.yaml,然后添加下面的内容:
key和base-url查看地址:https://bailian.console.aliyun.com/?tab=api#/api/?type=model&url=2868565
application.yaml
java
spring:
application:
name: gdcp-ai # 应用名称
ai:
openai:
api-key: ${OPENAI_API_KEY} # OpenAI API密钥
base-url: "https://dashscope.aliyuncs.com/compatible-mode" # OpenAI兼容模式的基础URL
chat:
options:
model: "deepseek-r1" # 使用的模型名称
temperature: 0.8 # 生成文本的随机性程度,值越高越随机
本文总结
完成 Spring AI 的模型连接配置;实际开发中只需要切换模型名称,即可对接兼容 OpenAI 协议的模型。
建议在进入下一篇之前亲自运行本文代码,并记录请求参数、控制台日志和最终响应。遇到问题时,优先检查依赖版本、模型名称、环境变量和包名是否一致。
下一篇预告
下一篇:Spring AI ChatClient详解:创建第一个AI客户端。