当前位置：首页 > news >正文

Spring AI 2.0：Advisor

news 2026/8/16 10:53:38

一、简介

二、代码

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

SimpleLoggerAdvisor 日志拦截器

打印出入参。

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

application.properties

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

SafeGuardAdvisor 敏感词拦截器

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

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

自定义拦截器

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

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

importorg.springframework.ai.chat.client.AdvisorChain;importorg.springframework.ai.chat.client.BaseAdvisor;importorg.springframework.ai.chat.client.ChatClientRequest;importorg.springframework.ai.chat.client.ChatClientResponse;importorg.springframework.ai.chat.messages.UserMessage;importorg.springframework.ai.chat.prompt.PromptTemplate;importjava.util.Map;/** * 自定义Advisor：修改/增强用户提示词 * 作用：在请求发送给LLM之前，改写用户的UserMessage内容 */publicclassReReadingAdvisorimplementsBaseAdvisor{privatestaticfinalStringDEFAULT_USER_TEXT_ADVISE=""" {re2_input_query} Read the question again: {re2_input_query} """;/** * before：调用大模型【之前】执行，修改用户prompt */@OverridepublicChatClientRequestbefore(ChatClientRequestchatClientRequest,AdvisorChainadvisorChain){// 获取原始用户输入StringinputQuery=chatClientRequest.prompt().getUserMessage().getText();// 模板渲染，填充占位符StringaugmentedUserText=PromptTemplate.builder().template(DEFAULT_USER_TEXT_ADVISE).render(Map.of("re2_input_query",inputQuery));// 构造新用户消息，mutate复制新request（原对象不可修改）UserMessagenewUserMessage=newUserMessage(augmentedUserText);ChatClientRequestnewRequest=chatClientRequest.mutate().userMessage(newUserMessage).build();// 将修改后的请求继续交给链路returnadvisorChain.nextAroundCall(newRequest);}/** * after：大模型返回结果【之后】执行；需求：不做处理，直接原样返回response */@OverridepublicChatClientResponseafter(ChatClientResponsechatClientResponse,AdvisorChainadvisorChain){// 无任何业务逻辑，直接原样返回响应returnchatClientResponse;}@OverridepublicintgetOrder(){return0;}}

@BeanpublicChatClientchatClient(DashScopeChatModeldashScopeChatModel){returnChatClient.builder(dashScopeChatModel).defaultAdvisors(newReReadingAdvisor()).build();}