MyApp

<back to all web services

CreateDecision

Decisions API (OpenRouter)

import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
Object = TypeVar('Object')


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionAnswer:
    type: Optional[str] = None
    noul: Optional[float] = None
    """
    noul: probability from 0 (no) to 1 (yes)
    """

    choice: Optional[str] = None
    """
    choice: the selected option
    """

    score: Optional[float] = None
    """
    score: position on the scale, 0 = first description
    """

    confidence: Optional[float] = None
    probabilities: Optional[Dict[str, float]] = None
    """
    choice/score: probability of each option (score options are "0", "1", ...)
    """

    legend: Optional[Dict[str, str]] = None
    """
    score: description of each scale position
    """


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionUsage:
    input_tokens: int = 0
    output_tokens: int = 0
    cost: Optional[float] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionResponse:
    id: Optional[str] = None
    model: Optional[str] = None
    provider: Optional[str] = None
    answers: Dict[str, DecisionAnswer] = field(default_factory=dict)
    """
    Answers by question name, validated against the submitted questions
    """

    usage: Optional[DecisionUsage] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DecisionQuestion:
    type: Optional[str] = None
    """
    noul, choice or score
    """

    instructions: Optional[Object] = None
    """
    What to decide: text, or a JSON object/array of guidance
    """

    criteria: Optional[Object] = None
    """
    noul: {true,false} descriptions; choice: {option: description}; score: ordered descriptions
    """


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class CreateDecision(IPost):
    """
    Decisions API (OpenRouter)
    """

    model: Optional[str] = None
    """
    The decision model, e.g. ~typesafe/jev-latest
    """

    state: Optional[Object] = None
    """
    The content to evaluate: a plain string, or a JSON object or array of related context
    """

    questions: Dict[str, DecisionQuestion] = field(default_factory=dict)
    """
    Named noul (yes/no probability), choice (one option) or score (ordered scale) questions
    """

    session_id: Optional[str] = None
    """
    A unique identifier for grouping related requests
    """

    user: Optional[str] = None
    """
    End-user identifier sent to OpenRouter. Omitted unless you set it.
    """

    provider: Optional[Dict[str, Object]] = None
    """
    OpenRouter provider routing preferences
    """

Python CreateDecision DTOs

POST /v1/decisions HTTP/1.1 
Host: vue-spa.web-templates.io 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<CreateDecision xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ServiceStack.AI">
  <model>String</model>
  <provider xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringanyType>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value />
    </d2p1:KeyValueOfstringanyType>
  </provider>
  <questions xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringDecisionQuestionPZTEmqZr>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value>
        <criteria />
        <instructions />
        <type>String</type>
      </d2p1:Value>
    </d2p1:KeyValueOfstringDecisionQuestionPZTEmqZr>
  </questions>
  <session_id>String</session_id>
  <state />
  <user>String</user>
</CreateDecision>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<DecisionResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ServiceStack.AI">
  <answers xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringDecisionAnswerPZTEmqZr>
      <d2p1:Key>String</d2p1:Key>
      <d2p1:Value>
        <choice>String</choice>
        <confidence>0</confidence>
        <legend>
          <d2p1:KeyValueOfstringstring>
            <d2p1:Key>String</d2p1:Key>
            <d2p1:Value>String</d2p1:Value>
          </d2p1:KeyValueOfstringstring>
        </legend>
        <noul>0</noul>
        <probabilities>
          <d2p1:KeyValueOfstringdouble>
            <d2p1:Key>String</d2p1:Key>
            <d2p1:Value>0</d2p1:Value>
          </d2p1:KeyValueOfstringdouble>
        </probabilities>
        <score>0</score>
        <type>String</type>
      </d2p1:Value>
    </d2p1:KeyValueOfstringDecisionAnswerPZTEmqZr>
  </answers>
  <id>String</id>
  <model>String</model>
  <provider>String</provider>
  <usage>
    <cost>0</cost>
    <input_tokens>0</input_tokens>
    <output_tokens>0</output_tokens>
  </usage>
</DecisionResponse>