Jev
Jev — не модель Gonka. Это настоящая decision-модель. Факты передаются в state, нужные суждения — в questions. Jev возвращает структурные ответы, с которыми может работать код. Это не чат: не отправляйте jev в /v1/chat/completions.
Цена $0, и эти вызовы не входят в лимит прокси. Аккаунт может вызывать Jev только после 100 000 000 токенов за последние 30 дней (UTC), включая сегодня. Ниже этой отметки доступа нет. В дашборде видны эти токены. Право проверяется на каждом вызове. Когда окно сдвигается и аккаунт оказывается ниже линии, вызов отклоняется и никуда не уходит.
Глубокое исследование использует Jev внутри цикла, чтобы оставить или отбросить страницы. Это не вызов Jev API: оно не тарифицируется, и порог в 100 000 000 токенов не применяется. Отчёт пишет модель, которую вы указали.
Вызов
Используется тот же API-ключ, что и для chat completions. Храните его на сервере.
POST https://api.proxy.gonka.gg/v1/systemone
Authorization: Bearer sk-...
Content-Type: application/jsonPOST /v1/decisions — тот же endpoint. GET /v1/systemone описывает модель, цену и правила доступа.
curl https://api.proxy.gonka.gg/v1/systemone \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-api-key-here" \
-d '{
"model": "jev",
"state": "My card was charged twice. Please help ASAP.",
"questions": {
"team": {
"type": "choice",
"instructions": "Which team should handle this?",
"criteria": {
"billing": "Payments and refunds",
"technical": "Bugs and integrations",
"sales": "Pricing and new accounts"
}
}
}
}'const res = await fetch("https://api.proxy.gonka.gg/v1/systemone", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.GONKA_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "jev",
state: "My card was charged twice. Please help ASAP.",
questions: {
team: {
type: "choice",
instructions: "Which team should handle this?",
criteria: {
billing: "Payments and refunds",
technical: "Bugs and integrations",
sales: "Pricing and new accounts",
},
},
},
}),
})
const data = await res.json()import os, requests
res = requests.post(
"https://api.proxy.gonka.gg/v1/systemone",
headers={"Authorization": f"Bearer {os.environ['GONKA_API_KEY']}"},
json={
"model": "jev",
"state": "My card was charged twice. Please help ASAP.",
"questions": {
"team": {
"type": "choice",
"instructions": "Which team should handle this?",
"criteria": {
"billing": "Payments and refunds",
"technical": "Bugs and integrations",
"sales": "Pricing and new accounts",
},
}
},
},
timeout=60,
)
data = res.json()Ниже — образец формы ответа, не живой результат.
{
"model": "jev",
"answers": {
"team": {
"type": "choice",
"choice": "billing",
"probabilities": {
"billing": 0.94,
"technical": 0.04,
"sales": 0.02
},
"confidence": 0.85
}
}
}Выбранная команда — answers.team.choice.
Поля запроса
| Поле | Тип | Что передавать |
|---|---|---|
state | Строка, объект или массив. Обязательно | Текст и факты, нужные для ответа. Сюда же — записи или правила. |
questions | Объект. Обязательно | Непустая карта: id вопроса → определение. Id возвращает результат в ваш код. |
model | Строка | jev |
Сам вопрос пишите в instructions. Id вроде team только подписывает ответ и не заменяет вопрос.
Все вопросы видят один и тот же state. Независимые вопросы можно слать вместе. Каждый вопрос — одно суждение. Три типа ниже можно смешивать в одном вызове.
Choice
Один вариант из заданного набора. В criteria до 255 вариантов. В ответе есть choice, probabilities и confidence.
{
"model": "jev",
"state": "My card was charged twice. Please help ASAP.",
"questions": {
"team": {
"type": "choice",
"instructions": "Which team should handle this?",
"criteria": {
"billing": "Payments and refunds",
"technical": "Bugs and integrations",
"sales": "Pricing and new accounts"
}
}
}
}{
"model": "jev",
"answers": {
"team": {
"type": "choice",
"choice": "billing",
"probabilities": { "billing": 0.94, "technical": 0.04, "sales": 0.02 },
"confidence": 0.85
}
}
}Score
Оценка по упорядоченной шкале до 10 уровней. В ответе есть score, legend, probabilities и confidence.
{
"model": "jev",
"state": "My card was charged twice. Please help ASAP.",
"questions": {
"severity": {
"type": "score",
"instructions": "How severe is this request?",
"criteria": {
"0": "No impact",
"1": "Minor inconvenience",
"2": "The customer is blocked",
"3": "Money or data is at risk"
}
}
}
}{
"model": "jev",
"answers": {
"severity": {
"type": "score",
"score": 1.6,
"legend": [
"No impact",
"Minor inconvenience",
"The customer is blocked",
"Money or data is at risk"
],
"probabilities": { "0": 0.05, "1": 0.40, "2": 0.45, "3": 0.10 },
"confidence": 0.72
}
}
}Noul
Суждение да/нет. В criteria можно описать, что значат true и false; поле можно опустить. Ответ — noul, число от 0 до 1. Близко к 1 — да, близко к 0 — нет, около 0.5 — неопределённость. Отдельного поля confidence нет.
{
"model": "jev",
"state": "My card was charged twice. Please help ASAP.",
"questions": {
"urgent": {
"type": "noul",
"instructions": "Does this need a response today?",
"criteria": {
"true": "The customer is blocked or money is at risk",
"false": "It can wait"
}
}
}
}{
"model": "jev",
"answers": {
"urgent": {
"type": "noul",
"noul": 0.92
}
}
}Что делать с ответом
Читайте результат по id вопроса и применяйте свои правила. У choice и score есть probabilities и confidence от 0 до 1. Confidence — сигнал, не гарантия. Пороги проверяйте на своих примерах.
const { team } = data.answers
if (team.confidence < 0.8) {
queueForReview(ticket)
} else {
routeTicket(ticket, team.choice)
}Кому доступно
100 000 000 токенов за последние 30 дней UTC, включая сегодня. Окно сдвигается каждый день. Ниже этой отметки аккаунт не может вызывать Jev.
На обзоре в дашборде видны эти токены и включён ли Jev прямо сейчас. Отдельного лимита запросов на этом маршруте нет.
Если не получилось
Смотрите HTTP-статус до того, как читать answers.
| Статус | Что делать |
|---|---|
| 401 | Ключ отсутствует или неверен. См. Аутентификация. |
| 400 или 422 | Неверный JSON. Нужны state, непустой questions и модель jev. |
| 403 | Аккаунт не подходит. Проверьте дашборд или правила выше. |
| 429 | Jev занят. Если есть Retry-After, соблюдайте его и повторите с паузой. Это не лимит прокси 512 req/s. |
| 502 или 503 | Jev временно недоступен. Повторите с паузой. |