Esempi dell’API di Jev

Choice: scegliere un’etichetta di Jev

Le chiamate choice e score in repository reali ↗ usano questo stesso formato di richiesta.

La migliore prima integrazione di Jev è una domanda a cui la tua applicazione risponde già in modo imperfetto con regole o un modello generalista. Dai un nome all’output e definisci i valori che il tuo codice sa gestire. Fissa jev-1.13.0 quando la soglia è tarata.

const response = await fetch("https://jevmodel.org/v1/systemone", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.JEVMODEL_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    state: message,
    model: "jev-latest",
    questions: {
      topic: {
        type: "choice",
        instructions: "What is this about?",
        criteria: { billing: "payments", bug: "broken product", account: "access" }
      }
    }
  })
});
const result = await response.json();

Score: posizionare Jev su una scala ordinata

Chiedi a Jev dove si colloca lo stato su una rubrica da 2 a 10 livelli descritta a parole. Lo score restituito può essere frazionario. Usalo per urgenza, rischio, qualità dei lead o priorità di revisione — poi applica la soglia nel codice.

Noul: una probabilità sì/no di Jev

Un noul è una probabilità calibrata che una proposizione sia vera. È la primitiva giusta per i gate escalate / allow / needs-review. Non esiste un campo confidenza separato: la probabilità è la misura della certezza.

Raggruppare decisioni Jev correlate

Chiedi topic, severity ed escalation nella stessa richiesta quando condividono lo stesso stato di input. Vengono eseguite insieme e condividono il costo in token dello stato. Mantieni ogni domanda utile in modo indipendente per poterla misurare.

questions: {
  topic: topicQuestion,
  severity: severityQuestion,
  escalation: escalationQuestion
}

Metti un fallback dietro ogni azione di Jev

Un valore tipizzato rende la diramazione più facile, non priva di rischi. Registra input, output, probabilità, versione del modello e risultato a valle. Imposta una soglia di confidenza e instrada i casi incerti verso GPT, Claude o un umano.