Struct ToolUseLoop 

pub struct ToolUseLoop { /* private fields */ }

管理 LLM 与工具调用闭环。

内部全为 Arc/Clone，clone 为 O(1)，支持并发 execute。

Implementations

impl ToolUseLoop

pub fn new( model: ResolvedModel, executor: ToolExecutor, config: ToolUseConfig, deps: ToolUseDeps, ) -> Self

pub fn simple(model: ResolvedModel, executor: ToolExecutor) -> Self

便捷构造 — 使用默认配置和依赖。

pub fn model(&self) -> &ResolvedModel

获取模型引用。

pub fn executor(&self) -> &ToolExecutor

获取执行器引用。

pub fn config(&self) -> &ToolUseConfig

获取配置引用。

pub fn deps(&self) -> &ToolUseDeps

获取依赖引用。

pub async fn execute( &self, messages: Vec<Message>, ) -> Result<ToolUseResult, LlmError>

非流式执行

v0.4+: AgentState 驱动 — 使用 Graph<AgentState>.run_inline() 执行 ReAct 循环。 零序列化，编译期类型安全。

pub fn execute_stream(&self, messages: Vec<Message>) -> AgentStream

流式执行，返回事件接收器。

v0.4+: AgentState 驱动 — 使用 Graph<AgentState>.run_inline() + AgentEventSink。 与 execute() 共享 ReAct Graph 逻辑，消除手写 while 循环。

数据流

execute_stream()
  → 创建 channel + AgentEventSink
  → 构建 ReAct Graph
  → ExecutionContext(state, sink)
  → graph.run_inline()
  → AgentEventSink: StreamChunk → AgentEvent → channel
  → 完成后发送 LoopEnd / LoopError

Trait Implementations

impl Clone for ToolUseLoop

fn clone(&self) -> ToolUseLoop

Returns a duplicate of the value.

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

Performs copy-assignment from source.