Agent

Struct Agent 

Source
pub struct Agent {
    pub name: String,
    pub llm: Arc<dyn LLM>,
    pub tools: HashMap<String, Arc<dyn Tool>>,
    pub system_prompt: Option<String>,
    pub memory: Vec<String>,
    pub max_iterations: usize,
}
Expand description

High-level agent that holds an LLM and a set of tools, plus simple agent state.

Fields§

§name: String

A short, human-friendly name for the agent instance.

§llm: Arc<dyn LLM>

The LLM implementation used to generate responses/thoughts.

§tools: HashMap<String, Arc<dyn Tool>>

Registered tools the agent may call by name.

§system_prompt: Option<String>

Optional system prompt / instructions provided to the LLM describing the agent’s role and available behaviors.

§memory: Vec<String>

Simple short-term memory / conversation context kept by the agent. We store Message objects elsewhere in the crate; for a minimal implementation we keep user-visible strings here.

§max_iterations: usize

Maximum iterations when running a looped decision process.

Implementations§

Source§

impl Agent

Source

pub fn new( name: impl Into<String>, llm: Arc<dyn LLM>, max_iterations: Option<usize>, ) -> Self

Create a new Agent with the provided name and LLM. Tools start empty.

Source

pub fn register_tool( &mut self, name: Option<&str>, tool: Arc<dyn Tool>, ) -> &mut Self

Register a tool under the given name. Replaces any existing tool with the same name. Returns &mut Self for chaining.

Source

pub fn change_max_iterations(&mut self, max_iterations: usize)

Change the maximum iterations for the agent’s decision process.

Source

pub fn get_tool(&self, name: &str) -> Option<Arc<dyn Tool>>

Look up a tool by name.

Source

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

Set or replace the agent’s system prompt.

Source

pub fn generate_system_prompt(&self) -> Vec<Message>

Source

pub fn generate_tools_prompt(&self) -> Vec<Message>

Trait Implementations§

Source§

impl AgentRunner for Agent

Source§

fn call_llm<'life0, 'life1, 'async_trait>( &'life0 self, prompt: &'life1 str, ) -> Pin<Box<dyn Future<Output = AgentExecuteResult> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Call the LLM with a prompt and return the generation result.

Auto Trait Implementations§

§

impl Freeze for Agent

§

impl !RefUnwindSafe for Agent

§

impl Send for Agent

§

impl Sync for Agent

§

impl Unpin for Agent

§

impl !UnwindSafe for Agent

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more