# RightNow decision model [RightNow AI](https://www.rightnowai.co/) / [Decision model](https://www.rightnowai.co/docs/decision-model) Updated 2026-11-13 [Get an API key](https://www.rightnowai.co/dashboard/settings/api-keys?create=1) The RightNow decision model makes structured decisions: send a state and named questions, then read probabilities, confidence and typed answers. **Illustration of named answers.** ```text [ State ] [ Questions ] | | '------.------' | v [ Decide request ] | v [ Named answers ] ``` Send state and named questions. Read the answer for each question. **TypeScript (decide.ts)** ```typescript import { SystemZeroClient } from '@rightnowai/system-zero'; const client = new SystemZeroClient({ apiKey: process.env.SYSTEM_ZERO_API_KEY, baseURL: "https://api.rightnowai.co/v1", }); const reply = await client.decide({ "model": "rightnow-decision", "state": "The blender I ordered arrived with a cracked jar.", "questions": { "damaged": { "type": "boolean", "instructions": "Did the item arrive damaged?" } } }); console.log(JSON.stringify(reply, null, 2)); const models = await client.models.list(); console.log(models); // Set SYSTEM_ZERO_API_KEY to your API key before running this example. // Run this example on your server. // SDK defaults: The default is 5 retries, also the maximum, with 150 seconds // per attempt and a 60-second total retry budget. A single wait longer than 60 // seconds raises the last error. // Use Retry-After-Ms, or Retry-After when milliseconds are absent. The wait is // never shorter than a random backoff floor: a random fraction of 0.5 seconds // doubled for each attempt, capped at 8 seconds. ``` **Python (decide.py)** ```python from system_zero import SystemZero import os with SystemZero( api_key=os.environ["SYSTEM_ZERO_API_KEY"], base_url="https://api.rightnowai.co/v1", ) as client: reply = client.decide({ "model": "rightnow-decision", "state": "The blender I ordered arrived with a cracked jar.", "questions": { "damaged": { "type": "boolean", "instructions": "Did the item arrive damaged?" } } }) print(reply) models = client.models.list() print(models) # Set SYSTEM_ZERO_API_KEY to your API key before running this example. # Run this example on your server. # SDK defaults: The default is 5 retries, also the maximum, with 150 seconds per # attempt and a 60-second total retry budget. A single wait longer than 60 # seconds raises the last error. # Use Retry-After-Ms, or Retry-After when milliseconds are absent. The wait is # never shorter than a random backoff floor: a random fraction of 0.5 seconds # doubled for each attempt, capped at 8 seconds. ``` **Manual HTTP (decide.sh)** ```shell # Set SYSTEM_ZERO_API_KEY to your API key before running this example. # Generate once per logical decision; reuse this key when retrying. idempotency_key="$(uuidgen 2>/dev/null \ || cat /proc/sys/kernel/random/uuid 2>/dev/null \ || openssl rand -hex 16 2>/dev/null \ || python3 -c 'from uuid import uuid4; print(uuid4())' 2>/dev/null)" cat > request.json <<'EOF' { "model": "rightnow-decision", "state": "The blender I ordered arrived with a cracked jar.", "questions": { "damaged": { "type": "boolean", "instructions": "Did the item arrive damaged?" } } } EOF # Headerless error responses require Python 3 to read error.code. # Manual example policy: 130 seconds per attempt, a 600-second resend window # with no retry-count cap. If x-should-retry is present, resend only when # x-should-retry is true. If the header is absent, resend on 429, or on 409 and # 5xx only with a retryable error.code. No answer also retries. Wait Retry-After # plus up to 10 %, otherwise a random wait doubling from 1 s to 30 s. Stop if # Retry-After is over 60 s. Also stop when a 429 has no Retry-After, or a 5xx # has x-should-retry but no Retry-After. # SDK defaults: The default is 5 retries, also the maximum, with 150 seconds per # attempt and a 60-second total retry budget. A single wait longer than 60 # seconds raises the last error. # Use Retry-After-Ms, or Retry-After when milliseconds are absent. The wait is # never shorter than a random backoff floor: a random fraction of 0.5 seconds # doubled for each attempt, capped at 8 seconds. random() { od -An -N4 -tu4 /dev/urandom | tr -d ' '; } # Stop resending after 10 minutes. start=$(date +%s) attempt=0 while :; do : "${SYSTEM_ZERO_API_KEY:?set it first}" : "${idempotency_key:?could not make one}" rm -f reply.json out=$(curl https://api.rightnowai.co/v1/system-zero/decide \ --max-time 130 -sS -o reply.json -D - -w '%{http_code}' \ -H "Authorization: Bearer $SYSTEM_ZERO_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $idempotency_key" \ -d @request.json) code=$(printf '%s' "$out" | tail -c 3) retry_header=$(printf '%s\n' "$out" \ | grep -i '^x-should-retry:' | tail -n 1) retry=$(printf '%s\n' "$retry_header" \ | sed 's/^[^:]*:[[:space:]]*//;s/[[:space:]]*$//') after=$(printf '%s\n' "$out" | grep -i '^retry-after:' \ | tail -n 1 | sed 's/^[^:]*:[[:space:]]*//;s/[[:space:]]*$//') case $after in *[!0-9]*|'') after= ;; esac if [ -z "$retry_header" ]; then case $code in 000|429) ;; 409|5??) error_code=$(python3 -c 'import json, sys try: print(json.load(sys.stdin).get("error", {}).get("code", "")) except (ValueError, AttributeError): pass' < reply.json 2>/dev/null) || break case $code:$error_code in 409:idempotency_conflict) ;; 5??:service_unavailable) ;; 5??:system_zero_unavailable) ;; 5??:billing_settlement_error) ;; 5??:idempotency_unavailable) ;; 5??:limiter_unavailable) ;; 5??:internal_error) ;; 5??:maintenance) ;; *) break ;; esac ;; *) break ;; esac else [ "$retry" = true ] || break case $code in 4??|5??) ;; *) break ;; esac fi if [ -n "$after" ]; then after=$(printf '%s' "$after" | sed 's/^0*//') after=${after:-0} [ "$after" -le 60 ] || break ms=$(( after * 1000 + $(random) % (after * 100 + 1) )) else [ "$code" != 429 ] || break if [ -n "$retry_header" ]; then case $code in 5??) break ;; esac fi cap=$(( attempt < 5 ? 1000 << attempt : 30000 )) ms=$(( $(random) % (cap + 1) )) fi [ $(( $(date +%s) - start + ms / 1000 )) -lt 600 ] || break sleep "$(( ms / 1000 )).$(printf '%03d' $(( ms % 1000 )))" [ $(( $(date +%s) - start )) -lt 600 ] || break attempt=$(( attempt + 1 )) done echo "HTTP $code" cat reply.json 2>/dev/null ``` An `Idempotency-Key` allows a stored answer to be replayed when available. Read the [data handling and training terms](https://www.rightnowai.co/privacy-policy#api). ## At a glance - **Endpoint**: `POST https://api.rightnowai.co/v1/system-zero/decide` - **Key**: `Authorization: Bearer $SYSTEM_ZERO_API_KEY` - **Model**: `rightnow-decision` - **State**: Text, a JSON object or a JSON array. - **Questions**: `boolean`, `choice` and `score`. - **Model discovery**: Use a key with `GET /v1/models` to read attested models and their limits. Inline input: text, JSON state (robot state), images, voice, PDF, video (preview). Only listed formats are supported. See [Inputs](https://www.rightnowai.co/docs/decision-model/attachments) for input formats and availability. ## Start here ### [Quickstart](https://www.rightnowai.co/docs/decision-model/quickstart) Install an SDK, send a request and read the answer. ### [API reference](https://www.rightnowai.co/docs/decision-model/decide) Send state and named questions; read answers, headers, errors and the event stream reply. ### [Errors](https://www.rightnowai.co/docs/decision-model/errors) Read refusal codes and retry flags. Keep the request ID for support. ### [Coding agent setup](https://www.rightnowai.co/docs/decision-model/agent-setup) Give your coding agent the integration skill and a key from the server environment. ## For AI coding agents Read the docs index or add the integration skill. - [Docs index](https://www.rightnowai.co/docs/decision-model/llms.txt) - [SKILL.md](https://www.rightnowai.co/docs/decision-model/SKILL.md) ## Next [Quickstart](https://www.rightnowai.co/docs/decision-model/quickstart)