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

类 BlackboardProtocol

java.lang.Object

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

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

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

所有已实现的接口:

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

@Preview(value="3.8.2")
public class BlackboardProtocol
extends HierarchicalProtocol

黑板协作协议 (Blackboard Protocol)

核心特征：全局共享看板。Agent 通过工具主动同步结论和待办事项， Supervisor 依据黑板上的数据补全情况和 `todo` 列表决定下一步路由。

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	BlackboardProtocol.BoardState 黑板状态机：管理共享数据与待办队列 (TODOs)

从类继承的嵌套类/接口 org.noear.solon.ai.agent.team.protocol.HierarchicalProtocol

HierarchicalProtocol.HierarchicalState

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	STATUS_COMPLETED
static java.lang.String	STATUS_FAILED

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

config

构造器概要

构造器

构造器和说明
BlackboardProtocol(TeamAgentConfig config)

方法概要

限定符和类型	方法和说明
void	injectAgentInstruction(org.noear.solon.flow.FlowContext context, Agent agent, java.util.Locale locale, java.lang.StringBuilder sb) 注入 Agent 行为约束指令（定义角色规范）
void	injectAgentTools(org.noear.solon.flow.FlowContext context, Agent agent, java.util.function.Consumer<FunctionTool> receiver) 为 Agent 注入黑板同步工具，实现主动数据回传
void	injectSupervisorInstruction(java.util.Locale locale, java.lang.StringBuilder sb) 注入 Supervisor 静态系统指令（定义全局调度准则）
java.lang.String	name() 获取协议唯一标识（如 SEQUENTIAL, SWARM, HIERARCHICAL）
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）
boolean	shouldSupervisorRoute(org.noear.solon.flow.FlowContext context, TeamTrace trace, java.lang.String decision) 终结审计：如果黑板中尚存待办事项且未达轮次上限，拦截 [FINISH] 路由

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

buildGraph, onAgentEnd

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

getCandidateAgents, isLastNAgentsParticipated, isLogicFinished, linkAgents, sniffJson

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

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

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

injectSupervisorTools, onSupervisorRouting, onTeamFinished, prepareSupervisorContext, resolveAgentOutput, shouldSupervisorExecute

字段详细资料

STATUS_FAILED

public static final java.lang.String STATUS_FAILED

另请参阅:

常量字段值

STATUS_COMPLETED

public static final java.lang.String STATUS_COMPLETED

另请参阅:

常量字段值

构造器详细资料

BlackboardProtocol

public BlackboardProtocol(TeamAgentConfig config)

方法详细资料

name

public java.lang.String name()

从接口复制的说明: TeamProtocol

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

指定者:

name 在接口中 TeamProtocol

覆盖:

name 在类中 HierarchicalProtocol

injectAgentTools

public void injectAgentTools(org.noear.solon.flow.FlowContext context,
                             Agent agent,
                             java.util.function.Consumer<FunctionTool> receiver)

为 Agent 注入黑板同步工具，实现主动数据回传

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 在类中 HierarchicalProtocol

prepareAgentPrompt

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

从类复制的说明: HierarchicalProtocol

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

指定者:

prepareAgentPrompt 在接口中 TeamProtocol

覆盖:

prepareAgentPrompt 在类中 HierarchicalProtocol

resolveSupervisorRoute

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

从接口复制的说明: TeamProtocol

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

指定者:

resolveSupervisorRoute 在接口中 TeamProtocol

覆盖:

resolveSupervisorRoute 在类中 HierarchicalProtocol

返回:

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

prepareSupervisorInstruction

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

从类复制的说明: HierarchicalProtocol

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

指定者:

prepareSupervisorInstruction 在接口中 TeamProtocol

覆盖:

prepareSupervisorInstruction 在类中 HierarchicalProtocol

injectSupervisorInstruction

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

从接口复制的说明: TeamProtocol

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

指定者:

injectSupervisorInstruction 在接口中 TeamProtocol

覆盖:

injectSupervisorInstruction 在类中 HierarchicalProtocol

shouldSupervisorRoute

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

终结审计：如果黑板中尚存待办事项且未达轮次上限，拦截 [FINISH] 路由

指定者:

shouldSupervisorRoute 在接口中 TeamProtocol

覆盖:

shouldSupervisorRoute 在类中 TeamProtocolBase