Jev — beslutningsmodell

Autentisering

• Authorizationheaderpåkrevd

  Ailoot-nøkkel i formatet Bearer sk-….

Forespørselskropp

• modelstringpåkrevd

  jev-latest.

• statestring | object | arraypåkrevd

  Hva som skal vurderes: en tekststreng eller JSON — en kundehenvendelse, en databasepost, en samtale eller applikasjonens nåværende tilstand. Et objekt med forståelige feltnavn er vanligvis mer praktisk enn én streng.

• questionsobjectpåkrevd

  Spørsmål. Du velger nøklene selv, og svarene kommer under de samme nøklene; nøkkelen påvirker ikke svaret — selve spørsmålet angis i instructions.

• questions.*.typestringpåkrevd

  noul, choice eller score — se nedenfor.

• questions.*.instructionsstring | object | arraypåkrevd

  Selve spørsmålet. Et langt spørsmål med data kan sendes som et objekt: spørsmålet i ett felt og dataene i andre; referer til feltene med navnet i gravaksenter.

• questions.*.criteriaobject | array

  Svaralternativer, ulike for hver type: beskrivelser av «ja» og «nei» for noul (valgfritt), en ordbok med alternativer for choice og en ordnet liste med nivåer for score.

Typene kan kombineres i én forespørsel.

noul — ja eller nei

Feltet criteria er valgfritt: her kan du beskrive hva «ja» (true) og «nei» (false) betyr. Svaret noul — et tall fra 0 (nei) til 1 (ja).

"is_urgent": {
  "type": "noul",
  "instructions": "Uttrykker dette at det haster?",
  "criteria": {
    "true": "Uttrykkelig tidskritisk",
    "false": "Ingen hast uttrykt"
  }
}

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

choice — velg et alternativ

criteria — en ordbok av typen «alternativ → beskrivelse»; hvis ingen beskrivelse er nødvendig, angir du null. Opptil 255 alternativer. I svaret er choice — det mest sannsynlige alternativet, probabilities — sannsynligheten for hvert alternativ (summen er 1), confidence — sikkerhet fra 0 til 1.

"department": {
  "type": "choice",
  "instructions": "Hvilket team bør håndtere dette?",
  "criteria": {
    "billing": "Betalinger, fakturering, refusjoner",
    "technical": "Feil, driftsavbrudd, integrasjoner",
    "sales": "Priser, oppgraderinger, nye kunder"
  }
}

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

score — vurdering på en skala

criteria — nivåer fra lavest til høyest, maksimalt 10 (TypeSafe anbefaler minst to). I svaret er score — en verdi vektet etter nivåenes sannsynligheter (kan ligge mellom nivåene), legend — nivånummeret og beskrivelsen av nivået, probabilities og confidence. Ifølge TypeSafe er score egnet til å sammenligne med en terskel, men ikke til å angi et nøyaktig tall mellom nivåene.

"frustration": {
  "type": "score",
  "instructions": "Hvor frustrert er kunden?",
  "criteria": ["Rolig", "Frustrert", "Veldig sint"]
}

"frustration": {
  "type": "score",
  "score": 1.05,
  "legend": { "0": "Rolig", "1": "Frustrert", "2": "Veldig sint" },
  "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 },
  "confidence": 0.92
}

• modelstring

  Hvilken modellversjon som svarte. Aliaset jev-latest peker over tid til nyere versjoner: hvis du har tilpasset tersklene confidence til en bestemt versjon, bør du følge med på dette feltet.

• answersobject

  Ett svar per spørsmål, under de samme nøklene. Hvert svar har type, choice og score har i tillegg confidence.

• usageobject

  input_tokens og output_tokens. Bare inndatatokener belastes.

Still alle spørsmål om samme state i én forespørsel: de vurderes parallelt, og state sendes bare én gang. Ifølge TypeSafe var én samlet forespørsel i deres eksempel med 13 spørsmål 12,2 ganger billigere og 10 ganger raskere enn 13 separate forespørsler sendt etter hverandre, med de samme svarene.

Del gjerne en kompleks vurdering opp i enkle spørsmål og kombiner svarene i koden: for eksempel separate vurderinger av marked, gjennomførbarhet og forskjeller fra konkurrenter i stedet for «vurder søknaden». Da endrer du vektene i koden, ikke i spørsmålsteksten.

{
  "model": "jev-latest",
  "state": "Hjelp! Utbetalingene mine har feilet de siste 3 dagene.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Hvilket team bør håndtere dette?",
      "criteria": {
        "billing": "Betalinger, fakturering, refusjoner",
        "technical": "Feil, driftsavbrudd, integrasjoner",
        "sales": "Priser, oppgraderinger, nye kunder"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "Hvor frustrert er kunden?",
      "criteria": ["Rolig", "Frustrert", "Veldig sint"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "Uttrykker dette at det haster?"
    }
  }
}

• Ruting. Send en henvendelse til riktig avdeling og en forespørsel til riktig behandler: enkel kode, en stor modell eller et menneske.
• Sortering og prioritering. Hastegrad, tone og risiko — på en skala, med terskler i koden.
• Moderering og kontroll. Om en melding bryter reglene, om en kilde bekrefter et sitat, eller om et dokument inneholder svaret på et spørsmål — før teksten sendes videre.
• Vurdering og rangering. Vurder dokumenter, kandidater eller søkeresultater etter dine egne kriterier og avgjør i koden hva som går videre.
• I stedet for et skjørt «returner JSON». Et kall som returnerer typede verdier som en del av utformingen, i stedet for tekst som må tolkes.

• Chat, svar til brukeren eller generering av tekst og kode. Jev skriver ikke tekst — til det finnes tekstmodeller.
• Som modell for Claude Code, Cursor og andre agenter. Du kan ikke erstatte agentens modell med jev-latest: agenten trenger en modell som skriver tekst og kaller verktøy. Jev kan kalles fra koden agenten skriver for deg.
• Aritmetikk, telling og datosammenligning. Ifølge TypeSafe er dette mer pålitelig i kode; spør modellen bare om meningsinnholdet — for eksempel å hente ut deler av en dato med choice.
• Bilder, lyd og video. Modellen godtar bare tekst — konverter slike data til tekst på forhånd.

Bare inndatatokener belastes — feltet usage.input_tokens i svaret: $0.084 per 1 million. Utdatatokener er gratis.

Eksempelforespørselen på denne siden (296 inndatatokener) koster mindre enn $0.0001.

Før forespørselen reserverer Ailoot et beløp på saldoen, og etter svaret belastes det én gang etter faktisk forbruk — slik fungerer det.

Modellgrensene er oppgitt av TypeSafe. Nøkkel- og saldobegrensningene gjelder som for alle andre Ailoot-modeller: Feil og grenser.

Feil returneres i Ailoot APIs felles format: kode, forståelig tekst og Request ID. De vanligste feilene for denne metoden er:

Den fullstendige listen over koder finnes på siden Feil og grenser.