Introduction

Try it

No account is required. The playground runs a base model and stores nothing. The last card, Settle a debate, is a yes or no question with the context already filled in. Change the paragraph, the question or the outcomes, and it becomes your own decision.

Settle a debate in the playground

Choose the last card, then run it and edit the question.

Read p_yes for the yes score. On a debate that score says which way the context and the descriptions lean.

Send the same decision

After a run, Use this decision in my app is the request you just tried. The samples below are Settle a debate. Send that body to POST /v1/decide with an API key from the console.

import os
import httpx

result = httpx.post(
    "https://console.sqwish.ai/v1/decide",
    headers={
        "Authorization": f"Bearer {os.environ['D1_API_KEY']}",
        "Idempotency-Key": "pluto-planet-1",
    },
    json={
        "model": "sqwish-d1-core",
        "context": "Pluto is round, has five known moons and a thin atmosphere that freezes and thaws as it moves along its orbit. It shares that orbit with many other objects in the Kuiper belt. In 2006 the International Astronomical Union reclassified it as a dwarf planet, because it hasn't cleared its orbit of other bodies.",
        "decisions": [{
            "id": "planet",
            "kind": "binary",
            "question": "Does Pluto deserve to be called a planet?",
            "outcomes": {
                "yes": "It deserves the name: it is round, has moons and an atmosphere, and behaves like a planet.",
                "no": "It doesn't: it shares its orbit with other bodies, which a planet must clear, as the 2006 rule says.",
            },
        }],
    },
    timeout=40.0,
).raise_for_status().json()

print(result["decisions"]["planet"]["p_yes"], result["decisions"]["planet"]["action"])

const response = await fetch("https://console.sqwish.ai/v1/decide", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.D1_API_KEY}`,
    "Idempotency-Key": "pluto-planet-1",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "sqwish-d1-core",
    context: "Pluto is round, has five known moons and a thin atmosphere that freezes and thaws as it moves along its orbit. It shares that orbit with many other objects in the Kuiper belt. In 2006 the International Astronomical Union reclassified it as a dwarf planet, because it hasn't cleared its orbit of other bodies.",
    decisions: [{
      id: "planet",
      kind: "binary",
      question: "Does Pluto deserve to be called a planet?",
      outcomes: {
        yes: "It deserves the name: it is round, has moons and an atmosphere, and behaves like a planet.",
        no: "It doesn't: it shares its orbit with other bodies, which a planet must clear, as the 2006 rule says.",
      },
    }],
  }),
  signal: AbortSignal.timeout(40_000),
});
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const result = await response.json();
console.log(result.decisions.planet.p_yes, result.decisions.planet.action);

curl --fail-with-body https://console.sqwish.ai/v1/decide \
  -H "Authorization: Bearer $D1_API_KEY" \
  -H "Idempotency-Key: pluto-planet-1" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "sqwish-d1-core",
  "context": "Pluto is round, has five known moons and a thin atmosphere that freezes and thaws as it moves along its orbit. It shares that orbit with many other objects in the Kuiper belt. In 2006 the International Astronomical Union reclassified it as a dwarf planet, because it hasn't cleared its orbit of other bodies.",
  "decisions": [{
    "id": "planet",
    "kind": "binary",
    "question": "Does Pluto deserve to be called a planet?",
    "outcomes": {
      "yes": "It deserves the name: it is round, has moons and an atmosphere, and behaves like a planet.",
      "no": "It doesn't: it shares its orbit with other bodies, which a planet must clear, as the 2006 rule says."
    }
  }]
}
JSON

Reuse pluto-planet-1 only for this operation. A lost reply with the same key and the same body returns the original answer for 24 hours. The quickstart sends the playground’s support-routing ticket from your server, measures it on tickets you have reviewed, and improves a version. Production changes only when you promote. The other cards are decisions with the context, the question and the outcomes already written. Each example is one of those cards.

Three decision types

Kind	Use it to	Read from the result
Binary	Answer a yes/no question	`p_yes`, `probabilities`, `action`
Single	Choose one of your named outcomes	`probabilities`, `top`, `action`
Ordinal	Rate against ordered levels	`expected_level`, `median_level`, `probabilities`

Mix types in one request. Results are keyed by your decision ids. Add an abstention policy when uncertain cases should go to review.

Probabilities describe the alternatives you declared. They are not a guarantee that an answer is correct. Test your wording and action thresholds on representative cases before using them to automate work.

Get started

Using D1

Improve your decisions

Try it

Settle a debate in the playground

Send the same decision

Three decision types

​Try it

Settle a debate in the playground

​Send the same decision

​Three decision types

Try it

Send the same decision

Three decision types