Mit Jev entwickeln

SCHNELLSTART

Eine Entscheidung in der Spielwiese prüfen

Die Spielwiese ist der schnellste Weg, Jevs Eingaben und Ausgaben kennenzulernen. Sobald die Frage passt, erstelle einen API-Schlüssel und verbinde sie mit deinem Produkt.

1. 1

   Spielwiese öffnen

   Melde dich an, öffne die Jev-KI-Spielwiese und gib einen realen Geschäftskontext ein.

2. 2

   Kontext vorbereiten

   Nutze Text, ein JSON-Objekt oder ein Textarray, um den benötigten Entscheidungskontext bereitzustellen.

3. 3

   Fragen hinzufügen

   Wähle Choice, Score oder Noul. Du kannst alle drei Typen in einer Anfrage kombinieren.

4. 4

   Code verbinden

   Erstelle einen API-Schlüssel in deinem Arbeitsbereich und rufe den Produktiv-Endpunkt per SDK oder REST auf.

EINGABE

Gib dem Kontext die nötigen Informationen für die Entscheidung

Der Kontext ist der Inhalt, den jede Frage auswertet. Nutze für einfache Fälle eine Zeichenfolge und ein JSON-Objekt, wenn Ticket, Bestellung und Richtlinie gemeinsam berücksichtigt werden müssen.

Aktuelle Eingabegrenze: Jev akzeptiert Text, JSON-Objekte und Textarrays. Bilder, Audio und Video werden noch nicht unterstützt.

FRAGETYPEN

Entscheidungen aus präzisen Fragen zusammensetzen

Jede Frage sollte eine konkrete, klar eingegrenzte Sache abfragen. Mehrere Fragen werden parallel anhand desselben Kontexts ausgewertet – einzelne Aufrufe müssen dafür nicht verkettet werden.

{
  "type": "noul",
  "instructions": "Does this message convey urgency?",
  "criteria": {
    "true": "Explicitly needs immediate attention",
    "false": "No urgency expressed"
  }
}

"instructions": {
  "potential_duplicate": {
    "name": "John Smith",
    "location": "Oakland, California",
    "last_employer": "Google"
  },
  "question": "Is the resume for the same person as `potential_duplicate`?"
}

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": {
        "billing": "Payments, invoicing, refunds",
        "technical": "Bugs, outages, integrations",
        "sales": "Pricing, upgrades, new accounts"
      }
    }
  }
}

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "frustration": {
      "type": "score",
      "instructions": "How frustrated is the customer?",
      "criteria": [
        "Calm",
        "Frustrated",
        "Very angry"
      ]
    }
  }
}

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "Does this convey urgency?",
      "criteria": {
        "true": "Explicitly time-sensitive",
        "false": "No urgency expressed"
      }
    }
  }
}

AUSGABE

Was die Antwort deinem Code liefert

Antworten, Nutzung und elapsedMs stehen in data.result. data.creditsUsed enthält die für eine API-Schlüssel-Anfrage berechneten Credits. Die Antworten verwenden dieselben Frage-IDs wie die Anfrage.

• answers: Choice liefert die ausgewählte Option, Wahrscheinlichkeiten und Konfidenz; Score liefert Score, Legende, Wahrscheinlichkeiten pro Stufe und Konfidenz; Noul liefert den Noul-Wert.
• usage: Enthält input_tokens und output_tokens.
• elapsedMs: Zeit von der Anfrage bis zum Ergebnis, einschließlich Validierung – nicht nur die reine Modellinferenz.

Wahrscheinlichkeit und Konfidenz sind Signale für Automatisierung, keine Garantie für geschäftliche Genauigkeit. Nutze bei risikoreichen Aktionen höhere Schwellen oder eine menschliche Prüfung.

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "is_urgent": {
          "type": "noul",
          "noul": 0.95
        }
      },
      "usage": {
        "input_tokens": 296,
        "output_tokens": 20
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "department": {
          "type": "choice",
          "choice": "billing",
          "probabilities": {
            "billing": 0.88,
            "technical": 0.12,
            "sales": 0
          },
          "confidence": 0.81
        }
      },
      "usage": {
        "input_tokens": 318,
        "output_tokens": 34
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "frustration": {
          "type": "score",
          "score": 1.05,
          "legend": {
            "0": "Calm",
            "1": "Frustrated",
            "2": "Very angry"
          },
          "probabilities": {
            "0": 0,
            "1": 0.95,
            "2": 0.05
          },
          "confidence": 0.92
        }
      },
      "usage": {
        "input_tokens": 304,
        "output_tokens": 18
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "is_urgent": {
          "type": "noul",
          "noul": 0.95
        }
      },
      "usage": {
        "input_tokens": 307,
        "output_tokens": 20
      },
      "elapsedMs": 200
    },
    "creditsUsed": 1
  }
}

API-REFERENZ

Kontext auswerten und strukturierte Antworten zurückgeben

Vollständige HTTP-API-Referenz: Werte einen Kontext anhand typisierter Fragen aus und erhalte für jede Frage eine strukturierte Antwort.

Authorization: Bearer <API_KEY>
Content-Type: application/json

curl -X POST https://thejevai.com/v1/systemone \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-1.14",
    "state": "Help! My payouts have been failing for 3 days.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this convey urgency?"
      }
    }
  }'

{
  "state": "Help! My payouts have been failing for 3 days.",
  "model": "typesafe/jev-1.14",
  "questions": {
    "is_urgent": {
      "type": "noul",
      "instructions": "Does this convey urgency?"
    }
  }
}

