Struct MapOverTextAgent 

pub struct MapOverTextAgent { /* private fields */ }

Iterates a single agent over each item in a state list. Reads state[list_key], runs agent per item (setting state[item_key]), collects results into state[output_key].

Implementations

impl MapOverTextAgent

pub fn new( name: impl Into<String>, agent: Arc<dyn TextAgent>, list_key: impl Into<String>, ) -> MapOverTextAgent

Create a new map-over agent that iterates over a list in state.

pub fn with_middleware_chain(self, chain: MiddlewareChain) -> MapOverTextAgent

Attach a middleware chain. AgentEvent::LoopIteration is emitted through it before each item is processed (zero-based), so on_event observers (e.g. M::on_loop) fire per item.

pub fn item_key(self, key: impl Into<String>) -> MapOverTextAgent

Set the state key for the current item (default: “_item”).

pub fn output_key(self, key: impl Into<String>) -> MapOverTextAgent

Set the state key for the output list (default: “_results”).

Trait Implementations

impl TextAgent for MapOverTextAgent

fn name(&self) -> &str

Human-readable name for logging and debugging.

fn run<'life0, 'life1, 'async_trait>( &'life0 self, state: &'life1 State, ) -> Pin<Box<dyn Future<Output = Result<String, AgentError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, MapOverTextAgent: 'async_trait,

Execute this agent. Reads/writes state. Returns the final text output.

fn run_with<'life0, 'life1, 'async_trait>( &'life0 self, request: RunRequest, state: &'life1 State, ) -> Pin<Box<dyn Future<Output = Result<RunResult, AgentError>> + Send + 'async_trait>>

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

Run one request and report everything it produced: the reply, the turns to append to a conversation, token usage and tool calls.

fn run_stream<'a>( &'a self, request: RunRequest, state: State, ) -> Pin<Box<dyn Stream<Item = Result<RunEvent, AgentError>> + Send + 'a>>

Run one request as a stream of RunEvents: text as the model writes it, each tool call and result, then RunEvent::Finished.

fn stream( &self, prompt: impl Into<String>, ) -> Pin<Box<dyn Stream<Item = Result<RunEvent, AgentError>> + Send + '_>>

where Self: Sized,

Stream the reply to one question, with no history and fresh state.

fn ask<'life0, 'async_trait>( &'life0 self, prompt: impl Into<String> + Send + 'async_trait, ) -> Pin<Box<dyn Future<Output = Result<String, AgentError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: Sized + 'async_trait,

Ask one question, with no history and fresh state, and get the reply.

fn ask_as<'life0, 'async_trait, T>( &'life0 self, prompt: impl Into<String> + Send + 'async_trait, ) -> Pin<Box<dyn Future<Output = Result<T, AgentError>> + Send + 'async_trait>>

where 'life0: 'async_trait, Self: Sized + 'async_trait, T: DeserializeOwned + JsonSchema + Send + 'async_trait,

Ask one question and get the reply as a T.

fn chat(&self) -> Chat<&Self>

where Self: Sized,

Start a conversation that remembers its turns. See Chat.