org.noear.solon.ai.agent.react

接口 ReActInterceptor

所有超级接口:

AgentInterceptor, ChatInterceptor, org.noear.solon.flow.intercept.FlowInterceptor, ToolInterceptor

所有已知实现类:

HITLInterceptor, StopLoopInterceptor, SummarizationInterceptor, ToolRetryInterceptor, ToolSanitizerInterceptor

@Preview(value="3.8.1")
public interface ReActInterceptor
extends AgentInterceptor, org.noear.solon.flow.intercept.FlowInterceptor, ChatInterceptor

ReAct 智能体拦截器

提供对智能体起止、模型推理、工具执行等全生命周期的监控与干预能力

从以下版本开始:

3.8.1

方法概要

限定符和类型	方法和说明
default void	onAction(ReActTrace trace, java.lang.String toolName, java.util.Map<java.lang.String,java.lang.Object> args) 动作节点：调用功能工具 (Action) 前触发 可用于权限控制、参数合法性预检
default void	onAgentEnd(ReActTrace trace) 智能体生命周期：任务结束（成功或异常中止）时触发
default void	onAgentStart(ReActTrace trace) 智能体生命周期：开始执行前
default void	onModelEnd(ReActTrace trace, ChatResponse resp) 模型推理周期：LLM 响应后 常用于死循环（复读）检测或原始响应审计
default void	onModelStart(ReActTrace trace, ChatRequestDesc req) 模型推理周期：发起 LLM 请求前 可用于动态修改请求参数、Stop 词或注入 Context
default void	onObservation(ReActTrace trace, java.lang.String toolName, java.lang.String result) 观察节点：工具执行返回结果 (Observation) 后触发
default void	onPlan(ReActTrace trace, AssistantMessage message) 计划节点：接收 LLM 返回的原始推理消息
default void	onReason(ReActTrace trace, AssistantMessage message) 推理节点：接收 LLM 返回的原始推理消息
default void	onThought(ReActTrace trace, java.lang.String thought) 推理节点：解析出思考内容 (Thought) 时触发

从接口继承的方法 org.noear.solon.flow.intercept.FlowInterceptor

interceptFlow, onNodeEnd, onNodeStart

从接口继承的方法 org.noear.solon.ai.chat.interceptor.ChatInterceptor

interceptCall, interceptStream, onPrepare

从接口继承的方法 org.noear.solon.ai.chat.interceptor.ToolInterceptor

interceptTool

方法详细资料

onAgentStart

default void onAgentStart(ReActTrace trace)

智能体生命周期：开始执行前

onModelStart

default void onModelStart(ReActTrace trace,
                          ChatRequestDesc req)

模型推理周期：发起 LLM 请求前

可用于动态修改请求参数、Stop 词或注入 Context

onModelEnd

default void onModelEnd(ReActTrace trace,
                        ChatResponse resp)

模型推理周期：LLM 响应后

常用于死循环（复读）检测或原始响应审计

onPlan

default void onPlan(ReActTrace trace,
                    AssistantMessage message)

计划节点：接收 LLM 返回的原始推理消息

onReason

default void onReason(ReActTrace trace,
                      AssistantMessage message)

推理节点：接收 LLM 返回的原始推理消息

onThought

default void onThought(ReActTrace trace,
                       java.lang.String thought)

推理节点：解析出思考内容 (Thought) 时触发

onAction

default void onAction(ReActTrace trace,
                      java.lang.String toolName,
                      java.util.Map<java.lang.String,java.lang.Object> args)

动作节点：调用功能工具 (Action) 前触发

可用于权限控制、参数合法性预检

onObservation

default void onObservation(ReActTrace trace,
                           java.lang.String toolName,
                           java.lang.String result)

观察节点：工具执行返回结果 (Observation) 后触发

onAgentEnd

default void onAgentEnd(ReActTrace trace)

智能体生命周期：任务结束（成功或异常中止）时触发