Come usare Jev

Provalo qui, poi crea la tua chiave

Apri il Playground di jevmodel.org e prova una decisione ristretta. Quando l’output è utile, accedi, apri la Dashboard, crea una API key e salvala come JEVMODEL_API_KEY sul tuo server.

Mantieni l’insieme di risposte piccolo e stabile. Dai al campo il nome del ramo che il tuo codice prenderà, non quello di un tema vago.

import os
import requests

response = requests.post(
    "https://jevmodel.org/v1/systemone",
    headers={"Authorization": f"Bearer {os.environ['JEVMODEL_API_KEY']}"},
    json={
        "state": "I was charged twice. Please fix this ASAP.",
        "model": "jev-latest",
        "questions": {
            "category": {
                "type": "choice",
                "instructions": "What is this ticket about?",
                "criteria": {"billing": "payments", "technical": "broken product", "other": "other"},
            },
        },
    },
    timeout=15,
)
print(response.json())

Il contratto HTTP

I repository che inviano già questa richiesta ↗ sono elencati nella directory dei progetti Jev.

Invia un unico POST a https://jevmodel.org/v1/systemone. model seleziona jev-latest o una versione fissata. state può essere una stringa o un valore JSON fino a 8.000 caratteri dopo la serializzazione. questions è un oggetto con 1–8 domande nominate di tipo choice, score o noul.

• L’endpoint di jevmodel.org consente 120 richieste al minuto per ogni API key.
• Ogni richiesta riuscita addebita token di input. Le richieste fallite a monte vengono rimborsate; aggiungi un header Idempotency-Key quando riprovi.
• Metti una soglia di confidenza nel tuo codice. Jev rende il ramo più facile, non privo di rischi.

curl -X POST https://jevmodel.org/v1/systemone \
  -H "Authorization: Bearer $JEVMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "Customer: I was charged twice and I am furious.",
    "questions": {
      "topic": {
        "type": "choice",
        "instructions": "What is the issue about?",
        "criteria": { "billing": "money problems", "bug": "broken product" }
      },
      "urgent": {
        "type": "noul",
        "instructions": "Escalate to a human now?"
      }
    }
  }'

Cosa fare con la risposta

Dirama nel codice dell’applicazione. Se topic è billing e escalate.noul supera la tua soglia, instrada verso un umano. Se la confidenza è bassa, invia lo stesso stato a un modello più grande o a un revisore. Registra input, output, versione e risultato a valle per capire se Jev sta aiutando il flusso di lavoro o sembra solo deciso.