Unabhängiger LeitfadenEin unabhängiger Leitfaden zu Jev, dem Modell von TypeSafe AI
Der Jev-Praxisleitfaden

Vom Zugang zur ersten Anfrage

Die ersten Schritte mit Jev

Testen Sie eine eigene Jev-Frage ohne eigenen API-Schlüssel. Für die Integration folgen Sie danach den offiziellen Zugangs- und API-Schritten von TypeSafe.

Unabhängiger LeitfadenZuletzt geprüft Aktualisiert

Das Wichtigste

Testen Sie hier eine eigene Frage ohne eigenen API-Schlüssel. Für die Einbindung in eine Anwendung benötigen Sie TypeSafe-Konto- und API-Zugang über die offizielle Konsole.

01

Ohne Code beginnen

Teste eine Ja/Nein-Frage oder 2–6 eigene Optionen in dieser kostenlosen, unabhängigen Demo. Ein eigener API-Schlüssel ist nicht nötig; Live-Prüfungen hängen von der Verfügbarkeit ab.

Ausprobieren
02

Für Entwickler

Testen Sie hier eine eigene Frage ohne eigenen API-Schlüssel. Für die Einbindung in eine Anwendung benötigen Sie TypeSafe-Konto- und API-Zugang über die offizielle Konsole.

Technische Details ansehen

Praktische Anleitungen

Formulieren Sie klarere Fragen und verstehen Sie das Ergebnis.

Ohne Code beginnen

Sie können eigenen Text und eine Frage in der kostenlosen, unabhängigen Demo dieser Website testen, ohne einen API-Schlüssel anzugeben. Definieren Sie eine Ja/Nein-Regel oder 2–6 Optionen. Um Jev in Ihre Anwendung einzubinden, folgen Sie dem unten separat beschriebenen offiziellen Zugangsweg für TypeSafe-Konto und API.

Die Demo erlaubt insgesamt bis zu 10.000 Zeichen für Text, Frage, Regeln und Optionen, gezählt als Unicode-Codepunkte. Das ist das Kontingent dieser Website, nicht Jevs Kontextfenster. Live-Prüfungen können eine Bestätigung erfordern, dass Sie ein Mensch sind, und bei Nutzungs- oder Budgetlimits pausieren. Das Laden einer Vorlage führt sie nicht aus und liefert kein Modellergebnis.

Eigenen Editor öffnen · Feedback-Vorlage laden

1. Den passenden Zugang finden

Stand 17. September 2026 bietet die öffentliche Website von TypeSafe eine Warteliste an. Der offizielle Schnellstart enthält Anleitungen für den Playground und die API. Dass eine Dokumentationsseite öffentlich zugänglich ist, bedeutet nicht, dass jedes Konto Zugang zum Modell hat.

  • Wenn Sie noch keinen Zugang haben: Nutzen Sie die Warteliste auf der offiziellen Website von TypeSafe. Diese Website kann keine Konten freischalten oder API-Schlüssel ausstellen.
  • Wenn Ihr Konto bereits Zugang hat: Öffnen Sie die TypeSafe-Konsole und folgen Sie dort dem Ablauf für den Playground oder die Erstellung eines API-Schlüssels.

Die Verfügbarkeit von Konten und der Einrichtungsprozess können sich ändern. Ihren eigenen Status prüfen Sie in der offiziellen Konsole.

2. Eine eng umrissene Frage ausprobieren

Verwenden Sie im Playground eine kurze fiktive Nachricht als Eingabe und stellen Sie eine Noul-Frage. Nehmen Sie zum Beispiel eine Nachricht mit einer Rückrufbitte und fragen Sie, ob ausdrücklich um einen Rückruf gebeten wird. Ändern Sie die Eingabe anschließend in eine vage Bitte um Hilfe und beobachten Sie, ob sich das Ergebnis ändert.

Dies ist eine Übung zum Erkunden, kein Genauigkeitstest. Zwei gegensätzliche Beispiele helfen anfangs dabei zu erkennen, ob Ihre Frage den beabsichtigten Unterschied beschreibt.

Jev nennt die bereitgestellten Informationen state. Dabei kann es sich um eine Zeichenfolge, ein JSON-Objekt oder ein Array handeln. Bei umfangreicheren Aufgaben helfen benannte Felder, Nachricht, ergänzende Datensätze und relevante Richtlinien auseinanderzuhalten. Eingabeformate

Für Entwickler

3. Eine erste API-Anfrage senden

Der dokumentierte Endpunkt lautet POST https://api.typesafe.ai/v1/systemone. Er akzeptiert einen Modellnamen, den State und benannte Fragen. Die Authentifizierung erfolgt über ein Bearer-Token. API-Referenz

Hinterlegen Sie TYPESAFE_API_KEY sicher in Ihrer lokalen Umgebung und führen Sie anschließend dieses von uns erstellte Beispiel in einem Terminal aus:

Technische Details ansehen
curl --fail-with-body --silent --show-error \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "jev-latest",
  "state": "Please call me tomorrow morning to discuss the setup.",
  "questions": {
    "callback_requested": {
      "type": "noul",
      "instructions": "Does the sender explicitly ask for a phone call?"
    }
  }
}
JSON

Lesen Sie bei einer erfolgreichen Antwort answers.callback_requested.noul und usage.input_tokens aus. Antwortfelder

Noul drückt die geschätzte Wahrscheinlichkeit für „Ja“ aus. Noul interpretieren

