org.noear.solon.ai.agent.team.protocol

类 HierarchicalProtocol

java.lang.Object

org.noear.solon.ai.agent.team.protocol.TeamProtocolBase

org.noear.solon.ai.agent.team.protocol.HierarchicalProtocol

所有已实现的接口:

java.io.Serializable, TeamProtocol, org.noear.solon.lang.NonSerializable

直接已知子类:

BlackboardProtocol, MarketBasedProtocol

@Preview(value="3.8.1")
public class HierarchicalProtocol
extends TeamProtocolBase

层级化协作协议 (Hierarchical Protocol)

核心特征：引入“运行看板”机制。各成员的产出被结构化提取并呈现在状态看板中， Supervisor 依据看板进度、成员负载及错误记录进行全局调度。

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	HierarchicalProtocol.HierarchicalState 协作状态机：负责汇报数据的吸收、错误记录与状态持久化

字段概要

从类继承的字段 org.noear.solon.ai.agent.team.protocol.TeamProtocolBase

config

构造器概要

构造器

构造器和说明
HierarchicalProtocol(TeamAgentConfig config)

方法概要

限定符和类型	方法和说明
void	buildGraph(org.noear.solon.flow.GraphSpec spec) 构建协作拓扑图（定义节点间的连接关系）
void	injectAgentInstruction(org.noear.solon.flow.FlowContext context, Agent agent, java.util.Locale locale, java.lang.StringBuilder sb) 注入 Agent 行为约束指令（定义角色规范）
void	injectSupervisorInstruction(java.util.Locale locale, java.lang.StringBuilder sb) 注入 Supervisor 静态系统指令（定义全局调度准则）
java.lang.String	name() 获取协议唯一标识（如 SEQUENTIAL, SWARM, HIERARCHICAL）
void	onAgentEnd(TeamTrace trace, Agent agent) Agent 节点执行结束回调
Prompt	prepareAgentPrompt(TeamTrace trace, Agent agent, Prompt originalPrompt, java.util.Locale locale) 增强专家指令：注入汇报规范与多模态提醒
void	prepareSupervisorInstruction(org.noear.solon.flow.FlowContext context, TeamTrace trace, java.lang.StringBuilder sb) 实时构建运行看板：注入成员能力、负载与错误信息
java.lang.String	resolveSupervisorRoute(org.noear.solon.flow.FlowContext context, TeamTrace trace, java.lang.String decision) 解析路由目标（将决策文本语义化为节点 ID）

从类继承的方法 org.noear.solon.ai.agent.team.protocol.TeamProtocolBase

getCandidateAgents, isLastNAgentsParticipated, isLogicFinished, linkAgents, shouldSupervisorRoute, sniffJson

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

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

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

injectAgentTools, injectSupervisorTools, onSupervisorRouting, onTeamFinished, prepareSupervisorContext, resolveAgentOutput, shouldSupervisorExecute

构造器详细资料

HierarchicalProtocol

public HierarchicalProtocol(TeamAgentConfig config)

方法详细资料

name

public java.lang.String name()

从接口复制的说明: TeamProtocol

获取协议唯一标识（如 SEQUENTIAL, SWARM, HIERARCHICAL）

buildGraph

public void buildGraph(org.noear.solon.flow.GraphSpec spec)

从接口复制的说明: TeamProtocol

构建协作拓扑图（定义节点间的连接关系）

injectAgentInstruction

public void injectAgentInstruction(org.noear.solon.flow.FlowContext context,
                                   Agent agent,
                                   java.util.Locale locale,
                                   java.lang.StringBuilder sb)

从接口复制的说明: TeamProtocol

注入 Agent 行为约束指令（定义角色规范）

指定者:

injectAgentInstruction 在接口中 TeamProtocol

覆盖:

injectAgentInstruction 在类中 TeamProtocolBase

prepareAgentPrompt

public Prompt prepareAgentPrompt(TeamTrace trace,
                                 Agent agent,
                                 Prompt originalPrompt,
                                 java.util.Locale locale)

增强专家指令：注入汇报规范与多模态提醒

onAgentEnd

public void onAgentEnd(TeamTrace trace,
                       Agent agent)

从接口复制的说明: TeamProtocol

Agent 节点执行结束回调

resolveSupervisorRoute

public java.lang.String resolveSupervisorRoute(org.noear.solon.flow.FlowContext context,
                                               TeamTrace trace,
                                               java.lang.String decision)

从接口复制的说明: TeamProtocol

解析路由目标（将决策文本语义化为节点 ID）

指定者:

resolveSupervisorRoute 在接口中 TeamProtocol

覆盖:

resolveSupervisorRoute 在类中 TeamProtocolBase

返回:

目标节点 ID；返回 null 则由系统默认逻辑解析

prepareSupervisorInstruction

public void prepareSupervisorInstruction(org.noear.solon.flow.FlowContext context,
                                         TeamTrace trace,
                                         java.lang.StringBuilder sb)

实时构建运行看板：注入成员能力、负载与错误信息

injectSupervisorInstruction

public void injectSupervisorInstruction(java.util.Locale locale,
                                        java.lang.StringBuilder sb)

从接口复制的说明: TeamProtocol

注入 Supervisor 静态系统指令（定义全局调度准则）

指定者:

injectSupervisorInstruction 在接口中 TeamProtocol

覆盖:

injectSupervisorInstruction 在类中 TeamProtocolBase