Struct AgentFlowNode 

pub struct AgentFlowNode { /* private fields */ }

Agent 在 Graph 中的节点包装。

将 ToolUseLoop 适配为 FlowNode，使其可以作为 Graph 的节点执行。

State 约定

• 输入: ctx.get("messages") → Vec<serde_json::Value> 或 serde_json::Value 数组
• 输出: ctx.set("messages") → 更新后的消息列表
• 自定义 key: 通过 message_key 配置

执行模式

• ToolUseLoop 模式（默认）：直接调用 ToolUseLoop，保留所有功能（context budget、compaction、fallback、retry）
• ReAct Graph 模式：内部构建 LLM → Condition → Tool → LLM 有环图，架构更清晰

示例

use lellm_agent::AgentFlowNode;
use lellm_graph::{GraphBuilder, NodeKind};

// ToolUseLoop 模式（默认）
let agent = AgentFlowNode::new("agent", tool_use_loop.clone());
let mut graph = GraphBuilder::new("my_graph");
graph.node("agent", NodeKind::External(Arc::new(agent)));

// ReAct Graph 模式
let agent = AgentFlowNode::new("agent", tool_use_loop)
    .use_react_graph(true);
graph.node("agent_react", NodeKind::External(Arc::new(agent)));

Implementations

impl AgentFlowNode

pub fn new(name: impl Into<String>, loop_: ToolUseLoop) -> Self

创建新的 AgentFlowNode。

pub fn message_key(self, key: impl Into<String>) -> Self

设置 State 中消息的 key（默认 “messages”）。

pub fn use_react_graph(self, enabled: bool) -> Self

使用 ReAct Graph 模式（内部构建 LLM → Condition → Tool → LLM 有环图）。

pub fn hook(self, hook: impl AgentHook + 'static) -> Self

添加 Agent-level hook。

Hook 在 agent loop 执行前后调用。

Trait Implementations

impl Clone for AgentFlowNode

fn clone(&self) -> AgentFlowNode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl FlowNode for AgentFlowNode

fn execute<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, ctx: &'life1 mut NodeContext<'life2>, ) -> Pin<Box<dyn Future<Output = Result<(), GraphError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

执行 — 运行完整的 Agent Loop。