spring-ai-alibaba 1.0.0.2 学习（三）——配置

原创已于 2025-07-04 09:24:52 修改 · 1.3k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#人工智能 #spring #学习 #spring-ai #ai-alibaba

于 2025-06-29 21:53:14 首次发布

AI学习专栏收录该内容

85 篇文章

订阅专栏

与spring-ai接入的其他大模型一样，spring-ai-alibaba也有大模型的通用配置和个性化配置

最小化样例

我们如果想要进行模型配置，有三种方式

第一种：通过配置文件自动装配

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

通过上述配置，我们指定大模型型号为qwen-plus，生效的前提是在相关AutoConfiguration包中使用该属性进行了Bean属性声明

第二种：创建ChatClient时配置

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

第三种：调用大模型时配置

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

上述三种方法优先级依次提高，调用大模型时的配置最高，会覆盖其他配置

进阶知识

配置查找

那么知道了如何使用配置，我们如何确定spring-ai-alibaba中是否存在某个配置呢？

1）查看相关Options类

例如我们想对百炼大模型进行配置，找到DashScopeChatModel类中的配置类DashScopeChatOptions，可以查看其中有哪些配置项

但是此方法只适用于前面提到的第二种和第三种配置方法（defaultOptions和options），如果想要使用第一种配置方法（配置文件），如何找到类似spring.ai.dashscope.chat.options.model的配置名称？可以通过后面这两种方法

2）查看spring-configuration-metadata.json文件

我们可以查看相关AutoConfiguration包中的spring-configuration-metadata.json文件，该文件包含了此包用到的配置属性

例如，我们可以在spring-ai-alibaba-autoconfigure-dashscope包中的spring-configuration-metadata.json，通过搜索DashScopeChatOptions类找到spring.ai.dashscope.chat.options.model的配置

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

ps：双击shift，然后输入配置名也可以跳转到spring-configuration-metadata.json文件对应的位置

3）跟踪自动配置类

我们可以通过自动配置类的创建方法，跟踪其参数来源，结合ConfigurationProperties注解，确认其配置名称

例如，我们可以在spring-ai-alibaba-autoconfigure-dashscope包中的DashScopeChatAutoConfiguration类中找到百炼大模型DashScopeChatModel的创建方法，其入参中包含DashScopeConnectionProperties和DashScopeChatProperties两个参数类

DashScopeChatProperties上注解@ConfigurationProperties("spring.ai.dashscope.chat")表明其属性前缀为spring.ai.dashscope.chat，然后在其options属性中找到model，确认其最终配置名称为spring.ai.dashscope.chat.options.model

路线为：对应自动配置包 -> 对应自动配置类 -> 对应自动配置方法 -> 参数类 -> 注解+属性名