Nezávislý sprievodca a komunita pre vývojárov
Oficiálne informácie o Jev: typesafe.ai

Vyskúšajte Jev zadarmo

Položte jednu otázku alebo tri rôzne otázky k tej istej situácii. Vyberte príklad, upravte vstup a pozrite si jednotlivé štruktúrované odpovede.

Preskúmať projekty na GitHube
01 / Vyberte otázku

Začnite konkrétnym príkladom

typesafe/jev-1.13

Skúšajte vždy jeden typ odpovede. Každé spustenie spotrebuje jeden denný pokus.

1. Choice
questions.decision
Náhľad požiadavky API

Náhľad neobsahuje kľúč API ani overovací token. Každé ID otázky má odpoveď s rovnakým názvom.

{
  "model": "typesafe/jev-1.13",
  "state": {
    "input": "Predplatné ste mi zaúčtovali dvakrát. Môžete mi pomôcť?"
  },
  "questions": {
    "decision": {
      "type": "choice",
      "instructions": "Ktorý tím má požiadavku vybaviť?",
      "criteria": {
        "billing": "Platby a vrátenie peňazí",
        "technical": "Chyby a integrácie",
        "general": "Ostatné otázky"
      }
    }
  }
}

Na účet pripadá 6 bezplatných pokusov denne podľa UTC; o 00:00 UTC sa limit obnoví. Denná kapacita celého webu je obmedzená. Vstup sa posiela do OpenRouter; ukladáme údaje o použití, nie váš vstup.

02 / Ako čítať odpoveď

Môžete začať

Spustite príklad a získajte štruktúrovanú odpoveď na každú otázku: Choice vyberie možnosť, Score zaradí výsledok na škálu a Probability vráti hodnotu od 0 do 1.

Integrácia

Pridajte Jev do svojho kódu.

Formulár odošle váš text ako state.input spolu s jednou alebo tromi pomenovanými otázkami. Každý výsledok nájdete pod answers.<question_id>.

Čo znamenajú jednotlivé polia

V požiadavke určíte otázky a formát odpovedí. Odpoveď obsahuje výsledok pre každú otázku. Tu sú vysvetlené polia JSON z príkladu.

Polia požiadavky

model
ID modelu. Príklad výslovne používa verziu Jev 1.13.
state
Text alebo štruktúrované údaje na vyhodnotenie, napríklad správa zákazníka.
questions
Objekt s pomenovanými otázkami. Rovnaké názvy sa objavia v poli answers.
<question_id>
Názov, napríklad action alebo urgency; odpoveď používa rovnaký názov.
type
Formát odpovede: choice vyberie možnosť, score hodnotí na usporiadanej stupnici a noul posudzuje otázku áno/nie.
instructions
Konkrétny úsudok, ktorý má model vykonať.
criteria
Povolené možnosti Choice, usporiadané úrovne Score alebo význam false a true pre Noul.

Polia odpovede

answers
Jeden výsledok pre každú otázku, vždy pod rovnakým názvom.
choice
Kľúč vybranej možnosti s najvyššou pravdepodobnosťou.
probabilities
Pravdepodobnosť každej možnosti; súčet hodnôt je 1.
confidence
Samostatná miera istoty vypočítaná z rozdelenia pravdepodobností; nejde o pravdepodobnosť vybranej možnosti.
score
Pozícia na usporiadanej stupnici vážená pravdepodobnosťami; môže ležať medzi dvoma úrovňami.
legend
Priradenie číselných pozícií Score k opisom úrovní, ktoré ste zadali.
noul
Číslo od 0 (nie) do 1 (áno) pre otázku áno/nie.

Jeden spoločný kontext, tri nezávislé otázky: Choice, Score a Probability. Každé spustenie spotrebuje jeden denný pokus. Aj správne štruktúrovaná odpoveď môže byť chybná. Testujte na reprezentatívnych prípadoch a nastavte vhodné prahy pre svoj pracovný postup.

Koncový bod

OpenRouter

Tento Playground volá pevne zvolenú verziu Jev cez OpenRouter. Aktuálne ceny a dostupnosť nájdete na stránke modelu.

Koncový bod
POST https://openrouter.ai/api/alpha/decisions
model
typesafe/jev-1.13
Kľúč API
Kľúč API odosielajte zo servera ako token Bearer.
OpenRouter ↗
Oficiálne priame API

TypeSafe

TypeSafe má vlastný koncový bod a vlastné kľúče API. Oficiálny úvod používa jev-latest a ukazuje, ako odoslať viac otázok v jednej požiadavke.

Koncový bod
POST https://api.typesafe.ai/v1/systemone
model
jev-latest
Kľúč API
Kľúč API odosielajte zo servera ako token Bearer.

TypeScript na strane servera

TypeScript · fetch
// Run on your server. Keep the API key out of browser code.
const apiKey = process.env.OPENROUTER_API_KEY;
if (!apiKey) throw new Error("Set OPENROUTER_API_KEY");

const response = await fetch("https://openrouter.ai/api/alpha/decisions", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + apiKey,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "typesafe/jev-1.13",
    state: {input: "A customer reports a duplicate charge."},
    questions: {
      team: {
        type: "choice",
        instructions: "Which team should handle this?",
        criteria: {
          billing: "Payments and refunds",
          technical: "Bugs and integrations"
        }
      },
      urgency: {
        type: "score",
        instructions: "How urgent is the issue?",
        criteria: ["Can wait", "Needs attention today", "Immediate action"]
      },
      escalate: {
        type: "noul",
        instructions: "Should a human review this first?",
        criteria: {false: "No review needed", true: "Review before acting"}
      }
    }
  })
});

if (!response.ok) throw new Error("Decision request failed");
const {answers} = await response.json();
console.log(answers.team.choice, answers.urgency.score, answers.escalate.noul);
Ako čítať odpoveď

Tri typy otázok, tri podoby odpovedí

Vyberte podobu odpovede, ktorú váš kód potrebuje. Pri viacerých otázkach dostane každé ID samostatný výsledok.

TypeSafe: Choice · Score · Noul ↗

Choice

choice · probabilities · confidence

Kľúč vybranej možnosti s najvyššou pravdepodobnosťou.

Score

score · legend · probabilities · confidence

Pozícia na usporiadanej stupnici vážená pravdepodobnosťami; môže ležať medzi dvoma úrovňami.

Noul

noul

Číslo od 0 (nie) do 1 (áno) pre otázku áno/nie.

Pred nasadením do produkcie

Model otestujte na reprezentatívnych požiadavkách, zaznamenajte jeho verziu a nejasné alebo závažné prípady odovzdajte človeku. Hodnota 0,8 je len príklad.