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

类 ContractNetProtocol

java.lang.Object

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

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

所有已实现的接口:

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

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

合同网协作协议 (Contract Net Protocol)

核心特征：引入竞争性招标机制。支持 Supervisor 显式招标工具与 Agent 自主投标工具，配合算法自动打分兜底。

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	ContractNetProtocol.ContractState

字段概要

字段

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

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

config

构造器概要

构造器

构造器和说明
ContractNetProtocol(TeamAgentConfig config)

方法概要

限定符和类型	方法和说明
void	buildGraph(org.noear.solon.flow.GraphSpec spec) 构建协作拓扑图（定义节点间的连接关系）
protected org.noear.snack4.ONode	constructBid(Agent agent, Prompt prompt) 算法兜底打分：基于关键词匹配
ContractNetProtocol.ContractState	getContractState(TeamTrace trace)
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 静态系统指令（定义全局调度准则）
void	injectSupervisorTools(org.noear.solon.flow.FlowContext context, java.util.function.Consumer<FunctionTool> receiver) 注入 Supervisor 协议专属工具（如转交、抄送等控制工具）
protected boolean	isLogicFinished(TeamTrace trace) SOP 完备性检查：默认保护最后一位 Agent 必须参与过（防止跳步）
java.lang.String	name() 获取协议唯一标识（如 SEQUENTIAL, SWARM, HIERARCHICAL）
Prompt	prepareAgentPrompt(TeamTrace trace, Agent agent, Prompt originalPrompt, java.util.Locale locale) 动态生成 Agent 提示词（在此处处理上下文衔接或状态同步）
void	prepareSupervisorInstruction(org.noear.solon.flow.FlowContext context, TeamTrace trace, java.lang.StringBuilder sb) 注入 Supervisor 动态决策指令（如实时进度、环境感知）
java.lang.String	resolveSupervisorRoute(org.noear.solon.flow.FlowContext context, TeamTrace trace, java.lang.String decision) 解析路由目标（将决策文本语义化为节点 ID）
void	startNewBidding(TeamTrace trace)

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

getCandidateAgents, injectAgentInstruction, isLastNAgentsParticipated, linkAgents, shouldSupervisorRoute, sniffJson

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

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

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

onAgentEnd, onSupervisorRouting, onTeamFinished, prepareSupervisorContext, resolveAgentOutput, shouldSupervisorExecute

字段详细资料

ID_BIDDING

public static final java.lang.String ID_BIDDING

另请参阅:

常量字段值

构造器详细资料

ContractNetProtocol

public ContractNetProtocol(TeamAgentConfig config)

方法详细资料

getContractState

public ContractNetProtocol.ContractState getContractState(TeamTrace trace)

startNewBidding

public void startNewBidding(TeamTrace trace)

name

public java.lang.String name()

从接口复制的说明: TeamProtocol

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

buildGraph

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

从接口复制的说明: TeamProtocol

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

injectAgentTools

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

从接口复制的说明: TeamProtocol

注入 Agent 协议专属工具（如转交、抄送等控制工具）

prepareAgentPrompt

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

从接口复制的说明: TeamProtocol

动态生成 Agent 提示词（在此处处理上下文衔接或状态同步）

injectSupervisorTools

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

从接口复制的说明: TeamProtocol

注入 Supervisor 协议专属工具（如转交、抄送等控制工具）

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)

从接口复制的说明: TeamProtocol

注入 Supervisor 动态决策指令（如实时进度、环境感知）

injectSupervisorInstruction

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

从接口复制的说明: TeamProtocol

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

指定者:

injectSupervisorInstruction 在接口中 TeamProtocol

覆盖:

injectSupervisorInstruction 在类中 TeamProtocolBase

constructBid

protected org.noear.snack4.ONode constructBid(Agent agent,
                                              Prompt prompt)

算法兜底打分：基于关键词匹配

isLogicFinished

protected boolean isLogicFinished(TeamTrace trace)

从类复制的说明: TeamProtocolBase

SOP 完备性检查：默认保护最后一位 Agent 必须参与过（防止跳步）

覆盖:

isLogicFinished 在类中 TeamProtocolBase