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/json

POST /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Аккаунт не подходит. Проверьте дашборд или правила выше.
429Jev занят. Если есть Retry-After, соблюдайте его и повторите с паузой. Это не лимит прокси 512 req/s.
502 или 503Jev временно недоступен. Повторите с паузой.