一、MiniMax 聊天

Spring AI 支持来自 MiniMax 的各种 AI 语言模型。您可以与 MiniMax 的语言模型进行交互，并基于 MiniMax 模型创建多语言对话助手。

二、先决条件

您需要创建一个 MiniMax API 密钥来访问其语言模型。

在 MiniMax 注册页面 创建账户，并在 API 密钥页面 生成令牌。

Spring AI 项目定义了一个名为 spring.ai.minimax.api-key 的配置属性，您应将其设置为从 API 密钥页面获取的 API 密钥值。

您可以在 application.properties 文件中设置此配置属性：

spring.ai.minimax.api-key=<您的-minimax-api-密钥>

为了在处理 API 密钥等敏感信息时增强安全性，您可以使用 Spring 表达式语言 (SpEL) 来引用环境变量：

# 在 application.yml 中
spring:
  ai:
    minimax:
      api-key: ${MINIMAX_API_KEY}

# 在您的环境或 .env 文件中
export MINIMAX_API_KEY=<您的-minimax-api-密钥>

您也可以在应用程序代码中以编程方式设置此配置：

// 从安全来源或环境变量获取 API 密钥
String apiKey = System.getenv("MINIMAX_API_KEY");

2.1 添加仓库和 BOM

Spring AI 工件发布在 Maven Central 和 Spring Snapshot 仓库中。请参阅 “工件仓库” 部分，将这些仓库添加到您的构建系统。

为了帮助管理依赖项，Spring AI 提供了一个 BOM（物料清单），以确保在整个项目中使用一致版本的 Spring AI。请参阅 “依赖管理” 部分，将 Spring AI BOM 添加到您的构建系统。

三、自动配置

Spring AI 的自动配置和 starter 模块的工件名称发生了重大变化。更多信息请参考升级说明。

Spring AI 为 MiniMax 聊天客户端提供了 Spring Boot 自动配置。要启用它，请将以下依赖项添加到项目的 Maven pom.xml 文件中：

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-model-minimax</artifactId>
</dependency>

或者添加到您的 Gradle build.gradle 构建文件中。

dependencies {
    implementation 'org.springframework.ai:spring-ai-starter-model-minimax'
}

请参阅 “依赖管理” 部分，将 Spring AI BOM 添加到您的构建文件中。

3.1 聊天属性

3.1.1 重试属性

前缀 spring.ai.retry 用作属性前缀，允许您为 MiniMax 聊天模型配置重试机制。

3.1.2 连接属性

前缀 spring.ai.minimax 用作属性前缀，允许您连接到 MiniMax。

3.1.3 配置属性

聊天自动配置的启用和禁用现在通过前缀为 spring.ai.model.chat 的顶级属性进行配置。

• 要启用：spring.ai.model.chat=minimax（默认已启用）。

• 要禁用：spring.ai.model.chat=none（或任何不匹配 minimax 的值）。

此项更改是为了支持配置多个模型。

前缀 spring.ai.minimax.chat 是用于配置 MiniMax 聊天模型实现的属性前缀。

您可以覆盖聊天模型实现的通用属性 spring.ai.minimax.base-url 和 spring.ai.minimax.api-key。如果设置了 spring.ai.minimax.chat.base-url 和 spring.ai.minimax.chat.api-key 属性，它们将优先于通用属性。如果您想为不同的模型和不同的模型端点使用不同的 MiniMax 账户，这将非常有用。

所有以 spring.ai.minimax.chat.options 为前缀的属性都可以在运行时通过向 Prompt 调用添加请求特定的“运行时选项”来覆盖。

四、运行时选项

MiniMaxChatOptions.java 提供了模型配置，例如要使用的模型、温度、频率惩罚等。

在启动时，可以通过 MiniMaxChatModel(api, options) 构造函数或 spring.ai.minimax.chat.options.* 属性来配置默认选项。

在运行时，您可以通过向 Prompt 调用添加新的、特定于请求的选项来覆盖默认选项。例如，为特定请求覆盖默认模型和温度：

ChatResponse response = chatModel.call(
    new Prompt(
        "生成 5 个著名海盗的名字。",
        MiniMaxChatOptions.builder()
            .model(MiniMaxApi.ChatModel.ABAB_6_5_S_Chat.getValue())
            .temperature(0.5)
        .build()
    ));

除了模型特定的 MiniMaxChatOptions，您还可以使用可移植的 ChatOptions 实例，该实例通过 ChatOptions#builder() 创建。

五、示例控制器

创建一个新的 Spring Boot 项目，并将 spring-ai-starter-model-minimax 添加到您的 pom（或 gradle）依赖项中。

在 src/main/resources 目录下添加一个 application.properties 文件，以启用和配置 MiniMax 聊天模型：

spring.ai.minimax.api-key=您的_API_密钥
spring.ai.minimax.chat.options.model=abab6.5g-chat
spring.ai.minimax.chat.options.temperature=0.7

