org.noear.solon.ai.agent

接口 Agent<Req extends AgentRequest<Req,Resp>,Resp extends AgentResponse>

所有超级接口:

AgentHandler, org.noear.solon.flow.NamedTaskComponent, org.noear.solon.flow.TaskComponent

所有已知实现类:

ReActAgent, SimpleAgent, TeamAgent

@Preview(value="3.8.1")
public interface Agent<Req extends AgentRequest<Req,Resp>,Resp extends AgentResponse>
extends AgentHandler, org.noear.solon.flow.NamedTaskComponent

智能体核心接口

定义 AI 智能体的行为契约。作为 NamedTaskComponent 接入 Solon Flow，实现分布式协作。

从以下版本开始:

3.8.1

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ID_END
static java.lang.String	ID_START
static java.lang.String	KEY_CURRENT_TEAM_TRACE_KEY
static java.lang.String	KEY_CURRENT_UNIT_TRACE_KEY
static java.lang.String	KEY_PROTOCOL
static java.lang.String	KEY_SESSION
static org.slf4j.Logger	LOG
static java.lang.String	META_AGENT

方法概要

限定符和类型	方法和说明
default AssistantMessage	call(AgentSession session) 恢复执行（用于从会话中恢复 prompt 执行）
AssistantMessage	call(@Nullable Prompt prompt, AgentSession session) 指定指令的任务执行（开始新任务）
java.lang.String	name() 智能体名称（唯一标识）
default AgentProfile	profile() 智能体档案（能力画像与交互契约）
default Req	prompt() 创建恢复请求构建器（用于从会话中恢复 prompt 执行）
default Req	prompt(Prompt prompt) 创建基于 Prompt 的请求构建器
default Req	prompt(java.lang.String prompt) 创建基于字符串指令的请求构建器
java.lang.String	role() 智能体角色职责（用于 Prompt 提示与协作分发参考）
default java.lang.String	roleFor(org.noear.solon.flow.FlowContext context) 生成动态角色描述
default void	run(org.noear.solon.flow.FlowContext context, org.noear.solon.flow.Node node) Solon Flow 节点运行实现 处理 Session 初始化、协议注入、推理执行及轨迹同步。
default org.noear.snack4.ONode	toMetadata(org.noear.solon.flow.FlowContext context) 生成动态元数据（用于协作传递）

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

title

字段详细资料

LOG

static final org.slf4j.Logger LOG

KEY_CURRENT_UNIT_TRACE_KEY

static final java.lang.String KEY_CURRENT_UNIT_TRACE_KEY

另请参阅:

常量字段值

KEY_CURRENT_TEAM_TRACE_KEY

static final java.lang.String KEY_CURRENT_TEAM_TRACE_KEY

另请参阅:

常量字段值

KEY_SESSION

static final java.lang.String KEY_SESSION

另请参阅:

常量字段值

KEY_PROTOCOL

static final java.lang.String KEY_PROTOCOL

另请参阅:

常量字段值

META_AGENT

static final java.lang.String META_AGENT

另请参阅:

常量字段值

ID_START

static final java.lang.String ID_START

另请参阅:

常量字段值

ID_END

static final java.lang.String ID_END

另请参阅:

常量字段值

方法详细资料

name

java.lang.String name()

智能体名称（唯一标识）

指定者:

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

role

java.lang.String role()

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

roleFor

default java.lang.String roleFor(org.noear.solon.flow.FlowContext context)

生成动态角色描述

参数:

context - 流程上下文（支持使用 context.vars 渲染模板）

profile

default AgentProfile profile()

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

toMetadata

default org.noear.snack4.ONode toMetadata(org.noear.solon.flow.FlowContext context)

生成动态元数据（用于协作传递）

prompt

default Req prompt(Prompt prompt)

创建基于 Prompt 的请求构建器

prompt

default Req prompt(java.lang.String prompt)

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

prompt

default Req prompt()

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

call

default AssistantMessage call(AgentSession session)
                       throws java.lang.Throwable

恢复执行（用于从会话中恢复 prompt 执行）

抛出:

java.lang.Throwable

call

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

指定指令的任务执行（开始新任务）

指定者:

call 在接口中 AgentHandler

参数:

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

session - 会话上下文

返回:

智能体生成的响应消息

抛出:

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

run

default void run(org.noear.solon.flow.FlowContext context,
                 org.noear.solon.flow.Node node)
          throws java.lang.Throwable

Solon Flow 节点运行实现

处理 Session 初始化、协议注入、推理执行及轨迹同步。

指定者:

run 在接口中 org.noear.solon.flow.TaskComponent

抛出:

java.lang.Throwable