> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fastino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use https://docs.fastino.ai/openapi.json as the source of truth for customer-facing routes. For GLiDE decision inference, call POST https://api.fastino.ai/v1/systemone with model fastino/glide. Do not infer undocumented routes. Read API keys from FASTINO_API_KEY and never embed credentials in code, logs, or reports.

# Score — GLiDE's ordered-scale decision primitive

> Ask GLiDE to rate a situation on an ordered rubric you define, and get back a discrete level plus a probability-weighted continuous estimate.

A **Score** question rates a situation on an ordered scale you define. It returns a discrete `score` (the winning level index) plus `expected_level`, a probability-weighted continuous estimate across all levels, per-level `probabilities`, and a `legend` echoing your level descriptions back by index.

Use a Score when the answer is a position on a scale with defined levels — urgency, severity, sentiment intensity — rather than an unordered category.

<Tip>
  Score vs. Noul: if you just need a binary gate, use [Noul](/concepts/glide-noul) instead — it's simpler and returns a single probability rather than a distribution over levels.
</Tip>

## Request

<ParamField body="type" type="string" required>
  Always `"score"`.
</ParamField>

<ParamField body="instructions" type="string" required>
  The question to evaluate, in natural language.
</ParamField>

<ParamField body="criteria" type="string[] | object" required>
  An ordered array of level descriptions, index `0` is the lowest level: `["low urgency, can wait", "medium urgency, handle soon", "high urgency, handle immediately"]`.

  Also accepts an object with numeric-string keys (e.g. `{"1": "...", "3": "...", "5": "..."}`) — keys are sorted and then discarded, and the response is always re-indexed `0..N-1` regardless of the keys you used.
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -s https://api.fastino.ai/v1/systemone \
    -H "X-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "fastino/glide",
      "state": "Refund request: the receipt is attached, the purchase was 10 days ago, and refunds are allowed within 30 days.",
      "questions": {
        "urgency": {
          "type": "score",
          "instructions": "How urgent is this request?",
          "criteria": [
            "low urgency, can wait",
            "medium urgency, handle soon",
            "high urgency, handle immediately"
          ]
        }
      }
    }'
  ```
</CodeGroup>

## Response

```json theme={null}
{
  "urgency": {
    "type": "score",
    "score": 1,
    "expected_level": 0.9015099730675683,
    "confidence": 0.7587802709097535,
    "probabilities": {
      "0": 0.11323658534089268,
      "1": 0.8720168562506462,
      "2": 0.014746558408461077
    },
    "legend": {
      "0": "low urgency, can wait",
      "1": "medium urgency, handle soon",
      "2": "high urgency, handle immediately"
    }
  }
}
```

* `score` — a discrete integer index, the argmax level.
* `expected_level` — `Σ(level × probability)`, the continuous, probability-weighted position across all levels. Use it when you want finer-grained thresholds than the discrete index provides.
* `legend` isn't generated by the model — the API builds it from your own `criteria`, indexed.
* `confidence` — `top1 − top2`, same formula as Choice, from `0` (two adjacent levels tied) to `1` (one level has \~all the probability mass). See [Confidence](/concepts/decision-models#confidence) for how to act on it.

## Using the result

```python theme={null}
answer = response["answers"]["urgency"]

if answer["score"] >= 2:
    action = "page_oncall"
elif answer["expected_level"] >= 1.5:
    action = "escalate"  # closer to the next level up than a clean 1
else:
    action = "standard_queue"
```

## Related

* [Noul](/concepts/glide-noul) — a yes/no decision with a probability
* [Choice](/concepts/glide-choice) — pick one of several named options
* [Decision Models](/concepts/decision-models) — primitives overview, limits, and the full request contract
* [GLiDE](/concepts/glide) — what GLiDE is and when to use it
