Struct Agent 

pub struct Agent {
    pub agent_id: String,
    pub description: Option<String>,
    pub state: AgentState,
    pub record_direct_tool_call: bool,
    pub trace_attributes: HashMap<String, String>,
    pub max_tool_calls: Option<usize>,
    /* private fields */
}

The main agent struct for conversational AI.

Fields

agent_id: String

description: Option<String>

state: AgentState

record_direct_tool_call: bool

Whether to record direct tool calls in message history.

trace_attributes: HashMap<String, String>

Custom trace attributes for OpenTelemetry.

max_tool_calls: Option<usize>

Maximum number of tool calls per cycle (None = unlimited).

Implementations

impl Agent

pub fn builder() -> AgentBuilder

Creates a new agent builder.

pub fn name(&self) -> Option<&String>

Returns the agent name.

pub fn set_name(&mut self, name: impl Into<String>)

Sets the agent name.

pub fn system_prompt(&self) -> Option<&str>

Returns the system prompt.

pub fn set_system_prompt(&mut self, prompt: impl Into<String>)

Sets the system prompt.

pub fn messages(&self) -> &Messages

Returns the current messages.

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

Adds a message to the conversation.

pub fn clear_messages(&mut self)

Clears all messages.

pub fn tool_registry(&self) -> &ToolRegistry

Returns the tool registry.

pub fn tool_registry_mut(&mut self) -> &mut ToolRegistry

Returns a mutable reference to the tool registry.

pub fn tool_names(&self) -> Vec<&str>

Returns the names of all registered tools.

pub fn agent_id(&self) -> Option<&str>

Returns the agent ID.

pub fn hooks(&self) -> &HookRegistry

Returns the hooks registry.

pub fn hooks_mut(&mut self) -> &mut HookRegistry

Returns a mutable reference to the hooks registry.

pub fn conversation_manager(&self) -> &dyn ConversationManager

Returns the conversation manager.

pub fn conversation_manager_mut(&mut self) -> &mut dyn ConversationManager

Returns a mutable reference to the conversation manager.

pub fn state(&self) -> &AgentState

Returns a reference to the agent state.

pub fn state_mut(&mut self) -> &mut AgentState

Returns a mutable reference to the agent state.

pub fn interrupt_state(&self) -> &InterruptState

Returns a reference to the interrupt state.

pub fn interrupt_state_mut(&mut self) -> &mut InterruptState

Returns a mutable reference to the interrupt state.

pub fn set_interrupt_state(&mut self, state: InterruptState)

Sets the interrupt state.

pub fn is_interrupted(&self) -> bool

Returns whether the agent is currently in an interrupt state.

pub fn set_messages(&mut self, messages: Messages)

Sets the messages directly.

pub fn tool(&mut self) -> ToolCaller<'_>

Returns a tool caller for direct tool invocation.

This enables the pattern: agent.tool().invoke("tool_name", input).await

pub fn trace_attributes(&self) -> &HashMap<String, String>

Returns the trace attributes.

pub fn set_trace_attribute( &mut self, key: impl Into<String>, value: impl Into<String>, )

Sets a trace attribute.

pub fn max_tool_calls(&self) -> Option<usize>

Returns the max tool calls setting.

pub fn set_max_tool_calls(&mut self, max: Option<usize>)

Sets the max tool calls.

pub fn call(&mut self, prompt: impl Into<AgentInput>) -> Result<AgentResult>

Invokes the agent synchronously (blocking).

pub async fn invoke_async( &mut self, prompt: impl Into<AgentInput>, ) -> Result<AgentResult>

Invokes the agent asynchronously.

pub async fn stream_async( &mut self, prompt: impl Into<AgentInput>, ) -> impl Stream<Item = Result<TypedEvent>> + '_

Returns a stream of events from the agent.