Jev — model decyzyjny

Autoryzacja

• Authorizationheaderwymagany

  Klucz Ailoot w postaci Bearer sk-….

Treść żądania

• modelstringwymagany

  jev-latest.

• statestring | object | arraywymagany

  Co oceniać: ciąg z tekstem lub JSON — zgłoszenie klienta, rekord z bazy, korespondencję, bieżący stan Twojej aplikacji. Obiekt z czytelnymi nazwami pól zwykle jest wygodniejszy niż pojedynczy ciąg znaków.

• questionsobjectwymagany

  Pytania. Klucze wybierasz sam; odpowiedzi otrzymasz pod tymi samymi kluczami. Klucz nie wpływa na odpowiedź — samo pytanie jest zadawane w instructions.

• questions.*.typestringwymagany

  noul, choice lub score — zobacz poniżej.

• questions.*.instructionsstring | object | arraywymagany

  Samo pytanie. Długie pytanie z danymi można przekazać jako obiekt: pytanie w jednym polu, dane w innych; odwołuj się do pól po nazwie w grawisach.

• questions.*.criteriaobject | array

  Opcje odpowiedzi, różne dla każdego typu: opisy „tak” i „nie” dla noul (opcjonalnie), słownik wariantów dla choice, uporządkowana lista poziomów dla score.

Typy można łączyć w jednym żądaniu.

noul — tak czy nie

Pole criteria jest opcjonalne: można w nim opisać, co oznacza „tak” (true) i „nie” (false). Odpowiedź noul — liczba od 0 (nie) do 1 (tak).

"is_urgent": {
  "type": "noul",
  "instructions": "Czy ta wiadomość wskazuje na pilną sprawę?",
  "criteria": {
    "true": "Wyraźnie wymaga szybkiej reakcji",
    "false": "Nie wskazuje na pilną sprawę"
  }
}

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

choice — wybór wariantu

criteria — słownik „wariant → opis”; jeśli opis nie jest potrzebny, podaj null. Do 255 wariantów. W odpowiedzi choice — najbardziej prawdopodobny wariant, probabilities — prawdopodobieństwo każdego wariantu (łącznie 1), confidence — pewność od 0 do 1.

"department": {
  "type": "choice",
  "instructions": "Który zespół powinien się tym zająć?",
  "criteria": {
    "billing": "Płatności, fakturowanie, zwroty",
    "technical": "Błędy, awarie, integracje",
    "sales": "Ceny, przejście na wyższy plan, nowi klienci"
  }
}

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

score — ocena na skali

criteria — poziomy od najniższego do najwyższego, nie więcej niż 10 (TypeSafe zaleca co najmniej dwa). W odpowiedzi score — wartość ważona prawdopodobieństwami poziomów (może znaleźć się między poziomami), legend — numer poziomu i jego opis, probabilities i confidence. Według TypeSafe, score nadaje się do porównania z progiem, ale nie do wyznaczania dokładnej liczby między poziomami.

"frustration": {
  "type": "score",
  "instructions": "Jak bardzo sfrustrowany jest klient?",
  "criteria": ["Spokojny", "Sfrustrowany", "Bardzo rozzłoszczony"]
}

"frustration": {
  "type": "score",
  "score": 1.05,
  "legend": { "0": "Spokojny", "1": "Sfrustrowany", "2": "Bardzo rozzłoszczony" },
  "probabilities": { "0": 0.0, "1": 0.95, "2": 0.05 },
  "confidence": 0.92
}

• modelstring

  Która wersja modelu odpowiedziała. Alias jev-latest z czasem przechodzi na nowe wersje: jeśli dobrałeś progi confidence dla konkretnej wersji, obserwuj to pole.

• answersobject

  Po jednej odpowiedzi na każde pytanie, pod tymi samymi kluczami. Każda odpowiedź ma type, a w przypadku choice i score — także confidence.

• usageobject

  input_tokens i output_tokens. Opłata jest pobierana tylko za tokeny wejściowe.

Zadaj wszystkie pytania dotyczące jednego state w jednym żądaniu: są oceniane równolegle, a state jest przekazywany raz. Według TypeSafe w ich przykładzie z 13 pytaniami jedno wspólne żądanie było 12,2 razy tańsze i 10 razy szybsze niż 13 osobnych żądań wysyłanych kolejno, przy tych samych odpowiedziach.

Złożony osąd lepiej rozbić na proste pytania i połączyć odpowiedzi w kodzie: na przykład zamiast „oceń wniosek” — osobne oceny rynku, wykonalności i różnic wobec konkurencji. Wagi zmieniają się wtedy w kodzie, a nie w treści pytania.

{
  "model": "jev-latest",
  "state": "Pomocy! Od 3 dni moje wypłaty kończą się niepowodzeniem.",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Który zespół powinien się tym zająć?",
      "criteria": {
        "billing": "Płatności, fakturowanie, zwroty",
        "technical": "Błędy, awarie, integracje",
        "sales": "Ceny, przejście na wyższy plan, nowi klienci"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "Jak bardzo sfrustrowany jest klient?",
      "criteria": ["Spokojny", "Sfrustrowany", "Bardzo rozzłoszczony"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "Czy ta wiadomość wskazuje na pilną sprawę?"
    }
  }
}

• Routing. Przekazać zgłoszenie do właściwego działu, a żądanie do właściwego wykonawcy: prostego kodu, dużego modelu lub człowieka.
• Sortowanie i priorytet. Pilność, ton wypowiedzi, ryzyko — na skali, z progami w kodzie.
• Moderacja i kontrole. Czy wiadomość narusza zasady, czy źródło potwierdza cytat, czy w dokumencie znajduje się odpowiedź na pytanie — zanim tekst zostanie przekazany dalej.
• Scoring i ranking. Oceń dokumenty, kandydatów lub znalezione fragmenty według własnych kryteriów oceniania i zdecyduj w kodzie, co będzie przetwarzane dalej.
• Zamiast kruchego „zwróć JSON”. Wywołanie, które z założenia zwraca typowane wartości, a nie tekst wymagający parsowania.

• Czat, odpowiedzi użytkownikowi, generowanie tekstu lub kodu. Jev nie generuje tekstu — do tego służą modele tekstowe.
• Model dla Claude Code, Cursor i innych agentów. Nie da się podstawić jev-latest zamiast modelu agenta: agent potrzebuje modelu, który generuje tekst i wywołuje narzędzia. Jev można wywoływać z kodu, który agent napisze dla Ciebie.
• Arytmetyka, liczenie, porównywanie dat. Według TypeSafe takie operacje pewniej wykonywać w kodzie, a model pytać tylko o część znaczeniową — na przykład wydobyć części daty przez choice.
• Obrazy, audio i wideo. Model przyjmuje tylko tekst — wcześniej przekształć takie dane w tekst.

Opłata jest pobierana tylko za tokeny wejściowe — pole usage.input_tokens odpowiedzi: $0.084 za 1 mln. Tokeny wyjściowe są bezpłatne.

Żądanie z przykładu na tej stronie (296 tokenów wejściowych) kosztuje mniej niż $0.0001.

Przed żądaniem Ailoot rezerwuje kwotę na saldzie, a po odpowiedzi obciąża je raz według faktycznego zużycia — jak to działa.

Limity modelu — według TypeSafe. Ograniczenia Twojego klucza i salda obowiązują tak samo jak dla dowolnego modelu Ailoot: Błędy i limity.

Błędy przychodzą w ogólnym formacie Ailoot API: kod, czytelny opis i Request ID. W tej metodzie najczęściej występują:

Pełna lista kodów — na stronie Błędy i limity.