Struct Agent 

pub struct Agent { /* private fields */ }

A configured agent ready to accept user messages and execute tool-use loops.

The agent holds a shared reference to an InferenceEngine (model + backend) and its own LlamaContext (KV cache). Multiple agents can share the same engine without loading the model multiple times.

Implementations

impl Agent

pub fn builder() -> AgentBuilder

Create an AgentBuilder for step-by-step configuration.

pub fn chat( &mut self, user_message: &str, on_event: impl FnMut(AgentEvent), ) -> Result<(), AgentError>

Send a user message and run the agent loop until completion.

The on_event callback receives streaming events as the agent generates text and executes tools.

pub fn chat_simple(&mut self, user_message: &str) -> Result<String, AgentError>

Send a user message and collect the full response text.

Convenience method that runs the agent loop and returns the final concatenated response text.

pub fn engine(&self) -> &Arc<InferenceEngine>

Access the shared inference engine.

pub fn conversation(&self) -> &Conversation

Access the conversation history.

pub fn conversation_mut(&mut self) -> &mut Conversation

Mutable access to the conversation history.

pub fn tools(&self) -> &ToolRegistry

Access the tool registry.

pub fn register_tool(&mut self, tool: Box<dyn Tool>)

Register an additional tool at runtime.

pub fn skills(&self) -> &SkillRegistry

Access the skill registry.

pub fn agents_md(&self) -> &AgentsMdRegistry

Access the AGENTS.md registry.

pub fn clear_history(&mut self)

Clear the conversation history (keeping the system prompt).