Struct Operator 

pub struct Operator<Q: TypedQuestion> { /* private fields */ }

A reusable typed question, independent of any inference provider.

This explicitly scripted provider demonstrates typed output without network access or semantic inference.

use semantic_operators::{
    AnswerValue, Boolean, FunctionProvider, IndexMap, Operator,
    ProviderFuture, Request, State, make_answer,
};

fn scripted(request: &Request) -> ProviderFuture<'_> {
    Box::pin(async move {
        request.questions().iter().map(|(name, question)| {
            let probabilities = IndexMap::from([
                ("true".into(), 0.1), ("false".into(), 0.9),
            ]);
            Ok((name.clone(), make_answer(
                question, AnswerValue::Boolean(false), probabilities, None,
            )?))
        }).collect()
    })
}

let operator = Operator::new("urgent", Boolean::new("Is this urgent?")?)?;
let provider = FunctionProvider::new(scripted);
let answer = futures_executor::block_on(operator.ask(&provider, &State::text("Fixture")))?;
assert_eq!(answer.value(), Some(&false)); // False is a decided answer.

Implementations

impl<Q: TypedQuestion> Operator<Q>

pub fn new(name: impl Into<String>, question: Q) -> Result<Self>

Create an operator with a nonempty name.

Errors

Returns InvalidArgument if the operator name is empty.

pub fn name(&self) -> &str

Stable name used in batches and traces.

pub fn question(&self) -> &Q

Typed question definition.

pub fn erased(&self) -> NamedQuestion

Erase the type for a heterogeneous batch.

pub async fn ask<P: Provider + ?Sized>( &self, provider: &P, state: &State, ) -> Result<Answer<Q::Output>>

Ask about a state and retain a typed answer, including uncertainty.

Errors

Propagates request, provider, response-validation, and typed-conversion errors. An undecided answer is successful and retains its evidence.

pub async fn ask_request<P: Provider + ?Sized>( &self, provider: &P, request: &Request, ) -> Result<Answer<Q::Output>>

Ask about a request’s state and assets, replacing its questions.

Errors

Propagates request/image validation, provider, response-validation, and typed-conversion errors. The supplied request’s questions are replaced.

pub fn answer(&self, answers: &Answers) -> Result<Answer<Q::Output>>

Read this operator’s checked typed result from a heterogeneous batch.

Errors

Returns InvalidArgument if this operator is absent, or a normalization or conversion error if the retained answer does not match its question/type.

Trait Implementations

impl<Q: Clone + TypedQuestion> Clone for Operator<Q>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Q: Debug + TypedQuestion> Debug for Operator<Q>

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

Formats the value using the given formatter.