Jev – model pro rozhodování

Autorizace

• Authorizationheaderpovinný

  Klíč Ailoot ve tvaru Bearer sk-….

Tělo požadavku

• modelstringpovinný

  jev-latest.

• statestring | object | arraypovinný

  Co vyhodnotit: řetězec s textem nebo JSON – sdělení zákazníka, záznam z databáze, korespondenci, aktuální stav vaší aplikace. Objekt se srozumitelnými názvy polí je obvykle praktičtější než jeden řetězec.

• questionsobjectpovinný

  Otázky. Klíče volíte vy, odpovědi přijdou pod stejnými klíči; klíč nemá vliv na odpověď – samotnou otázku zadáváte v instructions.

• questions.*.typestringpovinný

  noul, choice nebo score – viz níže.

• questions.*.instructionsstring | object | arraypovinný

  Samotná otázka. Dlouhou otázku s daty lze předat jako objekt: otázku v jednom poli, data v dalších; na pole odkazujte jejich názvem ve zpětných apostrofech.

• questions.*.criteriaobject | array

  Varianty odpovědi, specifické pro každý typ: popisy „ano“ a „ne“ pro noul (nepovinné), slovník variant pro choice, seřazený seznam úrovní pro score.

Typy lze kombinovat v jednom požadavku.

noul – ano nebo ne

Pole criteria je nepovinné: můžete v něm popsat, co znamená „ano“ (true) a „ne“ (false). Odpověď noul – číslo od 0 (ne) do 1 (ano).

"is_urgent": {
  "type": "noul",
  "instructions": "Vyjadřuje to naléhavost?",
  "criteria": {
    "true": "Výslovně vyjádřená časová naléhavost",
    "false": "Naléhavost není vyjádřena"
  }
}

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

choice – výběr varianty

criteria – slovník „varianta → popis“; pokud popis není potřeba, uveďte null. Až 255 variant. V odpovědi choice – nejpravděpodobnější varianta, probabilities – pravděpodobnost každé varianty (součet je 1), confidence – míra jistoty od 0 do 1.

"department": {
  "type": "choice",
  "instructions": "Který tým by to měl řešit?",
  "criteria": {
    "billing": "Platby, fakturace, vracení peněz",
    "technical": "Chyby, výpadky, integrace",
    "sales": "Ceny, přechod na vyšší tarif, noví zákazníci"
  }
}

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

score – hodnocení na stupnici

criteria – úrovně od nejnižší po nejvyšší, nejvýše 10 (TypeSafe doporučuje alespoň dvě). V odpovědi score – hodnota vážená pravděpodobnostmi úrovní (může ležet mezi úrovněmi), legend – číslo úrovně a její popis, probabilities a confidence. Podle údajů TypeSafe, score je vhodný pro porovnání s prahem, nikoli jako přesné číslo mezi úrovněmi.

"frustration": {
  "type": "score",
  "instructions": "Jak moc je zákazník frustrovaný?",
  "criteria": ["Klidný", "Frustrovaný", "Velmi rozzlobený"]
}

"frustration": {
  "type": "score",
  "score": 1.05,
  "legend": { "0": "Klidný", "1": "Frustrovaný", "2": "Velmi rozzlobený" },
  "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 },
  "confidence": 0.92
}

• modelstring

  Která verze modelu odpověděla. Alias jev-latest postupně přechází na nové verze: pokud jste nastavili prahy confidence pro konkrétní verzi, sledujte toto pole.

• answersobject

  Jedna odpověď na každou otázku, pod stejnými klíči. Každá odpověď má type, u choice a score navíc confidence.

• usageobject

  input_tokens a output_tokens. Účtují se pouze vstupní tokeny.

Pokládejte všechny otázky k jednomu state v jediném požadavku: vyhodnocují se paralelně a state se předává jen jednou. Podle údajů TypeSafe byl v jejich příkladu s 13 otázkami jeden společný požadavek 12,2krát levnější a 10krát rychlejší než 13 samostatných požadavků odesílaných postupně, při stejných odpovědích.

Složité posouzení je lepší rozdělit na jednoduché otázky a odpovědi spojit v kódu: například místo „zhodnoť žádost“ – samostatná hodnocení trhu, proveditelnosti a odlišností od konkurence. Váhy se pak mění v kódu, nikoli v textu otázky.

{
  "model": "jev-latest",
  "state": "Pomoc! Už 3 dny mi neprocházejí výplaty.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Který tým by to měl řešit?",
      "criteria": {
        "billing": "Platby, fakturace, vracení peněz",
        "technical": "Chyby, výpadky, integrace",
        "sales": "Ceny, přechod na vyšší tarif, noví zákazníci"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "Jak moc je zákazník frustrovaný?",
      "criteria": ["Klidný", "Frustrovaný", "Velmi rozzlobený"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "Vyjadřuje to naléhavost?"
    }
  }
}

• Směrování. Předat sdělení příslušnému oddělení a požadavek správnému zpracovateli: jednoduchému kódu, velkému modelu nebo člověku.
• Třídění a priorita. Naléhavost, vyznění, riziko – na stupnici, s prahy v kódu.
• Moderování a kontroly. Zda zpráva porušuje pravidla, zda zdroj potvrzuje citaci, zda dokument obsahuje odpověď na otázku – dříve, než se text předá dál.
• Hodnocení a řazení. Vyhodnotit dokumenty, kandidáty nebo nalezené úryvky podle vlastních hodnoticích kritérií a v kódu rozhodnout, co se předá dál.
• Namísto křehkého „vrať JSON“. Volání, které už svou konstrukcí vrací typované hodnoty, nikoli text, který je nutné rozebírat.

• Chat, odpovědi uživateli, generování textu nebo kódu. Jev nepíše text – k tomu slouží textové modely.
• Model pro Claude Code, Cursor a další agenty. Nahradit model agenta modelem jev-latest nelze: agent potřebuje model, který píše text a volá nástroje. Jev můžete volat z kódu, který pro vás agent napíše.
• Aritmetika, počítání, porovnávání kalendářních dat. Podle údajů TypeSafe je spolehlivější dělat to v kódu a modelu zadávat jen významovou část – například vyjmout části data pomocí choice.
• Obrázky, zvuk a video. Model přijímá pouze text – taková data převeďte na text předem.

Účtují se pouze vstupní tokeny – pole usage.input_tokens odpovědi: $0.084 za 1 milion. Výstupní tokeny jsou zdarma.

Požadavek z příkladu na této stránce (296 vstupních tokenů) stojí méně než $0.0001.

Před požadavkem Ailoot rezervuje částku na zůstatku a po odpovědi ji jednou strhne podle skutečné spotřeby – jak to funguje.

Limity modelu jsou podle údajů TypeSafe. Omezení vašeho klíče a zůstatku platí stejně jako pro kterýkoli model Ailoot: Chyby a limity.

Chyby přicházejí v obecném formátu Ailoot API: kód, srozumitelný text a Request ID. U této metody se nejčastěji vyskytují:

Úplný seznam kódů najdete na stránce Chyby a limity.