Bewahren Sie Schlüssel in Ihrer Terminal- oder Serverumgebung auf. Betten Sie sie weder in Browser-JavaScript noch in ein öffentliches Repository, einen Screenshot oder ein geteiltes Beispiel ein. Dieser Leitfaden fordert Sie niemals auf, einen Schlüssel auf der Website einzufügen.

4. Nur so viel Struktur ergänzen, wie die Aufgabe benötigt

Verwenden Sie Choice, wenn der nächste Schritt von einer Kategorie abhängt, Score für sinnvoll geordnete Bewertungsstufen und Noul für eine Ja-Nein-Wahrscheinlichkeit. Bündeln Sie unabhängige Fragen zum selben State und verarbeiten Sie ihre Ergebnisse in Ihrer Anwendung.

Als konkreten nächsten Schritt können Sie dem Supportticket-Beispiel folgen. Es zeigt, wie aus einer dokumentierten Ausgabe ein Vorschlag zur Weiterleitung wird.

5. Zugangs- und Anfrageprobleme getrennt untersuchen

Wenn die Anmeldung an der Konsole nicht abgeschlossen wird, öffnen Sie die offizielle Konsole erneut über ihren regulären Einstieg und prüfen Sie, ob Sie das Konto mit Zugang verwenden. Ändern Sie nicht immer wieder Ihre API-Anfrage, um ein Anmeldeproblem im Browser zu lösen. Auch eine erfolgreiche Anmeldung belegt noch nicht, dass ein API-Schlüssel ausgestellt wurde. Nutzen Sie bei Kontoproblemen den offiziellen Supportweg von TypeSafe; veröffentlichen Sie niemals einen Schlüssel oder Anmeldelink in einem öffentlichen Bericht.

Prüfen Sie bei einer HTTP-Anfrage zuerst den Status und den Fehlerinhalt, bevor Sie die Frage ändern:

Symptom Nächster Prüfschritt
Antwort 401 Schlüssel und Bearer-Authentifizierungsheader prüfen
Antwort 422 Zurückgegebene Validierungsdetails lesen und die Anfragefelder prüfen
Antwort 429 Anfrageaufkommen reduzieren und mit zunehmenden Wartezeiten erneut versuchen
Antwort 529 Als vorübergehende Überlastung behandeln und mit zunehmenden Wartezeiten erneut versuchen

Diese Codes sind in der API-Referenz dokumentiert. Verwenden Sie bei 429 oder 529 exponentiell zunehmende Wartezeiten. Die SDKs wiederholen Anfragen bereits standardmäßig; berücksichtigen Sie diese Versuche, bevor Sie eine zusätzliche äußere Wiederholungsschleife ergänzen.

Eine Zeitüberschreitung ist etwas anderes als eine negative Antwort. Legen Sie eine Gesamtfrist und eine begrenzte Zahl von Versuchen fest und leiten Sie ungelöste Fälle zur Prüfung weiter. Stellen Sie sicher, dass die Wiederholung einer Modellanfrage keine nachgelagerte Aktion, etwa das Erstellen einer Zuweisung, doppelt auslösen kann.

6. Eine überraschende Antwort untersuchen

Beobachtung Sinnvoller Untersuchungsschritt
Eine gültige Antwort auf die falsche Frage Die exakten Anweisungen mit der beabsichtigten Bedingung vergleichen; Ausnahmen ausdrücklich nennen
Das Ergebnis ändert sich nach einer Bearbeitung Modellversion, State, Optionsbezeichnungen, Reihenfolge und Bewertungsraster gemeinsam speichern
Ein Score liegt zwischen zwei Stufen Als gewichtete Position verstehen, nicht als ganzzahliges Label oder exakte Größe
Ein deutliches Ergebnis bei schwacher Beleglage Prüfen, was der State tatsächlich enthält; Konfidenz kann fehlende Datensätze nicht ersetzen
Zwei Antworten widersprechen sich Jede Frage unabhängig prüfen und die Regeln für Konflikte im Code festlegen

Dies sind redaktionelle Empfehlungen zur Fehlersuche. Der Score-Leitfaden erklärt Werte mit Nachkommastellen. Unsere Seite zu Grenzen verlinkt die aktuellen Einschränkungen des Anbieters und die gesondert gekennzeichneten Community-Beobachtungen.

Der Alias jev-latest kann auf ein neueres Modell umgestellt werden. Erfassen Sie beim Testen den zurückgegebenen Modellbezeichner. Wenn Reproduzierbarkeit wichtig ist, verwenden Sie einen versionierten Bezeichner, den Ihr Konto unterstützt. Modellaliase

7. Entscheiden, ob der erste Ablauf einsatzbereit ist

Bevor Sie automatische Aktionen aktivieren, stellen Sie eine kleine Sammlung erwarteter Entscheidungen zusammen, prüfen Sie Fehler und wählen Sie passende Schwellenwerte für Ihren Ablauf. Schätzen Sie mit dem Preisrechner die Kosten für Eingabetokens und entscheiden Sie anhand des Vergleichsleitfadens, welche Aufgaben bei anderen Werkzeugen bleiben sollten.

Quellen und weiterführende Informationen

Dieser Leitfaden stützt sich auf offizielle Dokumentation und verlinkte Community-Berichte. Beobachtungen aus der Community werden ihren Verfassern zugeordnet.

  1. TypeSafe-Zugang und Warteliste
  2. Offizieller Schnellstart
  3. HTTP-API-Referenz
  4. State und Eingabeformate
  5. Modelle und Aliase
So prüfen wir unsere Quellen