Anwendungsfälle

Jev-Anwendungsfälle

Acht komplette Request-Bodies, bereit zum Einfügen in den Playground oder zum Anpassen im Code. Jeder sendet einen State plus typisierte Fragen an /api/v1/decisions und bekommt ein Noul, eine Choice oder einen Score, auf dem Sie verzweigen können — ein Credit pro erfolgreichem Aufruf.

Aktualisiert

Leeres Checkout zuweisen

Nutzen Sie eine solche Choice, um jedes eingehende Ticket in eine Ihrer Warteschlangen zu senden. Die Antwort nennt das Team und trägt eine Wahrscheinlichkeit pro Option — ein knapper Fall kann an einen Menschen statt an die falsche Queue gehen.

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."
      }
    }
  }
}
Diesen Request im Playground öffnen

Ist das eine Erstattung?

Ein Noul ist die richtige Form, wenn die Frage binär ist — verlangt diese Nachricht Geld zurück? Steuern Sie ein Refund-Makro oder eine Review-Queue über den noul-Wert statt generierten Text zu parsen.

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?"
    }
  }
}
Diesen Request im Playground öffnen

Wie dringend ist der Auszahlungsfehler

Score passt zu geordnetem Urteil. Definieren Sie eigene Stufen — hier eine dreistufige Dringlichkeit — und nutzen Sie den gebrochenen Score, um ein Backlog zu sortieren, statt Labels von Hand zu lesen.

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"
      ]
    }
  }
}
Diesen Request im Playground öffnen

Zugangsdaten in einer Nachricht

Setzen Sie ein Noul als Vorfilter vor die menschliche Review-Queue. Nachrichten, die nach Zugangsdaten fragen, werden per Wahrscheinlichkeit markiert; die Zweitwahrscheinlichkeit sagt, wie sehr man dem Gate trauen kann.

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?"
    }
  }
}
Diesen Request im Playground öffnen

Eingehende Notiz qualifizieren

Choice trennt Kaufabsicht in die Buckets, die Ihr Vertriebsprozess schon hat — ready, nurture, ignore — damit Routing-Regeln erklärbar bleiben und jede Option ihre Wahrscheinlichkeit behält.

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."
      }
    }
  }
}
Diesen Request im Playground öffnen

Anzeige mit garantierter Rendite

Noul eignet sich für Policy-Checks, bei denen die Regel in klarer Sprache steht. Das Listing verspricht eine garantierte Rendite oder nicht — die Wahrscheinlichkeit ist Ihr Durchsetzungssignal.

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?"
    }
  }
}
Diesen Request im Playground öffnen

Verlängerungsrisiko in einer Notiz

Bewerten Sie Verlängerungsrisiko auf Ihrer eigenen Skala statt mit der Sentiment-Zahl eines Anbieters. Weil die Stufen Ihre sind, bildet der gebrochene Score direkt den Playbook-Schritt ab, den Sie schon fahren.

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"
      ]
    }
  }
}
Diesen Request im Playground öffnen

Welche Rechnungsausnahme

Eine Choice mit 'both'-Option fängt zusammengesetzte Ausnahmen ohne zweiten Aufruf. Die Kreditorenbuchhaltung bekommt den Ausnahmetyp plus Wahrscheinlichkeiten pro Option, um den Fall zu routen.

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."
      }
    }
  }
}
Diesen Request im Playground öffnen

Kombinierbare Patterns

Die Beispiele oben sind Einzelaufrufe. TypeSafes Doku beschreibt einige Patterns, sie zu kombinieren:

  • Confidence-gesteuertes Routing — nur automatisch handeln, wenn die Konfidenz Ihre Schwelle übersteigt, den Rest an einen Menschen geben.
  • Spekulativer Fan-out — dieselbe Frage mit umgeordneten Choice-Optionen oder verschlanktem State stellen und die Antworten auf Konsistenz vergleichen.
  • Guardrails — ein Noul auf Nutzereingaben ausführen, bevor sie ein generatives Modell oder eine Produktionsaktion erreichen.
  • RAG-Passagenfilterung — pro Kandidaten-Passage ein Noul oder Score laufen lassen, um vor der Generierung nur relevanten Kontext zu behalten.

FAQ

Was kostet die Ausführung jedes Beispiels?

Jeder Request ist ein Aufruf von /api/v1/decisions, also verbraucht ein erfolgreicher Lauf 1 Credit — egal wie viele Fragen er trägt. Validierungsfehler und Upstream-Fehler sind kostenlos.

Kann ich mehrere davon auf einmal fragen?

Ja — questions ist eine Map, also können eine Routing-Choice, ein Refund-Noul und ein Urgency-Score einen State in einem Aufruf teilen und kosten trotzdem nur 1 Credit.

Wie führe ich das aus Code statt aus dem Playground aus?

POSTen Sie denselben JSON-Body an https://jev-api.org/api/v1/decisions mit einem Bearer-Schlüssel, oder nutzen Sie das TypeSafe SDK mit https://jev-api.org über /v1/systemone.

Was bedeutet confidence in den Antworten?

Choice- und Score-Antworten tragen ein confidence, das aus der Wahrscheinlichkeitsverteilung abgeleitet wird — niedriges confidence oder zwei nahe Optionen bedeuten eine knappe Entscheidung, ein Kandidat für menschliche Prüfung.

Jetzt einen ausführen

Jeder Request oben öffnet sich vorausgefüllt im Playground. Fügen Sie ein kleines Einmal-Credit-Paket auf der Preisseite hinzu, melden Sie sich an und führen Sie ihn aus — fehlgeschlagene Aufrufe verbrauchen keine Credits.