Struct Choice 

pub struct Choice<T> { /* private fields */ }

A choice question whose successful answer contains T.

Implementations

impl<T: Serialize + DeserializeOwned + Ord> Choice<T>

pub fn new<const N: usize, D: Serialize>( instructions: impl Serialize, alternatives: [(T, D); N], ) -> Result<Self, ProviderError>

Define a fixed set of alternatives, with its count checked at compile time. Serde string names become labels; descriptions accept strings, objects, arrays, or None when the label needs no explanation.

use rig_typesafeai::Choice;
let _ = Choice::new("Choose a route", [("only".to_owned(), "One option")]);

pub fn try_from_iter<I, D>( instructions: impl Serialize, alternatives: I, ) -> Result<Self, ProviderError>

where I: IntoIterator<Item = (T, D)>, D: Serialize,

Define runtime-supplied alternatives, validating their count at construction.

Trait Implementations

impl<T> Clone for Choice<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for Choice<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: DeserializeOwned + Ord> Query for Choice<T>

type Response = Answer

The intermediate response shape deserialized by Serde.

type Output = ChoiceAnswer<T>

The validated application answer shape.

fn decode(&self, response: Answer) -> Result<Self::Output, ProviderError>

Validate and convert a deserialized response. Composite queries delegate to their fields, keeping validation inside the evaluation error boundary.

fn named(self, id: impl Into<String>) -> Result<NamedQuery<Self>, ProviderError>

where Self: Sized,

Give a standalone question a runtime ID. Named struct fields do not need this.

fn join<Q: Query>(self, other: Q) -> JoinedQuery<Self, Q>

where Self: Sized,

Flatten two object-shaped queries into one evaluation request. Duplicate IDs are rejected before sending the request. Child queries must serialize with stable field names: decoding uses those names to partition the response before delegating to each child.

fn map<A, F>(self, map: F) -> MappedQuery<Self, F>

where Self: Sized, F: Fn(Self::Output) -> A + WasmCompatSend + WasmCompatSync,

Project validated answers into an application value.

impl<T> Serialize for Choice<T>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.