org.noear.solon.ai.agent.team

类 TeamTrace

java.lang.Object

org.noear.solon.ai.agent.team.TeamTrace

所有已实现的接口:

AgentTrace

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

团队协作轨迹（Team Trace）

核心职责：记录任务在 Agent 团队内部流转的全生命周期状态，充当协作“黑匣子”与“状态总线”。

从以下版本开始:

3.8.1

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	TeamTrace.TeamRecord 协作足迹详情

构造器概要

构造器

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

方法概要

限定符和类型	方法和说明
protected void	activeSkills()
void	addRecord(ChatRole role, java.lang.String source, java.lang.String content, long duration) 记录执行足迹
java.lang.String	getAgentName()
TeamAgentConfig	getConfig()
org.noear.solon.flow.FlowContext	getContext()
static TeamTrace	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	getFormattedHistory(int windowSize)
java.lang.String	getFormattedHistory(int windowSize, boolean includeSystem) 渲染协作历史（Markdown 格式）
java.lang.String	getLastAgentContent() 提取最近一位专家 Agent（非 Supervisor）的内容
long	getLastAgentDuration()
java.lang.String	getLastAgentName()
java.lang.String	getLastDecision()
Metrics	getMetrics()
TeamOptions	getOptions()
Prompt	getOriginalPrompt()
@Nullable java.lang.String	getPendingReason() 获取挂起的原因或提示信息
TeamProtocol	getProtocol()
java.util.Map<java.lang.String,java.lang.Object>	getProtocolContext() 获取协议私有上下文
<T> T	getProtocolContextAs(java.lang.String key)
java.lang.String	getProtocolDashboardSnapshot() 获取协议状态快照（JSON 格式，供 Agent 感知全局进度）
int	getRecordCount()
java.util.List<TeamTrace.TeamRecord>	getRecords()
java.lang.String	getRoute()
AgentSession	getSession()
int	getTurnCount()
Prompt	getWorkingMemory()
boolean	isInitial() 是否为初始状态
boolean	isPending() 判定当前任务是否正在挂起等待
int	nextTurn()
void	pending(java.lang.String reason) 触发协作流挂起
protected void	prepare(TeamAgentConfig config, TeamOptions options, AgentSession session, java.lang.String agentName) 运行时环境准备
protected void	reset(Prompt originalPrompt)
void	resetProtocolContext()
void	resetTurnCount()
void	setExtra(java.lang.String key, java.lang.Object val)
void	setFinalAnswer(java.lang.String finalAnswer)
void	setLastAgentName(java.lang.String agentName)
void	setLastDecision(java.lang.String decision)
void	setOriginalPrompt(Prompt originalPrompt)
void	setRoute(java.lang.String route)

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

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

构造器详细资料

TeamTrace

public TeamTrace()

TeamTrace

public TeamTrace(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 TeamTrace getCurrent(org.noear.solon.flow.FlowContext context)

prepare

protected void prepare(TeamAgentConfig config,
                       TeamOptions options,
                       AgentSession session,
                       java.lang.String agentName)

运行时环境准备

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()

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

isInitial

public boolean isInitial()

是否为初始状态

getLastAgentContent

public java.lang.String getLastAgentContent()

提取最近一位专家 Agent（非 Supervisor）的内容

getLastAgentDuration

public long getLastAgentDuration()

getMetrics

public Metrics getMetrics()

指定者:

getMetrics 在接口中 AgentTrace

getAgentName

public java.lang.String getAgentName()

getConfig

public TeamAgentConfig getConfig()

getOptions

public TeamOptions getOptions()

getSession

public AgentSession getSession()

getContext

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

getProtocol

public TeamProtocol getProtocol()

getOriginalPrompt

public Prompt getOriginalPrompt()

setOriginalPrompt

public void setOriginalPrompt(Prompt originalPrompt)

getWorkingMemory

public Prompt getWorkingMemory()

getRoute

public java.lang.String getRoute()

setRoute

public void setRoute(java.lang.String route)

getLastDecision

public java.lang.String getLastDecision()

setLastDecision

public void setLastDecision(java.lang.String decision)

getLastAgentName

public java.lang.String getLastAgentName()

setLastAgentName

public void setLastAgentName(java.lang.String agentName)

getTurnCount

public int getTurnCount()

resetTurnCount

public void resetTurnCount()

nextTurn

public int nextTurn()

getProtocolContext

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

获取协议私有上下文

resetProtocolContext

public void resetProtocolContext()

getProtocolDashboardSnapshot

public java.lang.String getProtocolDashboardSnapshot()

获取协议状态快照（JSON 格式，供 Agent 感知全局进度）

getProtocolContextAs

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

getRecordCount

public int getRecordCount()

addRecord

public void addRecord(ChatRole role,
                      java.lang.String source,
                      java.lang.String content,
                      long duration)

记录执行足迹

getFormattedHistory

public java.lang.String getFormattedHistory()

获取全量格式化历史

getFormattedHistory

public java.lang.String getFormattedHistory(int windowSize)

getFormattedHistory

public java.lang.String getFormattedHistory(int windowSize,
                                            boolean includeSystem)

渲染协作历史（Markdown 格式）

参数:

windowSize - 限制返回的步数（0 为不限）

includeSystem - 是否包含调度器决策逻辑

getRecords

public java.util.List<TeamTrace.TeamRecord> getRecords()

getFinalAnswer

public java.lang.String getFinalAnswer()

setFinalAnswer

public void setFinalAnswer(java.lang.String finalAnswer)