Jev — beslissingsmodel

Authenticatie

• Authorizationheaderverplicht

  Ailoot-sleutel in de vorm Bearer sk-….

Verzoekbody

• modelstringverplicht

  jev-latest.

• statestring | object | arrayverplicht

  Wat je wilt beoordelen: tekst of JSON — een klantvraag, databaserecord, correspondentie of de huidige toestand van je applicatie. Een object met duidelijke veldnamen is meestal handiger dan één string.

• questionsobjectverplicht

  Vragen. Je kiest zelf de sleutels; de antwoorden gebruiken dezelfde sleutels. De sleutel beïnvloedt het antwoord niet — de vraag zelf staat in instructions.

• questions.*.typestringverplicht

  noul, choice of score — zie hieronder.

• questions.*.instructionsstring | object | arrayverplicht

  De vraag zelf. Een lange vraag met gegevens kun je als object doorgeven: de vraag in één veld, de gegevens in andere. Verwijs met backticks naar de veldnamen.

• questions.*.criteriaobject | array

  Antwoordopties verschillen per type: omschrijvingen van “ja” en “nee” bij noul (optioneel), een woordenboek met opties bij choice en een geordende lijst met niveaus bij score.

Je kunt de typen binnen één verzoek combineren.

noul — ja of nee

Veld criteria is optioneel: hierin kun je beschrijven wat “ja” (true) en “nee” (false) betekenen. Het antwoord noul — een getal van 0 (nee) tot 1 (ja).

"is_urgent": {
  "type": "noul",
  "instructions": "Drukt dit urgentie uit?",
  "criteria": {
    "true": "Expliciet tijdsgevoelig",
    "false": "Geen urgentie aangegeven"
  }
}

"is_urgent": {
  "type": "noul",
  "noul": 0.95
}

choice — een optie kiezen

criteria — een woordenboek “optie → omschrijving”; geef null op als geen omschrijving nodig is. Maximaal 255 opties. In het antwoord is choice — de meest waarschijnlijke optie, probabilities — de waarschijnlijkheid van elke optie (samen 1), confidence — de mate van zekerheid, van 0 tot 1.

"department": {
  "type": "choice",
  "instructions": "Welk team moet dit behandelen?",
  "criteria": {
    "billing": "Betalingen, facturatie, terugbetalingen",
    "technical": "Bugs, uitval, integraties",
    "sales": "Prijsstelling, upgrades, nieuwe klanten"
  }
}

"department": {
  "type": "choice",
  "choice": "billing",
  "probabilities": { "billing": 0.88, "technical": 0.12, "sales": 0.0 },
  "confidence": 0.81
}

score — een score op een schaal

criteria — niveaus van laag naar hoog, maximaal 10 (TypeSafe raadt minimaal twee aan). In het antwoord is score — een waarde gewogen naar de waarschijnlijkheden van de niveaus (kan tussen niveaus liggen), legend — het nummer en de omschrijving van het niveau, probabilities en confidence. Volgens TypeSafe is score geschikt voor een vergelijking met een drempel, maar niet voor een exact getal tussen de niveaus.

"frustration": {
  "type": "score",
  "instructions": "Hoe gefrustreerd is de klant?",
  "criteria": ["Rustig", "Gefrustreerd", "Erg boos"]
}

"frustration": {
  "type": "score",
  "score": 1.05,
  "legend": { "0": "Rustig", "1": "Gefrustreerd", "2": "Erg boos" },
  "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 },
  "confidence": 0.92
}

• modelstring

  Welke modelversie heeft geantwoord. De alias jev-latest verwijst na verloop van tijd naar nieuwe versies: als je drempels voor confidence voor een specifieke versie hebt ingesteld, houd dit veld dan in de gaten.

• answersobject

  Eén antwoord per vraag, onder dezelfde sleutels. Elk antwoord heeft type, choice en score hebben ook confidence.

• usageobject

  input_tokens en output_tokens. Alleen invoertokens worden in rekening gebracht.

Stel alle vragen over één state in één verzoek: ze worden parallel beoordeeld en state wordt maar één keer doorgegeven. Volgens TypeSafe was in hun voorbeeld met 13 vragen één gezamenlijk verzoek 12,2 keer goedkoper en 10 keer sneller dan 13 afzonderlijke verzoeken die achter elkaar werden verstuurd, met dezelfde antwoorden.

Splits een complex oordeel liever op in eenvoudige vragen en combineer de antwoorden in code: bijvoorbeeld afzonderlijke beoordelingen van de markt, haalbaarheid en verschillen met concurrenten in plaats van “beoordeel de aanvraag”. De gewichten kun je dan in code wijzigen, in plaats van in de vraagtekst.

{
  "model": "jev-latest",
  "state": "Help! Mijn uitbetalingen mislukken al 3 dagen.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Welk team moet dit behandelen?",
      "criteria": {
        "billing": "Betalingen, facturatie, terugbetalingen",
        "technical": "Bugs, uitval, integraties",
        "sales": "Prijsstelling, upgrades, nieuwe klanten"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "Hoe gefrustreerd is de klant?",
      "criteria": ["Rustig", "Gefrustreerd", "Erg boos"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "Drukt dit urgentie uit?"
    }
  }
}

• Routering. Stuur een klantvraag naar de juiste afdeling en een verzoek naar de juiste verwerker: eenvoudige code, een groter model of een mens.
• Sorteren en prioriteren. Urgentie, sentiment en risico: op een schaal, met drempels in code.
• Moderatie en controles. Overtreedt een bericht de regels, onderbouwt een bron het citaat of staat het antwoord op de vraag in een document — controleer dit voordat de tekst verdergaat.
• Scoring en rangschikking. Beoordeel documenten, kandidaten of gevonden fragmenten volgens je eigen rubric en beslis in code wat verdergaat.
• In plaats van een kwetsbare instructie “geef JSON terug”. Een aanroep die door zijn opzet getypeerde waarden teruggeeft, in plaats van tekst die je nog moet parsen.

• Chat, antwoorden aan gebruikers en tekst- of codegeneratie. Jev schrijft geen tekst — daarvoor zijn er tekstmodellen.
• Als model voor Claude Code, Cursor en andere agents. Je kunt jev-latest niet als vervanger voor het agentmodel gebruiken: een agent heeft een model nodig dat tekst schrijft en tools aanroept. Je kunt Jev aanroepen vanuit de code die de agent voor je schrijft.
• Rekenen, tellen en datums vergelijken. Volgens TypeSafe is het betrouwbaarder om dit in code te doen en alleen het inhoudelijke deel aan het model te vragen — bijvoorbeeld de onderdelen van een datum ophalen via choice.
• Afbeeldingen, audio en video. Het model accepteert alleen tekst — zet zulke gegevens vooraf om naar tekst.

Alleen invoertokens worden in rekening gebracht — veld usage.input_tokens van het antwoord: $0.084 per 1 miljoen. Outputtokens zijn gratis.

Het voorbeeldverzoek op deze pagina (296 invoertokens) kost minder dan $0.0001.

Vóór het verzoek reserveert Ailoot een bedrag op het saldo en na het antwoord wordt één keer het daadwerkelijke verbruik afgeschreven — zo werkt het.

De modellimieten zijn volgens TypeSafe. De beperkingen van je sleutel en saldo gelden zoals voor elk Ailoot-model: Fouten en limieten.

Fouten komen in het algemene Ailoot API-formaat: een code, duidelijke tekst en de Request ID. Bij deze methode komen vooral de volgende fouten voor:

De volledige lijst met codes staat op de pagina Fouten en limieten.