Struct AgentBuilder 

pub struct AgentBuilder { /* private fields */ }

Agent Builder — 流畅 API 创建 FunctionCallingAgent

使用 Builder 模式，让用户只需 3 行代码就能创建并运行 Agent。

基本用法

let agent = AgentBuilder::new()
    .llm(OpenAIChat::new(OpenAIConfig::new("sk-...")))
    .system("You are a helpful assistant.")
    .tool(Calculator::new())
    .build()?;

使用 Arc

let llm = wrap_chat_model(OpenAIChat::new(config));
let agent = AgentBuilder::new()
    .llm_from_arc(llm)
    .system("You are a helpful assistant.")
    .build()?;

Implementations

impl AgentBuilder

pub fn new() -> Self

创建新的 AgentBuilder

pub fn llm<L>(self, llm: L) -> Self

where L: BaseChatModel + Send + Sync + 'static, L::Error: Into<ProviderError>,

设置 LLM（任何实现了 BaseChatModel 的类型）

自动包装为 Arc<dyn BaseChatModel<Error = ProviderError>>。

pub fn llm_from_arc( self, llm: Arc<dyn BaseChatModel<Error = ProviderError> + Send + Sync>, ) -> Self

设置 LLM（从已包装的 Arc<dyn BaseChatModel>）

适用于已通过 wrap_chat_model() 或 LLMClient 创建的 LLM 实例。

pub fn system(self, prompt: impl Into<String>) -> Self

设置系统提示词

pub fn tool<T: BaseTool + 'static>(self, tool: T) -> Self

添加单个工具

pub fn tools(self, tools: Vec<Arc<dyn BaseTool>>) -> Self

添加多个工具

pub fn max_iterations(self, n: usize) -> Self

设置最大迭代次数

pub fn build(self) -> Result<FunctionCallingAgent, AgentError>

构建 FunctionCallingAgent

Errors

如果没有设置 LLM，返回 AgentError::Other。

pub fn build_as_agent(self) -> Result<Arc<dyn BaseAgent>, AgentError>

构建并包装为 Arc<dyn BaseAgent>，可直接传给 AgentExecutor

Errors

如果没有设置 LLM，返回 AgentError::Other。

pub fn get_max_iterations(&self) -> usize

获取最大迭代次数

Trait Implementations

impl Default for AgentBuilder

fn default() -> Self

Returns the “default value” for a type.