程序包 com.agentsflex.core.agent.react

接口 ReActAgentListener

public interface ReActAgentListener

ReActAgent 的监听器接口，用于监听执行过程中的关键事件。

方法概要

修饰符和类型	方法	说明
default void	onActionEnd(ReActStep step, Object result)	当调用工具完成后触发
default void	onActionInvokeError(Exception e)	当工具执行错误时触发
default void	onActionJsonParserError(ReActStep step, Exception error)	当工具返回的 JSON 格式错误时触发
default void	onActionNotMatched(ReActStep step, List<Tool> tools)	当未匹配到任何工具时触发
default void	onActionStart(ReActStep step)	当调用工具前触发
default void	onChatResponse(AiMessageResponse response)	当 LLM 生成响应时触发
default void	onChatResponseStream(StreamContext context, AiMessageResponse response)	当 LLM 生成响应时触发
default void	onError(Exception error)	当发生异常时触发
default void	onFinalAnswer(String finalAnswer)	当检测到最终答案时触发
default void	onMaxIterationsReached()	当达到最大迭代次数仍未获得答案时触发
default void	onNonActionResponse(AiMessageResponse response)	当未命中工具时触发
default void	onNonActionResponseStream(StreamContext context)	当未命中工具时触发
default void	onRequestUserInput(String question)	当需要用户输入时触发
default void	onStepParseError(String content)	当解析步骤时发生错误时触发

方法详细资料

onChatResponse

default void onChatResponse(AiMessageResponse response)

当 LLM 生成响应时触发

参数:

response - 原始响应内容

onChatResponseStream

default void onChatResponseStream(StreamContext context,
 AiMessageResponse response)

当 LLM 生成响应时触发

参数:

context - 上下文信息

response - 原始响应内容

onNonActionResponse

default void onNonActionResponse(AiMessageResponse response)

当未命中工具时触发

参数:

response - 原始响应内容

onNonActionResponseStream

default void onNonActionResponseStream(StreamContext context)

当未命中工具时触发

onFinalAnswer

default void onFinalAnswer(String finalAnswer)

当检测到最终答案时触发

参数:

finalAnswer - 最终答案内容

onRequestUserInput

default void onRequestUserInput(String question)

当需要用户输入时触发

onActionStart

default void onActionStart(ReActStep step)

当调用工具前触发

参数:

step - 当前步骤

onActionEnd

default void onActionEnd(ReActStep step,
 Object result)

当调用工具完成后触发

参数:

step - 工具名称

result - 工具返回结果

onMaxIterationsReached

default void onMaxIterationsReached()

当达到最大迭代次数仍未获得答案时触发

onStepParseError

default void onStepParseError(String content)

当解析步骤时发生错误时触发

参数:

content - 错误内容

onActionNotMatched

default void onActionNotMatched(ReActStep step,
 List<Tool> tools)

当未匹配到任何工具时触发

参数:

step - 当前步骤

tools - 可用的工具列表

onActionInvokeError

default void onActionInvokeError(Exception e)

当工具执行错误时触发

参数:

e - 错误对象

onActionJsonParserError

default void onActionJsonParserError(ReActStep step,
 Exception error)

当工具返回的 JSON 格式错误时触发

参数:

step - 当前步骤

error - 错误对象

onError

default void onError(Exception error)

当发生异常时触发

参数:

error - 异常对象