Struct TypedPromptRequest 

pub struct TypedPromptRequest<'a, T, M, P>
where
    T: JsonSchema + DeserializeOwned + WasmCompatSend,
    M: CompletionModel,
    P: PromptHook<M>,
{ /* private fields */ }

A builder for creating typed prompt requests that return deserialized structured output.

This struct wraps a standard PromptRequest and adds:

• Automatic JSON schema generation from the target type T
• Automatic deserialization of the response into T

Example

let forecast: WeatherForecast = agent
    .prompt_typed("What's the weather in NYC?")
    .max_turns(3)
    .await?;

Implementations

impl<'a, T, M, P> TypedPromptRequest<'a, T, M, P>

where T: JsonSchema + DeserializeOwned + WasmCompatSend, M: CompletionModel, P: PromptHook<M>,

pub fn from_agent(agent: &Agent<M, P>, prompt: impl Into<Message>) -> Self

Create a new TypedPromptRequest from an agent.

This automatically sets the output schema based on the type parameter T.

pub fn max_turns(self, depth: usize) -> Self

Set the maximum number of turns for multi-turn conversations.

A given agent may require multiple turns for tool-calling before giving an answer. If the maximum turn number is exceeded, it will return a StructuredOutputError::PromptError wrapping a MaxTurnsError.

pub fn with_tool_concurrency(self, concurrency: usize) -> Self

Add concurrency to the prompt request.

This will cause the agent to execute tools concurrently.

pub fn with_history(self, history: &'a mut Vec<Message>) -> Self

Add chat history to the prompt request.

pub fn with_hook<P2>(self, hook: P2) -> TypedPromptRequest<'a, T, M, P2>

where P2: PromptHook<M>,

Attach a per-request hook for tool call events.

This overrides any default hook set on the agent.

Trait Implementations

impl<'a, T, M, P> IntoFuture for TypedPromptRequest<'a, T, M, P>

where T: JsonSchema + DeserializeOwned + WasmCompatSend + 'a, M: CompletionModel + 'a, P: PromptHook<M> + 'static,

type Output = Result<T, StructuredOutputError>

The output that the future will produce on completion.

type IntoFuture = Pin<Box<dyn Future<Output = <TypedPromptRequest<'a, T, M, P> as IntoFuture>::Output> + Send + 'a>>

Which kind of future are we turning this into?

fn into_future(self) -> Self::IntoFuture

Creates a future from a value.