Skip to content

Field reference

Jev AI primitives: noul, choice, score

Jev AI has three primitives: noul returns the probability that a yes/no answer is yes, choice picks one label out of up to 255, and score picks one level on an ordered scale of 2 to 10.

Last updated

What is the noul data type?

The noul data type in Jev is the yes-or-no result of a System One question. You must send instructions, and you may send criteria for true and false. The response object has type and noul, where noul is P(yes) from 0 to 1. Choice and score are the other question types. Noul is the binary probability, not free text.

A plain-language definition is on What is Jev AI?. The company context is on TypeSafe AI. Per-request cost is on the pricing calculator.

Agent skills that call these primitives are grouped on Jev skills on GitHub.

Side-by-side

NoulChoiceScore
Requiredinstructions (+ optional criteria)instructions, criteria mapinstructions, ordered criteria
Constraintyes/no probability≤ 255 options; null detail allowed2–10 ordered levels
Returns{ type, noul } where noul is P(yes) in 0–1{ type, choice, probabilities, confidence }{ type, score, legend, probabilities, confidence }

Copy-paste examples

Noul

{
  "state": "Subject: cancel my plan",
  "model": "jev-latest",
  "questions": {
    "is_cancel": {
      "type": "noul",
      "instructions": "Is the user asking to cancel a subscription?"
    }
  }
}

Choice

{
  "state": "My webhook retries are exhausting the quota.",
  "model": "jev-latest",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Pick the best support queue.",
      "criteria": {
        "billing": "Invoices, refunds, plan changes",
        "technical": "API, webhooks, outages",
        "sales": "Upgrades and new seats"
      }
    }
  }
}

Score

{
  "state": "Production checkout is failing for 8% of EU users.",
  "model": "jev-latest",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is engineering response?",
      "criteria": [
        "low",
        "medium",
        "high",
        "sev1"
      ]
    }
  }
}

Request builder

Generated request JSON

Advanced tip: set instructions to an object or array and reference sibling fields with backticks inside the question string so data stays structured.