Struct LlmAgent 

pub struct LlmAgent { /* private fields */ }

An actor that calls an LLM provider and returns completions.

Implementations

impl LlmAgent

pub fn new(config: ActorConfig, llm_config: LlmConfig) -> Self

pub fn with_publisher(self, p: EventPublisher) -> Self

Attach an EventPublisher for MQTT output.

pub async fn complete(&self, prompt: &str) -> Result<String>

Send a prompt to the configured LLM provider and return the completion. Also records token usage and cost in the actor metrics.

Trait Implementations

impl Actor for LlmAgent

fn id(&self) -> String

Return this actor’s unique WID identifier.

fn name(&self) -> &str

Return this actor’s human-readable name.

fn state(&self) -> ActorState

Return the current lifecycle state.

fn metrics(&self) -> Arc<ActorMetrics>

Return a reference to this actor’s metrics.

fn mailbox(&self) -> Sender<Message>

Return a sender handle to this actor’s mailbox.

fn is_protected(&self) -> bool

Return whether this actor is protected from external kill commands.

fn handle_message<'life0, 'async_trait>( &'life0 mut self, message: Message, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called with each incoming message from the mailbox.

fn on_heartbeat<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Called on heartbeat tick; default implementation is a no-op.

fn run<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Drive the actor’s main loop.

fn on_start<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Called once after the actor is created, before the message loop starts.

fn on_stop<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: 'async_trait,

Called once just before the actor loop exits.