Choice — eine Option auswählen in Jev

Ein Choice ist einer der drei Fragetypen im Jev-Modell von TypeSafe. Er wählt genau eine Option aus einer Menge, die Sie definieren, und gibt die Gewinnerin, eine Wahrscheinlichkeit für jede Option und einen Konfidenzwert zurück.

Ein Choice übergibt dem Modell eine benannte Menge von Optionen und bekommt genau eine davon zurück. Die Optionsnamen gehören Ihnen, also ist die Antwort schon ein Wert, auf den Ihr Code verzweigen kann — keine Zeichenkette zu normalisieren und keine Möglichkeit eines Namens, den Sie nie definiert haben.

Interessant ist nicht die Gewinnerin, sondern die Verteilung, die mitkommt. Jede Option bekommt eine Wahrscheinlichkeit, sie summieren sich zu eins, und die zweitplatzierte verrät Ihnen, was das Modell beinahe gewählt hätte.

Eine echte Antwort

An jev-1.13.0 gesendet. Die Zahlen unten sind das, was zurückkam.

Der State

Unser SSO-Login wirft seit dem 4.2-Release heute Morgen einen 500er. Niemand im Team kommt rein. Gleiches Bild in Chrome und Safari, in zwei verschiedenen Mandanten.

Die Frage

Welches Team sollte dieses Ticket übernehmen?

83 %
hoch
Technik bei 87 %, von 4 Optionen
87 % Technik

Technik gewinnt mit 87 %, aber Konto hält 13 % — und das ist genau die richtige Uneinigkeit, denn ein SSO-Ausfall liegt tatsächlich auf der Grenze zwischen beiden. Ein nacktes Label hätte das verborgen. Wenn ein falsches Routing Kosten verursacht, sind 13 % die Zahl, auf die Sie einen Schwellwert legen.

Anfrage und Antwort, wörtlich
Anfrage
{
  "state": "Our SSO login has been throwing a 500 since the 4.2 release this morning. Nobody on the team can get in. Same on Chrome and Safari, two different tenants.",
  "model": "jev-latest",
  "questions": {
    "queue": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "Billing": "Payments, invoices, refunds, plan changes",
        "Technical": "Bugs, outages, API errors, integrations",
        "Account": "Login, permissions, seats, data export",
        "Sales": "Pricing, upgrades, contracts"
      }
    }
  }
}
Antwort
{
  "model": "jev-1.13.0",
  "answers": {
    "queue": {
      "type": "choice",
      "choice": "Technical",
      "confidence": 0.83,
      "probabilities": {
        "Technical": 0.87,
        "Sales": 0,
        "Account": 0.13,
        "Billing": 0
      }
    }
  }
}

Was die Antwort enthält

type "choice"
Entspricht dem Fragetyp.
choice string
Die Option mit der höchsten Wahrscheinlichkeit.
probabilities map<string, number>
Jede definierte Option mit ihrer Wahrscheinlichkeit. Sie summieren sich zu 1.
confidence number
0 bis 1, berechnet daraus, wie breit die Wahrscheinlichkeiten gestreut sind. Eine klare Spitze bedeutet hohe Konfidenz; eine flache Streuung niedrige.

Regeln und Grenzen

  • criteria ordnet jeder Option eine Beschreibung zu — oder null, wenn der Name für sich spricht.
  • Ein Choice nimmt bis zu 255 Optionen. Geben Sie dem Modell die ganze Liste an Teams oder Kategorien statt einer Vorauswahl — jede Option kostet nur wenige Tokens.
  • Fügen Sie eine Option Other oder None of the above hinzu, wenn Ihre Liste nicht jede Eingabe abdecken könnte, damit das Modell sagen kann, dass nichts passt.

Greifen Sie zu einem Choice, wenn

  • Die Antworten sind eine geschlossene Menge, die Sie schon im Code haben — Warteschlangen, Kategorien, Status, nächste Aktionen.
  • Sie wollen den Zweitplatzierten sehen, nicht nur die Gewinnerin.
  • Sie routen, und die Kosten der Ziele unterscheiden sich so stark, dass Sie pro Option einen Schwellwert wollen.

Nehmen Sie etwas anderes, wenn

  • Die Optionen sind geordnete Sprossen einer Skala — niedrig, mittel, hoch. Ein Score weiß, dass sie geordnet sind, und kann dazwischen landen; ein Choice behandelt sie als unverbundene Labels.
  • Mehr als eine Option kann gleichzeitig zutreffen. Stellen Sie dann pro Option ein Noul.

Die anderen beiden

Stellen Sie Ihrem eigenen Text ein Choice

Der Spielplatz schickt alles, was Sie einfügen, an Jev und zeichnet jede Antwort. Kein Konto, kein Schlüssel.

Spielplatz öffnen