Jev

TypeSafe Jev ist ein Entscheidungsmodell. Es generiert keinen Text, sondern beantwortet ausschließlich vorab definierte Fragen. Die Anfrage enthält den zu bewertenden Inhalt und eine Reihe von Fragen; das Modell liefert für jede Frage eine strukturierte Antwort mit Wahrscheinlichkeit, anhand derer das Programm unmittelbar Verzweigungslogik ausführen kann.

Anwendungsbereiche

Geeignet für:

• Klassifizierung und Routing: zuständiges Team für ein Ticket, Kategorie der Nutzerabsicht.
• Ja/Nein-Entscheidungen: ob personenbezogene Daten enthalten sind, ob es sich um einen Erstattungsantrag handelt, ob eine Prompt-Injection vorliegt.
• Bewertung und Sortierung: Dringlichkeit, Relevanz, Stärke der Stimmung sowie Filterung von Suchergebnissen.
• Qualitätsprüfung von LLM-Ausgaben: ob eine Antwort zum Thema passt und ob sie gegen Regeln verstößt.

Nicht geeignet für:

• Generierung von Text, Zusammenfassungen, Übersetzungen oder Code.
• Entscheidungen über Bilder (Jev unterstützt nur Text- und JSON-Eingaben; verwenden Sie für Bildentscheidungen GPT-6 Luna).
• Offene Fragen, deren Antworten sich nicht vorab als Optionen oder Stufen festlegen lassen.

Vergleich mit „Chatmodell + JSON-Ausgabe“:

Schnellstart

1. Verbindungsdaten vorbereiten: Erstellen Sie in der OfoxAI-Konsole  einen API Key und verwenden Sie die folgenden Angaben:

2. SDK installieren: Für den Aufruf mit dem offiziellen OpenAI Python SDK ist eine Version erforderlich, die client.decisions enthält:

pip install -U openai

3. Aufruf ausführen:

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
r = client.decisions.create(
    model="typesafe/jev-latest",
    input="Customer message: I was charged twice, nobody has answered my two emails, and I need a refund today.",
    questions=[{"type": "predicate", "name": "is_frustrated", "instructions": "Is the customer frustrated?"}],
)
print(r.answers[0].probability)  # 0.98

curl https://api.ofox.ai/v1/decisions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-latest",
    "input": "Customer message: I was charged twice, nobody has answered my two emails, and I need a refund today.",
    "questions": [
      { "type": "predicate", "name": "is_frustrated", "instructions": "Is the customer frustrated?" }
    ]
  }'

Beispielantwort:

{
  "model": "typesafe/jev-latest",
  "answers": [{ "type": "predicate", "name": "is_frustrated", "probability": 0.98 }],
  "usage": { "prompt_tokens": 302, "completion_tokens": 23, "total_tokens": 325 }
}

probability gibt die Wahrscheinlichkeit für die Antwort „Ja“ an; 0.98 bedeutet, dass das Modell die Unzufriedenheit des Kunden als sehr wahrscheinlich einstuft. Für den eigenen Anwendungsfall ersetzen Sie input durch den tatsächlichen Inhalt und questions durch die tatsächlichen Fragen.

Fragetypen

Der Fragetyp richtet sich nach der benötigten Form des Ergebnisses:

Beispiel: Für „Handelt es sich um einen Erstattungsantrag?“ wird predicate verwendet, für „Welches Team soll das Ticket bearbeiten?“ choice und für „Wie dringend ist der Fall?“ score. Alle drei Fragen können in derselben Anfrage gestellt werden; sämtliche Antworten werden gemeinsam zurückgegeben.

Prüfen Sie nach der Festlegung des Fragetyps Fragen und Optionen anhand von Fragendesign.

Häufige Fehler

Die vollständige Fehlerliste finden Sie unter Decisions API · Häufige Fehler.

Offizielle Dokumentation

• TypeSafe · Dokumentation 
• TypeSafe · Cookbooks 

Häufig gestellte Fragen