Spring AI 2.0 中 ChatClient API 有哪些重要变化？ToolCallingAdvisor 的自动注册机制是如何工作的？

在 Spring AI 2.0 中，ChatClient API 有一些重要的变化，这使得 AI 应用的开发变得更加灵活和易于使用。其中，ToolCallingAdvisor 的自动注册机制是这次更新的一个显著特点。本文将详细介绍这些变化及其工作原理，并提供相关的 Java 代码示例。

重要变化

简化的 API 设计 :

Spring AI 2.0 中的 ChatClient API 经过重新设计，提升了易用性。通过引入 Fluent API 风格，开发者可以更直观地配置和使用 ChatClient。
支持多种 AI 供应商 :

新版本允许用户更加轻松地切换和配置不同的 AI 供应商，提高了灵活性。通过统一的接口，用户可以不需要修改大量代码就能进行切换。
增强的错误处理 :

处理 AI 交互中的错误变得更方便。ChatClient 在出错时提供了更多上下文信息，帮助开发者更快地定位和解决问题。
ToolCallingAdvisor 的自动注册机制 :

ToolCallingAdvisor 是一个新的组件，它通过自动注册机制来简化工具的调用和管理。借助 Spring 的依赖注入和 AOP (Aspect-Oriented Programming) 特性，ToolCallingAdvisor 可以根据注解自动侦测和注册工具。

ToolCallingAdvisor 自动注册机制的工作原理

ToolCallingAdvisor 的自动注册机制基于 Spring 框架的反射与 AOP 特性，可为调用工具提供便捷的管理方式。其主要流程如下：

工具注册 :

开发者通过在工具类上添加特定的注解，比如 @Tool，来标记该类为一个工具。
自动扫描与注册 :

Spring 容器在启动时，会自动扫描带有 @Tool 注解的类，并将其实例化到 Spring 上下文中。这一过程通过 Spring 的 @ComponentScan 和 @Configuration 注解实现。
环绕通知 :

ToolCallingAdvisor 使用 AOP 技术，在工具方法调用时，添加前置和后置处理逻辑。这样，开发者可以在执行工具调用之前或之后添加自定义逻辑，比如日志记录或错误处理。

通过这种方式，开发者能够更轻松地管理工具调用，提高代码的可读性和可维护性。

示例代码

以下是一个简化的示例，展示了如何使用 Spring AI 2.0 中的 ChatClient 和 ToolCallingAdvisor。

Maven 依赖

首先，确保在你的 pom.xml 文件中添加相关的 Spring AI 依赖。

xml 复制代码

<dependencies>
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-chat</artifactId>
        <version>2.0.0</version>
    </dependency>
    <!-- 其他依赖 -->
</dependencies>

工具类

接下来，创建一个工具类，并使用 @Tool 注解标识。

java 复制代码

import org.springframework.ai.annotation.Tool;

@Tool
public class MyTool {
    
    public String performAction(String input) {
        // 处理输入
        return "Processed: " + input;
    }
}

ChatClient 配置

然后，配置 ChatClient 和 ToolCallingAdvisor。

java 复制代码

import org.springframework.ai.chat.ChatClient;
import org.springframework.ai.configuration.EnableChatAI;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@EnableChatAI
public class ChatConfig {

    @Bean
    public ChatClient chatClient() {
        return ChatClient.builder()
                         .configure("OpenAI") // 示例：选择 AI 供应商
                         .build();
    }
}

使用 ChatClient 调用工具

最后，在你需要使用 ChatClient 的地方，进行工具调用。

java 复制代码

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class ChatApplication {

    @Autowired
    private ChatClient chatClient;

    @Autowired
    private MyTool myTool;

    public void run() {
        String input = "Hello AI!";
        String result = myTool.performAction(input);
        System.out.println("Result from tool: " + result);
    }

    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(ChatConfig.class);
        ChatApplication app = context.getBean(ChatApplication.class);
        app.run();
        context.close();
    }
}

最后小结下哈

Spring AI 2.0 中 ChatClient API 的重要变化，尤其是 ToolCallingAdvisor 的自动注册机制，显著提升了开发者的工作效率。通过简化的 API 设计、更强大的错误处理和灵活的工具注册方式，开发者可以更加专注于业务逻辑的实现，而不必陷入复杂的配置和管理之中。随着 AI 应用的不断发展，Spring AI 2.0 为开发者提供了更强大的工具和框架，非常值得深入学习和应用。