agents_sdk::agent

Trait AgentHandle

Source 
pub trait AgentHandle: Send + Sync {
    // Required methods
    fn describe<'life0, 'async_trait>(
        &'life0 self,
    ) -> Pin<Box<dyn Future<Output = AgentDescriptor> + Send + 'async_trait>>
       where 'life0: 'async_trait,
             Self: 'async_trait;
    fn handle_message<'life0, 'async_trait>(
        &'life0 self,
        input: AgentMessage,
        state: Arc<AgentStateSnapshot>,
    ) -> Pin<Box<dyn Future<Output = Result<AgentMessage, Error>> + Send + 'async_trait>>
       where 'life0: 'async_trait,
             Self: 'async_trait;

    // Provided methods
    fn handle_message_stream<'life0, 'async_trait>(
        &'life0 self,
        input: AgentMessage,
        state: Arc<AgentStateSnapshot>,
    ) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn Stream<Item = Result<StreamChunk, Error>> + Send>>, Error>> + Send + 'async_trait>>
       where 'life0: 'async_trait,
             Self: 'async_trait { ... }
    fn current_interrupt<'life0, 'async_trait>(
        &'life0 self,
    ) -> Pin<Box<dyn Future<Output = Result<Option<AgentInterrupt>, Error>> + Send + 'async_trait>>
       where 'life0: 'async_trait,
             Self: 'async_trait { ... }
    fn resume_with_approval<'life0, 'async_trait>(
        &'life0 self,
        _action: HitlAction,
    ) -> Pin<Box<dyn Future<Output = Result<AgentMessage, Error>> + Send + 'async_trait>>
       where 'life0: 'async_trait,
             Self: 'async_trait { ... }
}
Expand description

Abstraction for hosting a fully configured agent (planner + tools + prompts).

Required Methods§

Source

fn describe<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = AgentDescriptor> + Send + 'async_trait>>
where 'life0: 'async_trait, Self: 'async_trait,

Source

fn handle_message<'life0, 'async_trait>( &'life0 self, input: AgentMessage, state: Arc<AgentStateSnapshot>, ) -> Pin<Box<dyn Future<Output = Result<AgentMessage, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, Self: 'async_trait,

Provided Methods§

Source

fn handle_message_stream<'life0, 'async_trait>( &'life0 self, input: AgentMessage, state: Arc<AgentStateSnapshot>, ) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn Stream<Item = Result<StreamChunk, Error>> + Send>>, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, Self: 'async_trait,

Handle a message with streaming response Default implementation falls back to non-streaming handle_message()

Source

fn current_interrupt<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<AgentInterrupt>, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, Self: 'async_trait,

Get the current pending interrupt if any Returns None if no interrupts are pending

Source

fn resume_with_approval<'life0, 'async_trait>( &'life0 self, _action: HitlAction, ) -> Pin<Box<dyn Future<Output = Result<AgentMessage, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, Self: 'async_trait,

Resume execution after human approval of an interrupt

§Arguments
  • action - The human’s decision (Accept, Edit, Reject, or Respond)
§Returns

The agent’s response after processing the action

Implementations on Foreign Types§

Source§

impl<T> AgentHandle for RuntimeAgent<T>
where T: AgentHandle + Sync + Send,

Source§

fn describe<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = AgentDescriptor> + Send + 'async_trait>>
where 'life0: 'async_trait, RuntimeAgent<T>: 'async_trait,

Source§

fn handle_message<'life0, 'async_trait>( &'life0 self, input: AgentMessage, state: Arc<AgentStateSnapshot>, ) -> Pin<Box<dyn Future<Output = Result<AgentMessage, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, RuntimeAgent<T>: 'async_trait,

Implementors§