Jak używać Jev

Przetestuj tutaj, potem utwórz klucz

Otwórz Playground jevmodel.org i przetestuj wąską decyzję. Gdy wynik jest użyteczny, zaloguj się, otwórz Dashboard, utwórz klucz API i zapisz go jako JEVMODEL_API_KEY na swoim serwerze.

Utrzymuj zbiór odpowiedzi mały i stabilny. Nazwij pole od gałęzi, którą wybierze Twój kod, a nie od mglistego tematu.

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())

Kontrakt HTTP

Repozytoria, które już wysyłają to żądanie ↗ wymieniono w katalogu projektów Jev.

Wyślij jeden POST na https://jevmodel.org/v1/systemone. model wybiera jev-latest lub przypiętą wersję. state może być ciągiem znaków lub wartością JSON do 8 000 znaków po serializacji. questions to obiekt z 1–8 nazwanymi pytaniami typu choice, score lub noul.

• Endpoint jevmodel.org pozwala na 120 żądań na minutę dla każdego klucza API.
• Każde udane żądanie pobiera tokeny wejściowe. Nieudane żądania upstream są zwracane; przy ponowieniach dodaj nagłówek Idempotency-Key.
• Ustaw próg pewności w kodzie. Jev ułatwia gałąź, nie czyni jej wolną od ryzyka.

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?"
      }
    }
  }'

Co zrobić z odpowiedzią

Rozgałęź w kodzie aplikacji. Jeśli topic to billing, a escalate.noul przekracza Twój próg, kieruj do człowieka. Jeśli pewność jest niska, wyślij ten sam stan do większego modelu lub recenzenta. Loguj wejście, wyjście, wersję i wynik downstream, aby ocenić, czy Jev pomaga workflow, czy tylko wygląda na zdecydowany.