Spring AI 2.0：Advisor

一、简介

二、代码

SimpleLoggerAdvisor：日志拦截器
SafeGuardAdvisor：敏感词拦截器
MessageChatMemoryAdvisor：自动维护会话上下文
QuestionAnswerAdvisor：检索拦截器，RAG 把知识库内容塞到 prompt。

SimpleLoggerAdvisor 日志拦截器

打印出入参。

java 复制代码

ChatClient.builder(deepSeekChatModel)
        	.defaultSystem("""默认系统提示词""")
        	.defaultAdvisors(new SimpleLoggerAdvisor())
        	.build();

application.properties

复制代码

logging.level.org.springframework.ai.chat.client.advisor=
DEBUG

SafeGuardAdvisor 敏感词拦截器

当会话中出现敏感词，终止整条调用链路，不会调用大模型，不会继续执行后面其他 Advisor，直接返回预设拒绝文本。

java 复制代码

ChatClient.builder(deepSeekChatModel)
        	.defaultSystem("""默认系统提示词""")
        	.defaultAdvisors(new SafeGuardAdvisor(List.of("草泥马")))
        	.build();

自定义拦截器

自定义一个更改用户提示词的示例，更改用户的输入提示词。

getOrder(): 执行顺序，数字越小越优先执行
before(): 调用 LLM之前，修改 Request
after(): LLM 返回之后，修改 Response

java 复制代码

import org.springframework.ai.chat.client.AdvisorChain;
import org.springframework.ai.chat.client.BaseAdvisor;
import org.springframework.ai.chat.client.ChatClientRequest;
import org.springframework.ai.chat.client.ChatClientResponse;
import org.springframework.ai.chat.messages.UserMessage;
import org.springframework.ai.chat.prompt.PromptTemplate;
import java.util.Map;
/**
 * 自定义Advisor：修改/增强用户提示词
 * 作用：在请求发送给LLM之前，改写用户的UserMessage内容
 */
public class ReReadingAdvisor implements BaseAdvisor {

    private static final String DEFAULT_USER_TEXT_ADVISE = """
            {re2_input_query}
            Read the question again: {re2_input_query}
            """;

    /**
     * before：调用大模型【之前】执行，修改用户prompt
     */
    @Override
    public ChatClientRequest before(ChatClientRequest chatClientRequest, AdvisorChain advisorChain) {
        // 获取原始用户输入
        String inputQuery = chatClientRequest.prompt().getUserMessage().getText();

        // 模板渲染，填充占位符
        String augmentedUserText = PromptTemplate.builder()
                .template(DEFAULT_USER_TEXT_ADVISE)
                .render(Map.of("re2_input_query", inputQuery));

        // 构造新用户消息，mutate复制新request（原对象不可修改）
        UserMessage newUserMessage = new UserMessage(augmentedUserText);
        ChatClientRequest newRequest = chatClientRequest.mutate()
                .userMessage(newUserMessage)
                .build();

        // 将修改后的请求继续交给链路
        return advisorChain.nextAroundCall(newRequest);
    }

    /**
     * after：大模型返回结果【之后】执行；需求：不做处理，直接原样返回response
     */
    @Override
    public ChatClientResponse after(ChatClientResponse chatClientResponse, AdvisorChain advisorChain) {
        // 无任何业务逻辑，直接原样返回响应
        return chatClientResponse;
    }
	
    @Override
    public int getOrder() {
        return 0;
    }
}

java 复制代码

@Bean
public ChatClient chatClient(DashScopeChatModel dashScopeChatModel) {
    return ChatClient.builder(dashScopeChatModel)
            .defaultAdvisors(new ReReadingAdvisor())
            .build();
}