org.noear.solon.ai.agent.team

类 TeamAgent

java.lang.Object

org.noear.solon.ai.agent.team.TeamAgent

所有已实现的接口:

Agent<TeamRequest,TeamResponse>, AgentHandler, org.noear.solon.flow.NamedTaskComponent, org.noear.solon.flow.TaskComponent

@Preview(value="3.8.1")
public class TeamAgent
extends java.lang.Object
implements Agent<TeamRequest,TeamResponse>

团队协作智能体 (Team Agent) *

核心定位：多智能体协作容器。底层依托 Solon Flow 状态机引擎实现复杂的协作逻辑。

• 封装性：将多个专家 Agent 封装为统一接口，屏蔽内部调度逻辑。
• 协议驱动：协作模式（如 HIERARCHICAL, SWARM）由 TeamProtocol 定义并构建执行图。
• 踪迹隔离：通过独有的 TraceKey 隔离不同团队在同一会话中的协作痕迹。

从以下版本开始:

3.8.1

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	TeamAgent.Builder

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ID_SUPERVISOR
static java.lang.String	ID_SYSTEM

从接口继承的字段 org.noear.solon.ai.agent.Agent

ID_END, ID_START, KEY_CURRENT_TEAM_TRACE_KEY, KEY_CURRENT_UNIT_TRACE_KEY, KEY_PROTOCOL, KEY_SESSION, META_AGENT

构造器概要

构造器

构造器和说明
TeamAgent(TeamAgentConfig config)

方法概要

限定符和类型	方法和说明
protected org.noear.solon.flow.Graph	buildGraph() 依据协作协议构建计算图（Graph）
AssistantMessage	call(Prompt prompt, AgentSession session) 同步执行团队协作任务
protected AssistantMessage	call(Prompt prompt, AgentSession session, TeamOptions options) 执行团队协作（核心生命周期管理）
TeamAgentConfig	getConfig()
org.noear.solon.flow.Graph	getGraph()
@Nullable TeamTrace	getTrace(AgentSession session) 获取当前会话中的团队协作踪迹（Trace）
protected TeamTrace	getTrace(org.noear.solon.flow.FlowContext context, Prompt prompt)
java.lang.String	name() 智能体名称（唯一标识）
static TeamAgent.Builder	of(@Nullable ChatModel chatModel)
AgentProfile	profile() 智能体档案（能力画像与交互契约）
TeamRequest	prompt() 创建恢复请求构建器（用于从会话中恢复 prompt 执行）
TeamRequest	prompt(Prompt prompt) 创建团队请求（支持后续流式或异步处理）
TeamRequest	prompt(java.lang.String prompt) 创建基于字符串指令的请求构建器
java.lang.String	role() 智能体角色职责（用于 Prompt 提示与协作分发参考）

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

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

从接口继承的方法 org.noear.solon.ai.agent.Agent

call, roleFor, run, toMetadata

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

title

字段详细资料

ID_SYSTEM

public static final java.lang.String ID_SYSTEM

另请参阅:

常量字段值

ID_SUPERVISOR

public static final java.lang.String ID_SUPERVISOR

另请参阅:

常量字段值

构造器详细资料

TeamAgent

public TeamAgent(TeamAgentConfig config)

方法详细资料

buildGraph

protected org.noear.solon.flow.Graph buildGraph()

依据协作协议构建计算图（Graph）

getGraph

public org.noear.solon.flow.Graph getGraph()

getConfig

public TeamAgentConfig getConfig()

getTrace

public @Nullable TeamTrace getTrace(AgentSession session)

获取当前会话中的团队协作踪迹（Trace）

name

public java.lang.String name()

从接口复制的说明: Agent

智能体名称（唯一标识）

指定者:

name 在接口中 Agent<TeamRequest,TeamResponse>

指定者:

name 在接口中 org.noear.solon.flow.NamedTaskComponent

role

public java.lang.String role()

从接口复制的说明: Agent

智能体角色职责（用于 Prompt 提示与协作分发参考）

指定者:

role 在接口中 Agent<TeamRequest,TeamResponse>

profile

public AgentProfile profile()

从接口复制的说明: Agent

智能体档案（能力画像与交互契约）

指定者:

profile 在接口中 Agent<TeamRequest,TeamResponse>

prompt

public TeamRequest prompt(Prompt prompt)

创建团队请求（支持后续流式或异步处理）

指定者:

prompt 在接口中 Agent<TeamRequest,TeamResponse>

prompt

public TeamRequest prompt(java.lang.String prompt)

从接口复制的说明: Agent

创建基于字符串指令的请求构建器

指定者:

prompt 在接口中 Agent<TeamRequest,TeamResponse>

prompt

public TeamRequest prompt()

从接口复制的说明: Agent

创建恢复请求构建器（用于从会话中恢复 prompt 执行）

指定者:

prompt 在接口中 Agent<TeamRequest,TeamResponse>

call

public AssistantMessage call(Prompt prompt,
                             AgentSession session)
                      throws java.lang.Throwable

同步执行团队协作任务

指定者:

call 在接口中 Agent<TeamRequest,TeamResponse>

指定者:

call 在接口中 AgentHandler

参数:

prompt - 显式指令（如果为 null；则继续之前的话题）

session - 会话上下文

返回:

智能体生成的响应消息

抛出:

java.lang.Throwable - 执行过程中的异常处理

getTrace

protected TeamTrace getTrace(org.noear.solon.flow.FlowContext context,
                             Prompt prompt)

call

protected AssistantMessage call(Prompt prompt,
                                AgentSession session,
                                TeamOptions options)
                         throws java.lang.Throwable

执行团队协作（核心生命周期管理）

抛出:

java.lang.Throwable

of

public static TeamAgent.Builder of(@Nullable ChatModel chatModel)