Projektintegration
Es stehen zwei Integrationswege zur Verfügung: Ein Coding-Assistent bindet Jev entsprechend den Anforderungen in das Projekt ein, oder in Projekten mit vorhandenem TypeSafe-Code werden lediglich zwei Umgebungsvariablen geändert.
Einbindung per Coding-Assistent
Bei Verwendung eines Coding-Assistenten wie Claude Code, Cursor oder Codex kopieren Sie den folgenden Prompt und ersetzen die Angaben in [ ] durch die tatsächlichen Anforderungen; der Coding-Assistent führt die Einbindung im Projekt durch.
Jev in mein Projekt einbinden
Ersetzen Sie nach dem Kopieren die Angaben in [ ] in Schritt 2 durch die tatsächlichen Entscheidungsanforderungen.
Ich möchte das Entscheidungsmodell Jev von OfoxAI in das aktuelle Projekt einbinden. Ich habe bereits einen API Key in der OfoxAI-Konsole erstellt. Bitte führen Sie mich Schritt für Schritt durch den Vorgang und sagen Sie mir bei jedem Schritt zuerst, was Sie tun und was als Nächstes folgt. [Schritt 1: den Key sicher speichern] 1. Erstellen Sie im Projekt eine Datei .env mit einer Zeile OFOX_API_KEY= und lassen Sie den Wert nach dem Gleichheitszeichen leer; fügen Sie .env zu .gitignore hinzu. 2. Sagen Sie mir, wo die Datei liegt, damit ich den Key selbst einfügen und speichern kann. Bitten Sie mich nicht, den Key im Chat zu senden, und schreiben Sie den Key weder in Code noch geben Sie ihn aus. 3. Warten Sie, bis ich „fertig“ schreibe, bevor Sie fortfahren. [Schritt 2: meine Entscheidung] - Zu bewertender Inhalt: [z. B.: der Text von Support-Tickets, die Nutzer einreichen] - Zu beantwortende Fragen: [z. B.: an welches Team das Ticket geht (Abbuchungen und Erstattungen / technische Störungen / Vertriebsanfragen); ob es dringend ist] - Was mit dem Ergebnis geschehen soll: [z. B.: bei ausreichend hoher Konfidenz automatisch zuweisen, sonst an einen Menschen weiterleiten] [Schritt 3: den Code schreiben] 4. Verwenden Sie das offizielle OpenAI SDK (führen Sie zuerst pip install -U openai aus; ältere Versionen haben kein client.decisions) mit base_url https://api.ofox.ai/v1, lesen Sie den Key aus OFOX_API_KEY in .env, rufen Sie client.decisions.create() auf und verwenden Sie das Modell typesafe/jev-latest. 5. Wählen Sie den Fragetyp nach meinen Anforderungen: predicate für Ja oder Nein; choice für eine Option aus mehreren; score für einen Grad. Alle Fragen kommen in das questions-Array derselben Anfrage, und jede Frage erhält ein name. 6. Die choice-Optionen müssen alle Fälle abdecken; fügen Sie eine Option „keine der genannten“ hinzu und geben Sie jeder Option eine description. 7. Lesen Sie die Ergebnisse über name. Bei choice und score entscheidet confidence, ob automatisch ausgeführt wird, bei predicate probability. Setzen Sie den Schwellenwert zunächst auf 0.7 und legen Sie ihn als Konfigurationswert an, damit er sich später anpassen lässt. Fälle unterhalb des Schwellenwerts gehen an einen Menschen oder einen Auffangprozess. 8. Maßgeblich für Felder und Fehler ist https://ofox.ai/de/docs/api/decisions , zur Verwendung siehe https://ofox.ai/de/docs/develop/models/jev . [Schritt 4: testen] 9. Führen Sie je einen Aufruf mit 3 eindeutigen und 2 uneindeutigen Beispielen durch und zeigen Sie mir für jedes Antwort, Wahrscheinlichkeit und Konfidenz. 10. Geben Sie bei Fehlern den HTTP-Statuscode, error.message und request_id aus, ändern Sie anhand der Fehlertabelle in der Dokumentation nur eine Sache und versuchen Sie es erneut. Ist derselbe Fehler nach zwei Korrekturen nicht behoben, halten Sie an und geben Sie mir den unveränderten Fehlertext und die request_id.
Migration von TypeSafe
In Projekten, die das offizielle TypeSafe SDK verwenden oder deren Code nach der offiziellen TypeSafe-Dokumentation erstellt wurde, ist lediglich die Base URL auf https://api.ofox.ai/typesafe zu ändern und der API Key durch den OfoxAI API Key zu ersetzen:
export TYPESAFE_BASE_URL="https://api.ofox.ai/typesafe"
export TYPESAFE_API_KEY="$OFOX_API_KEY"Anfragen werden an /typesafe/v1/systemone gesendet; das Format entspricht dem offiziellen TypeSafe-Format (state und questions mit der Fragen-ID als Schlüssel; der Fragetyp für Ja/Nein-Fragen ist noul). Eine Gegenüberstellung beider Formate sowie SDK-Beispiele finden Sie unter Decisions API · Natives TypeSafe-Format. Für neue Projekte wird die direkte Verwendung von /v1/decisions empfohlen.