Struct StructuredChatBuilder 

pub struct StructuredChatBuilder<T, H: RetryHandler = DefaultRetryHandler> { /* private fields */ }

Available on crate feature client only.

Builder for structured output chat requests.

Created via [ChatRequestBuilder::structured()].

Implementations

impl<T: JsonSchema + DeserializeOwned> StructuredChatBuilder<T, DefaultRetryHandler>

pub fn new(inner: ChatRequestBuilder) -> Self

Create a new structured builder from a chat request builder.

impl<T: JsonSchema + DeserializeOwned, H: RetryHandler> StructuredChatBuilder<T, H>

pub fn max_retries(self, retries: u32) -> Self

Set the maximum number of retries on validation failure.

pub fn retry_handler<H2: RetryHandler>( self, handler: H2, ) -> StructuredChatBuilder<T, H2>

Set a custom retry handler.

pub fn schema_name(self, name: impl Into<String>) -> Self

Override the schema name.

pub fn system(self, content: impl Into<String>) -> Self

Add a system message.

pub fn user(self, content: impl Into<String>) -> Self

Add a user message.

pub fn assistant(self, content: impl Into<String>) -> Self

Add an assistant message.

pub fn max_tokens(self, max_tokens: i64) -> Self

Set max tokens.

pub fn temperature(self, temperature: f64) -> Self

Set temperature.

pub fn timeout(self, timeout: Duration) -> Self

Set request timeout.

pub async fn send( self, client: &LLMClient, ) -> Result<StructuredResult<T>, StructuredError>

Execute the structured request (blocking, async).

Returns a typed result with validation retries if configured.

pub async fn stream( self, client: &LLMClient, ) -> Result<StructuredJSONStream<T>, StructuredError>

Available on crate feature streaming only.

Execute and stream structured responses.

Note: Streaming does not support retries. For retry behavior, use [send].