Decision primitives

A Krun question has a type, its decision primitive. Krun One answers three:

Primitive	Use when	Returns
`choice`	You need to pick one of several alternatives	The selected option + a probability per option
`noul`	You need to evaluate a yes/no proposition	A probability from 0 to 1 that the proposition holds
`score`	You need to rate something on ordered levels	An expected level + a probability per level

{
  "context": "Customer says this is the third time exports failed and wants a human immediately.",
  "questions": {
    "department": {"type": "choice", "options": {"billing": "", "support": "", "sales": ""}},
    "needs_human": {"type": "noul", "instructions": "Is the customer asking for human assistance?"},
    "severity": {
      "type": "score",
      "instructions": "How severe is the reported issue?",
      "levels": ["Minor issue", "Feature degraded", "Blocking issue"]
    }
  }
}

{
  "model": "krun-one-v0.3",
  "answers": {
    "department": {"type": "choice", "choice": "support", "confidence": 0.91,
      "probabilities": {"billing": 0.03, "support": 0.94, "sales": 0.03},
      "abstain": false, "abstention_status": "calibrated"},
    "needs_human": {"type": "noul", "noul": 0.94},
    "severity": {"type": "score", "score": 1.62, "confidence": 0.72,
      "legend": {"0": "Minor issue", "1": "Feature degraded", "2": "Blocking issue"},
      "probabilities": {"0": 0.02, "1": 0.34, "2": 0.64}}
  },
  "usage": {"input_tokens": 131}
}

Each answer has the same type as its question, so your code can branch on it.

Choosing a primitive

Several alternatives, no order between them (departments, intents, tools): choice.
A single yes/no proposition (needs a human? likely fraud? should retrieve? should retry?): noul. It returns one probability, which is easier to threshold than a two-option choice.
A quantity on a scale (severity, urgency, quality, risk, sentiment intensity): score. The levels are ordered, so “off by one level” and “off by four levels” are different mistakes, and the answer is an expected level you can compare, average or threshold.

If the options have a natural order, use score, not choice. If there are only two outcomes and one is the “positive” case, use noul.

Mixing primitives

A request can mix the three types, up to 16 questions. They are answered together, in one model job, and each question is scored independently: adding a score question does not change the answer to a choice question. See Multiple decision primitives.

Billing and usage

One question is one decision, whatever its type. usage.input_tokens is the real token count of each question’s sequence, summed. See Usage and tokens.

Overview

Concepts

Guides

SDKs

API Reference

Resources

Decision primitives

Choosing a primitive

Mixing primitives

Billing and usage

​Choosing a primitive

​Mixing primitives

​Billing and usage

Choosing a primitive

Mixing primitives

Billing and usage