Entscheidungs-API

Jev API

Ein POST sendet einen Zustand und Ihre Fragen. Die Antwort ist Noul, Choice oder Score, jeweils mit einer Wahrscheinlichkeit.

POST /api/v1/decisions

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}

Beispiele

Acht Entscheidungen zum Ausführen

Fahren Sie über eine Karte, um die Anfrage zu lesen. Kopieren oder im Playground öffnen.

Leeres Checkout zuweisen

Choice liefert das Team und die Wahrscheinlichkeit jedes Teams.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
Im Playground öffnen

Ist das eine Erstattung?

Noul liefert eine Ja-Wahrscheinlichkeit, keinen Absatz.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
Im Playground öffnen

Wie dringend ist der Auszahlungsfehler

Score setzt die Notiz auf Ihre Skala und liefert die Verteilung.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
Im Playground öffnen

Zugangsdaten in einer Nachricht

Die Noul-Wahrscheinlichkeit ist das Tor vor der menschlichen Prüfung.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
Im Playground öffnen

Eingehende Notiz qualifizieren

Choice trennt ein Kaufzeitfenster von bloßem Interesse.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
Im Playground öffnen

Anzeige mit garantierter Rendite

Noul beantwortet die Richtlinienfrage, die Sie geschrieben haben.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
Im Playground öffnen

Verlängerungsrisiko in einer Notiz

Score nutzt Ihre drei Stufen, von unwahrscheinlich bis wahrscheinlich.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
Im Playground öffnen

Welche Rechnungsausnahme

Choice kann über PO, eine unerwartete Zeile oder beides markieren.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
Im Playground öffnen

Antwort

Antworten, auf die Ihr Code verzweigen kann

Jev schreibt keinen Absatz zum Parsen. Es liefert die gefragte Entscheidung und ihre Wahrscheinlichkeit.

Jede Option behält eine Wahrscheinlichkeit

Choice nennt den Gewinner und liefert weiter die Wahrscheinlichkeit jeder Option.

Noul, Choice und Score in einem Aufruf

Ja/Nein, eine beschriftete Wahl und eine Position auf Ihrer Skala können denselben Zustand teilen.

Fragen laufen zusammen

Weitere Fragen zum selben Zustand bleiben in dieser Anfrage.

Modell pinnen, wenn der Schwellenwert zählt

Senden Sie jev-1.13, wenn Sie einen Cutoff justieren. jev-latest folgt der Version dieser API.

So geht’s

So rufen Sie die Jev API auf

  1. 01

    Schlüssel erstellen

    Melden Sie sich an und kopieren Sie einen Schlüssel. Der Playground kann einen für das Konto anlegen.

  2. 02

    Zustand und Fragen per POST

    Der Body hat model, state und eine Fragen-Map. Ihre IDs sind Labels; der Text steht in instructions.

  3. 03

    Auf die typisierte Antwort verzweigen

    Lesen Sie noul, choice oder score. Bei Choice und Score zeigt confidence, ob die Optionen nah beieinander liegen.

Anwendungen

Wo eine typisierte Entscheidung einen Prompt ersetzt

Support-Routing

Senden Sie den Tickettext und die wirklich besetzten Warteschlangen. Verzweigen Sie, oder geben Sie ab, wenn die Werte nah sind.

Trust und Moderation

Stellen Sie die konkrete Richtlinienfrage. Hohes Noul hält, niedriges lässt durch, die Mitte geht in die Prüfung.

Inbound-Qualifizierung

Trennen Sie eine Notiz mit Ablauf und Kaufzeitfenster von einer, die nur Interesse zeigt.

Rechnungsausnahmen

Benennen Sie die Ausnahmen, die die Kreditorenbuchhaltung schon nutzt.

Nach den ersten Aufrufen

Was sich ändert, wenn die Antwort typisiert ist

Wir parsen keinen Absatz mehr, um zu sehen, ob ein Ticket eine Erstattung ist. Der noul-Wert ist die Verzweigung.
Support-Leitung
Wenn zwei Teams nah beieinander lagen, sagte confidence, das Ticket an eine Person zu geben.
Trust-Ingenieur
Die Stufen sind unsere Worte, daher passt die Legende zu unserer bestehenden Rubrik.
Abrechnungsbetrieb

Fragen zu Anfrage und Antwort

Was ist der Unterschied zwischen Noul, Choice und Score?

Noul ist ein Ja/Nein mit Wahrscheinlichkeit. Choice wählt eine Ihrer Optionen und liefert jede Wahrscheinlichkeit. Score setzt den Zustand auf Ihre Skala, niedrig zuerst.

Warum haben auch die nicht gewählten Optionen eine Wahrscheinlichkeit?

Der Zweite ist das Signal zur Übergabe. Wenn zwei Optionen nah sind, behandeln Sie den Gewinner nicht als sicher.

jev-1.13 oder jev-latest senden?

Pinnen Sie jev-1.13, wenn ein Cutoff von der Form der Wahrscheinlichkeiten abhängt. Diese API akzeptiert jev-latest und löst ihn derzeit auf dasselbe Modell auf.

Was kann in state stehen?

Ein String, ein JSON-Objekt oder ein Textarray. Legen Sie die nötigen Fakten hinein, nicht die erhoffte Antwort.

Was tun bei niedrigem confidence?

Behandeln Sie den Fall als unsicher. Geben Sie ihn an eine Person oder stellen Sie eine genauere Frage. Senken Sie den Cutoff nicht, bevor Sie diese knappen Fälle gesehen haben.

Was bedeutet 422?

Der Body hat die Prüfung nicht bestanden. Die Meldung nennt das Feld: fehlende instructions, Choice mit weniger als zwei Optionen, ungeordnete Score-Stufen oder eine ID, die kein snake_case ist.

Erste Entscheidung senden

Öffnen Sie den Playground mit einem Beispiel oder folgen Sie Jev Docs und rufen Sie den Endpoint mit Ihrem Schlüssel auf.