一、引言

与 Spring AI 接入的其他大模型类似，Spring AI Alibaba 提供了通用且灵活的配置方式，支持通过配置文件、代码初始化及运行时动态调整三种模式对接百炼平台大模型（如通义千问系列）。本文将深入解析其配置方法及注意事项。

---

二、最小化配置样例

1. 通过配置文件自动装配

在 application.yml 或 application.properties 中定义模型参数，例如指定模型型号为 qwen-plus：

spring.ai.dashscope.chat.options.model=qwen-plus

该配置生效的前提是相关 AutoConfiguration 类中已通过 @ConfigurationProperties 注解绑定属性 。

2. 创建 ChatClient 时配置

通过 ChatClient.Builder 在初始化时指定默认参数：

chatClient = builder.defaultOptions(
    DashScopeChatOptions.builder()
    .withModel("qwen-plus")
    .build()
).build();

此方式适用于全局默认配置，优先级高于配置文件 。

3. 调用大模型时配置

在具体调用时动态覆盖参数：

@GetMapping("/option")
public String chat(String input) {
    return chatClient.prompt()
        .options(
            DashScopeChatOptions.builder()
                .withModel("qwen-plus")
                .build()   
        )
        .user(input)
        .call()
        .content();
}

此方式优先级最高，可针对单次请求定制参数 。

---

三、进阶配置技巧

1. 查找可用配置项

方法一：查看 Options 类
例如，DashScopeChatOptions 类中定义了模型型号（model）、温度（temperature）等参数，适用于代码配置场景 。

方法二：查阅 spring-configuration-metadata.json
在 spring-ai-alibaba-autoconfigure-dashscope 包中，该文件列出了所有支持的配置项及其类型：

{
  "name": "spring.ai.dashscope.chat.options.model",
  "type": "java.lang.String",
  "sourceType": "com.alibaba.cloud.ai.dashscope.chat.DashScopeChatOptions"
}

通过 IDE 的搜索功能（如双击 Shift 输入配置名）可快速定位 。

方法三：跟踪自动配置类
以 DashScopeChatAutoConfiguration 为例，其方法参数包含 DashScopeChatProperties，通过 @ConfigurationProperties("spring.ai.dashscope.chat") 可推导出完整配置路径为 spring.ai.dashscope.chat.options.model。

---

四、常见问题与注意事项

1. 文档缺失问题

Spring AI Alibaba 的底层配置文档较少，部分功能仍需参考 Spring AI 的教程，开发者需结合源码或类比其他模型配置理解参数作用 。

2. API Key 配置陷阱

• 建议直接配置全局 API Key ：

spring.ai.dashscope.api-key=your_api_key

若仅配置 spring.ai.dashscope.chat.api-key，系统会报错提示 spring.ai.dashscope.audio.synthesis.api-key 未配置，即使未使用语音合成功能 。

• 禁用功能仍需配置 Key ：
  即使设置 spring.ai.dashscope.embedding.enabled=false，仍需提供 spring.ai.dashscope.embedding.api-key，否则会抛出异常 。

---

五、常用配置项详解

配置项	作用	默认值/取值范围
model	指定模型型号（如qwen-plus,qwen-turbo）	-
temperature	控制生成文本的随机性（0-2），数值越低输出越确定	0.85
top_p	与temperature类似，控制生成多样性	0.8
enable_search	是否启用联网搜索功能	false
enable_thinking	是否开启深度思考模式	false
responseFormat	响应格式（支持text或json_object）	{"type":"text"}

---

六、总结

Spring AI Alibaba 提供了多层次的配置能力，开发者可通过配置文件、代码初始化或运行时动态调整灵活对接百炼平台大模型。然而，由于文档缺失及部分配置约束（如 API Key 依赖），建议优先参考源码及自动配置类，并结合实际场景验证参数效果 。