请将 api-key 替换为您的 MiniMax 凭据。

这将创建一个 MiniMaxChatModel 实现，您可以将其注入到您的类中。以下是一个简单的 @Controller 类示例，该类使用聊天模型进行文本生成。

@RestController
public class ChatController {

    private final MiniMaxChatModel chatModel;

    @Autowired
    public ChatController(MiniMaxChatModel chatModel) {
        this.chatModel = chatModel;
    }

    @GetMapping("/ai/generate")
    public Map generate(@RequestParam(value = "message", defaultValue = "给我讲个笑话") String message) {
        return Map.of("generation", this.chatModel.call(message));
    }

    @GetMapping("/ai/generateStream")
    public Flux<ChatResponse> generateStream(@RequestParam(value = "message", defaultValue = "给我讲个笑话") String message) {
        var prompt = new Prompt(new UserMessage(message));
        return this.chatModel.stream(prompt);
    }
}

六、手动配置

MiniMaxChatModel 实现了 ChatModel 和 StreamingChatModel，并使用 低级的 MiniMaxApi 客户端连接到 MiniMax 服务。

将 spring-ai-minimax 依赖项添加到项目的 Maven pom.xml 文件中：

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-minimax</artifactId>
</dependency>

或者添加到您的 Gradle build.gradle 构建文件中。

dependencies {
    implementation 'org.springframework.ai:spring-ai-minimax'
}

请参阅 “依赖管理” 部分，将 Spring AI BOM 添加到您的构建文件中。

接下来，创建一个 MiniMaxChatModel 并将其用于文本生成：

var miniMaxApi = new MiniMaxApi(System.getenv("MINIMAX_API_KEY"));

var chatModel = new MiniMaxChatModel(this.miniMaxApi, MiniMaxChatOptions.builder()
                .model(MiniMaxApi.ChatModel.ABAB_6_5_S_Chat.getValue())
                .temperature(0.4)
                .maxTokens(200)
                .build());

ChatResponse response = this.chatModel.call(
    new Prompt("生成 5 个著名海盗的名字。"));

// 或者用于流式响应
Flux<ChatResponse> streamResponse = this.chatModel.stream(
    new Prompt("生成 5 个著名海盗的名字。"));

MiniMaxChatOptions 为聊天请求提供配置信息。MiniMaxChatOptions.Builder 是一个流畅的选项构建器。

6.1 低级 MiniMaxApi 客户端

MiniMaxApi 是一个轻量级的 Java 客户端，用于 MiniMax API。

以下是一个简单的代码片段，展示了如何以编程方式使用该 API：

MiniMaxApi miniMaxApi =
    new MiniMaxApi(System.getenv("MINIMAX_API_KEY"));

ChatCompletionMessage chatCompletionMessage =
    new ChatCompletionMessage("Hello world", Role.USER);

// 同步请求
ResponseEntity<ChatCompletion> response = this.miniMaxApi.chatCompletionEntity(
    new ChatCompletionRequest(List.of(this.chatCompletionMessage), MiniMaxApi.ChatModel.ABAB_6_5_S_Chat.getValue(), 0.7, false));

// 流式请求
Flux<ChatCompletionChunk> streamResponse = this.miniMaxApi.chatCompletionStream(
    new ChatCompletionRequest(List.of(this.chatCompletionMessage), MiniMaxApi.ChatModel.ABAB_6_5_S_Chat.getValue(), 0.7, true));

有关更多信息，请参阅 MiniMaxApi.java 的 JavaDoc。

6.2 网页搜索聊天

MiniMax 模型支持网页搜索功能。该功能允许您在网络上搜索信息，并将结果返回到聊天响应中。

有关网页搜索的详细信息，请参阅 MiniMax ChatCompletion 文档。

以下是一个简单的代码片段，展示如何使用网页搜索：

UserMessage userMessage = new UserMessage(
        "美国在 2024 年奥运会上总共获得了多少枚金牌？");

List<Message> messages = new ArrayList<>(List.of(this.userMessage));

List<MiniMaxApi.FunctionTool> functionTool = List.of(MiniMaxApi.FunctionTool.webSearchFunctionTool());

MiniMaxChatOptions options = MiniMaxChatOptions.builder()
    .model(MiniMaxApi.ChatModel.ABAB_6_5_S_Chat.value)
    .tools(this.functionTool)
    .build();


// 同步请求
ChatResponse response = chatModel.call(new Prompt(this.messages, this.options));

// 流式请求
Flux<ChatResponse> streamResponse = chatModel.stream(new Prompt(this.messages, this.options));

6.3 MiniMaxApi 示例

MiniMaxApiIT.java 测试提供了一些关于如何使用这个轻量级库的通用示例。

MiniMaxApiToolFunctionCallIT.java 测试展示了如何使用低级 API 调用工具函数。