Speichere deinen API-Schlüssel in einer serverseitigen Umgebungsvariablen. Füge ihn niemals in Browser-Code ein und committe ihn nicht in dein Repository. Diese Seite enthält Anfragefelder, Fragetypen, Antwortstruktur, Fehlercodes und Wiederholungsverhalten.

Verfügbare Modelle

Jedes Entscheidungsmodell über eine Schnittstelle aufrufen

Spielwiese und API unterstützen 23 OpenRouter-Entscheidungsmodell-IDs, einschließlich fester Versionen und latest-Aliase. Die Anfrageform bleibt gleich; nur das Modellfeld ändert sich.

latest-Aliase benötigen das führende ~ und folgen automatisch der neuesten Version des Anbieters. Verwende eine Modell-ID mit Versionsnummer, wenn du eine feste Version brauchst. Bestehende Anfragen mit typesafe/jev-1.13 bleiben unterstützt.

curl -X POST https://thejevai.com/v1/systemone \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_ID>",
    "state": "Replace this with your business state.",
    "questions": {
      "decision": {
        "type": "choice",
        "instructions": "Choose the most appropriate result.",
        "criteria": {
          "option_a": "Option A",
          "option_b": "Option B"
        }
      }
    }
  }'

Diese 23 Modelle nutzen POST /v1/systemone und dieselbe Jev-Credit-Regel. Anfragen sind auf 8 Fragen und 32 KiB JSON begrenzt, auch wenn der Anbieter größere Eingaben unterstützt. Die Spielwiese bearbeitet Text oder JSON; Modalitäten und Fragetypen hängen vom Anbieter ab. :free bezeichnet die Upstream-Variante und bedeutet keine kostenlose Jev-API-Nutzung. Laya hat eine separate API-Dokumentation.

AGENT-NUTZUNG

Jev in einem Coding-Agenten verwenden

Der Jev Agent Skill zeigt Codex, Claude Code, Cursor und anderen kompatiblen Agenten, wie sie diese API für begrenzte Entscheidungen aufrufen und Ausführung sowie Berechtigungen deiner Anwendung überlassen.

npx skills add jev-ai/jev-agent-skill

export JEV_API_KEY="sk_your_key_here"
export JEV_LANGUAGE="en-US"

Nutze den Jev Agent Skill. Ordne dieses Supportticket genau einem Team zu: billing, technical, account oder sales. Gib das ausgewählte Team, die Wahrscheinlichkeiten und die Konfidenz zurück. Kontaktiere den Kunden nicht und ändere das Ticket noch nicht.

Ticket: Mir wurde mein Jahresabo doppelt berechnet und ich brauche eine Rückerstattung.

Nutze den Jev Agent Skill, bevor du diesen vorgeschlagenen Tool-Aufruf ausführst. Beurteile, ob er ohne menschliche Freigabe sicher ist. Berücksichtige Nebenwirkungen, Umkehrbarkeit, Umfang und Richtlinien. Führe ihn bei Risiken oder Unsicherheit nicht aus.

Tool: delete_customer_records
Argumente: {where: last_login < 2023-01-01}
Richtlinie: Destruktive Datenbankoperationen erfordern ein Backup und menschliche Freigabe.

Wähle mit dem Jev Agent Skill ein freigegebenes Modell für diese Aufgabe. Priorisiere die Qualität, danach Kontextkapazität und Kosten. Gib das ausgewählte Modell, die Wahrscheinlichkeiten und an, ob eskaliert werden soll. Rufe noch kein Modell auf.

Aufgabe: einen Kundenstreitfall mit 100k Tokens prüfen.
Kandidaten: fast-model (32k, geringe Kosten), reasoning-model (200k, hohe Kosten), fallback-model (128k, mittlere Kosten).

Nutze den Jev Agent Skill, um zu prüfen, ob die Belege ausreichen, um diese Aussage zu veröffentlichen. Berücksichtige die Qualität und Aktualität der Quellen, ihre direkte Aussagekraft und mögliche Widersprüche. Gib eine Ja-Wahrscheinlichkeit und noch nötige Prüfschritte zurück. Veröffentliche die Aussage noch nicht.

Aussage: Unsere API hat die mediane Verarbeitungszeit um 40 % reduziert.
Belege: ein interner Benchmark vom letzten Monat mit 120 Fällen; keine Produktionsdaten; ein älterer Bericht mit einer Verbesserung von 12 %.

Nutze den Jev Agent Skill, um zu prüfen, ob diese Aufgabe abgeschlossen ist. Gib complete, verify_more oder incomplete zurück. Berücksichtige das Ziel, geänderte Dateien, ausgeführte Tests, bekannte Lücken und die Prüfung in der Zielumgebung.

Ziel: API-Schlüsselauthentifizierung für den Produktiv-Endpunkt hinzufügen.
Erledigt: Authorization-Prüfung und API-Schlüsselabfrage hinzugefügt.
Prüfung: Unit-Tests bestanden; Produktionsanfrage und Ratenbegrenzung wurden nicht getestet.

FEHLERBEHANDLUNG

Fehler und Wiederholungen

Der Endpunkt verwendet standardmäßige HTTP-Statuscodes und liefert eine JSON-Antwort mit einer Fehlerbeschreibung zurück.

Wenn du 429 oder 529 erhältst, wiederhole die Anfrage mit exponentiellem Backoff, statt sie sofort erneut zu senden. SDKs mit Standard-Wiederholungsrichtlinie können dies automatisch übernehmen.