Struct AgentBuilder 

pub struct AgentBuilder<P: Provider> { /* private fields */ }

Builder for creating agents

Implementations

impl<P: Provider> AgentBuilder<P>

pub fn new(provider: P) -> Self

Create a new builder with a provider

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

Set the model to use

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

Set the system prompt

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

Alias for system_prompt

pub fn temperature(self, temp: f64) -> Self

Set the temperature

pub fn max_tokens(self, tokens: u64) -> Self

Set max tokens

pub fn extra_params(self, params: Value) -> Self

Add extra provider-specific parameters

pub fn tool_policy(self, policy: RiskyToolPolicy) -> Self

Set tool policy

pub fn approval_handler(self, handler: impl ApprovalHandler + 'static) -> Self

Set external approval handler

pub fn interaction_handler( self, handler: impl InteractionHandler + 'static, ) -> Self

Set interaction handler (for HITL)

pub fn max_history_messages(self, count: usize) -> Self

Set max history messages (sliding window)

pub fn max_tool_output_chars(self, count: usize) -> Self

Set max tool output characters

pub fn json_mode(self, enable: bool) -> Self

Enable strict JSON mode (enforces response_format: json_object)

pub fn persona(self, persona: Persona) -> Self

Set the agent’s personality

pub fn notifier(self, notifier: impl Notifier + 'static) -> Self

Set a notifier

pub fn session_id(self, id: impl Into<String>) -> Self

Set session ID for persistence

pub fn role(self, role: AgentRole) -> Self

Set the agent’s role

pub fn context_injector(self, injector: impl ContextInjector + 'static) -> Self

Add a context injector

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

Add a tool

pub fn shared_tool(self, tool: Arc<dyn Tool>) -> Self

Add a shared tool

pub fn tools(self, tools: ToolSet) -> Self

Add multiple tools from a toolset

pub fn with_memory(self, memory: Arc<dyn Memory>) -> Self

Add memory tools using the provided memory implementation

pub fn with_dynamic_skills(self, skill_loader: Arc<SkillLoader>) -> Result<Self>

Add DynamicSkill support (ClawHub skills, custom scripts)

Security

CRITICAL: DynamicSkill and Python Sidecar are mutually exclusive. This method will return an error if Python Sidecar has already been configured.

Rationale: If both are enabled, malicious DynamicSkills can pollute the Agent’s context with secrets, which may then be used by LLM-generated Python code in the unsandboxed Sidecar to exfiltrate data.

See SECURITY.md for details.

pub async fn with_code_interpreter( self, address: impl Into<String>, ) -> Result<Self>

Add code interpreter capability using the given sidecar address

Security

CRITICAL: Python Sidecar and DynamicSkill are mutually exclusive. This method will return an error if DynamicSkill has already been configured.

Rationale: Python Sidecar has no sandbox isolation. If DynamicSkill is also enabled, malicious skills can pollute the Agent’s context, leading to secret exfiltration via LLM-generated Python code in the Sidecar.

See SECURITY.md for details.

pub fn build(self) -> Result<Agent<P>>

Build the agent

Security Defaults

If neither Python Sidecar nor DynamicSkill has been explicitly configured, this method will automatically enable DynamicSkill with default settings:

• Skills directory: ./skills
• Network access: disabled (secure sandbox)

To use Python Sidecar instead, call .with_code_interpreter() before .build().

pub fn with_delegation(self, coordinator: Arc<Coordinator>) -> Self

Add delegation support using the provided coordinator

pub fn with_scheduler(self, scheduler: Arc<Scheduler>) -> Self

Add scheduling support using the provided scheduler

pub fn with_swarm( self, manager: Arc<Mutex<SwarmManager>>, cmd_rx: Receiver<SwarmEvent>, ) -> Self

Enable dynamic swarming capabilities