org.noear.solon.ai.agent.react

类 ReActTrace

java.lang.Object

org.noear.solon.ai.agent.react.ReActTrace

所有已实现的接口:

AgentTrace

@Preview(value="3.8.1")
public class ReActTrace
extends java.lang.Object
implements AgentTrace

ReAct 运行轨迹记录器 (状态机上下文)

负责维护智能体推理过程中的短期记忆、执行路由、消息序列及上下文压缩。

从以下版本开始:

3.8.1

构造器概要

构造器

构造器和说明
ReActTrace()
ReActTrace(Prompt originalPrompt)

方法概要

限定符和类型	方法和说明
protected void	activeSkills()
void	addPlan(java.lang.String step) 添加单条计划步骤
void	addProtocolTool(FunctionTool tool) 注册协议内置工具
java.lang.String	getAgentName()
ReActAgentConfig	getConfig()
org.noear.solon.flow.FlowContext	getContext() 获取流程快照快照
static ReActTrace	getCurrent(org.noear.solon.flow.FlowContext context)
java.lang.Object	getExtra(java.lang.String key)
<T> T	getExtraAs(java.lang.String key)
java.util.Map<java.lang.String,java.lang.Object>	getExtras()
java.lang.String	getFinalAnswer()
java.lang.String	getFormattedHistory() 获取人性化历史记录格式
java.lang.String	getFormattedPlans() 获取格式化的计划文本 (用于注入 System Prompt)
java.lang.String	getLastObservation()
AssistantMessage	getLastReasonMessage()
Metrics	getMetrics()
ReActOptions	getOptions()
Prompt	getOriginalPrompt()
@Nullable java.lang.String	getPendingReason() 获取挂起的原因或提示信息
java.lang.String	getPlanProgress() 获取当前的执行进度描述
java.util.List<java.lang.String>	getPlans() 获取当前执行计划
TeamProtocol	getProtocol()
FunctionTool	getProtocolTool(java.lang.String name)
java.util.Collection<FunctionTool>	getProtocolTools()
java.lang.String	getRoute()
AgentSession	getSession()
int	getStepCount()
int	getToolCallCount() 获取已触发的工具调用总数
Prompt	getWorkingMemory()
boolean	hasPlans() 判断是否存在计划
void	incrementToolCallCount() 增加工具调用计数
boolean	isPending() 判定当前任务是否正在挂起等待
int	nextStep() 递增步数
void	pending(java.lang.String reason) 触发协作流挂起
protected void	prepare(ReActAgentConfig config, ReActOptions options, AgentSession session, TeamProtocol protocol) 准备执行环境
protected void	reset(Prompt originalPrompt)
void	setExtra(java.lang.String key, java.lang.Object val)
void	setFinalAnswer(java.lang.String finalAnswer)
void	setLastObservation(java.lang.String lastObservation)
void	setLastReasonMessage(AssistantMessage lastReasonMessage)
protected void	setOriginalPrompt(Prompt originalPrompt)
void	setPlans(java.util.Collection<java.lang.String> newPlans) 设置或重置计划
void	setRoute(java.lang.String route) 更新路由状态

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

ReActTrace

public ReActTrace()

ReActTrace

public ReActTrace(Prompt originalPrompt)

方法详细资料

getExtras

public java.util.Map<java.lang.String,java.lang.Object> getExtras()

getExtra

public java.lang.Object getExtra(java.lang.String key)

getExtraAs

public <T> T getExtraAs(java.lang.String key)

setExtra

public void setExtra(java.lang.String key,
                     java.lang.Object val)

getCurrent

public static ReActTrace getCurrent(org.noear.solon.flow.FlowContext context)

prepare

protected void prepare(ReActAgentConfig config,
                       ReActOptions options,
                       AgentSession session,
                       TeamProtocol protocol)

准备执行环境

activeSkills

protected void activeSkills()

reset

protected void reset(Prompt originalPrompt)

pending

public void pending(java.lang.String reason)

触发协作流挂起

参数:

reason - 挂起原因或需要人工确认的提示词

isPending

public boolean isPending()

判定当前任务是否正在挂起等待

getPendingReason

public @Nullable java.lang.String getPendingReason()

获取挂起的原因或提示信息

getMetrics

public Metrics getMetrics()

指定者:

getMetrics 在接口中 AgentTrace

getConfig

public ReActAgentConfig getConfig()

getOptions

public ReActOptions getOptions()

getSession

public AgentSession getSession()

getContext

public org.noear.solon.flow.FlowContext getContext()

获取流程快照快照

getProtocol

public TeamProtocol getProtocol()

addProtocolTool

public void addProtocolTool(FunctionTool tool)

注册协议内置工具

getProtocolTool

public FunctionTool getProtocolTool(java.lang.String name)

getProtocolTools

public java.util.Collection<FunctionTool> getProtocolTools()

getAgentName

public java.lang.String getAgentName()

getOriginalPrompt

public Prompt getOriginalPrompt()

setOriginalPrompt

protected void setOriginalPrompt(Prompt originalPrompt)

getWorkingMemory

public Prompt getWorkingMemory()

getStepCount

public int getStepCount()

nextStep

public int nextStep()

递增步数

getRoute

public java.lang.String getRoute()

setRoute

public void setRoute(java.lang.String route)

更新路由状态

getFinalAnswer

public java.lang.String getFinalAnswer()

setFinalAnswer

public void setFinalAnswer(java.lang.String finalAnswer)

getLastReasonMessage

public AssistantMessage getLastReasonMessage()

setLastReasonMessage

public void setLastReasonMessage(AssistantMessage lastReasonMessage)

getLastObservation

public java.lang.String getLastObservation()

setLastObservation

public void setLastObservation(java.lang.String lastObservation)

getFormattedHistory

public java.lang.String getFormattedHistory()

获取人性化历史记录格式

incrementToolCallCount

public void incrementToolCallCount()

增加工具调用计数

getToolCallCount

public int getToolCallCount()

获取已触发的工具调用总数

getPlans

public java.util.List<java.lang.String> getPlans()

获取当前执行计划

hasPlans

public boolean hasPlans()

判断是否存在计划

setPlans

public void setPlans(java.util.Collection<java.lang.String> newPlans)

设置或重置计划

参数:

newPlans - 计划列表

addPlan

public void addPlan(java.lang.String step)

添加单条计划步骤

getFormattedPlans

public java.lang.String getFormattedPlans()

获取格式化的计划文本 (用于注入 System Prompt)

getPlanProgress

public java.lang.String getPlanProgress()

获取当前的执行进度描述