Struct Agent 

pub struct Agent {
    pub id: String,
    pub persona: Persona,
    pub tools: ToolRegistry,
    pub memory: AgentMemory,
    pub planner: Arc<dyn Planner>,
    /* private fields */
}

An autonomous agent with tool use and reasoning capabilities.

Fields

id: String

Agent identifier.

persona: Persona

Agent persona.

tools: ToolRegistry

Available tools.

memory: AgentMemory

Agent memory.

planner: Arc<dyn Planner>

Planning strategy.

Implementations

impl Agent

pub fn builder() -> AgentBuilder

Creates a new agent builder.

pub fn system_prompt(&self) -> String

Returns the system prompt.

pub fn set_engine(&mut self, engine: Arc<Engine>)

Sets the inference engine.

pub async fn run(&mut self, objective: &str) -> Result<String>

Runs the agent with the given objective using ReAct-style reasoning.

Errors

Returns an error if execution fails.

pub fn add_message(&mut self, message: Message)

Adds a message to the agent’s memory.

pub fn clear_memory(&mut self)

Clears the agent’s working memory.

pub async fn step(&mut self, input: &str) -> Result<StepResult>

Runs a single step of reasoning (for streaming/interactive use).

pub async fn step_streaming( &mut self, input: &str, ) -> Result<impl Stream<Item = Result<String>>>

Runs a single step with streaming output.