Независимое руководствоНезависимое руководство по Jev — модели TypeSafe AI
Практический путеводитель по Jev

От получения доступа до первого запроса

Как начать работу с Jev

Попробуйте свой вопрос с Jev без собственного API-ключа, а затем следуйте официальным шагам TypeSafe для получения доступа и подключения API.

Независимое руководствоПоследняя проверка Обновлено

Главное

Попробуйте свой вопрос здесь без собственного API-ключа. Для интеграции в приложение получите доступ к аккаунту и API TypeSafe через официальную консоль.

01

Начать без кода

Проверьте вопрос «Да/Нет» или 2–6 своих вариантов в бесплатной независимой демоверсии. Собственный API-ключ не нужен; живые проверки зависят от доступности сервиса.

Попробовать
02

Для разработчиков

Попробуйте свой вопрос здесь без собственного API-ключа. Для интеграции в приложение получите доступ к аккаунту и API TypeSafe через официальную консоль.

Открыть технические подробности

Практические руководства

Формулируйте вопросы точнее и разбирайтесь в результатах.

Предложить очередь и проверить решение

Классификация отзывов клиентов с Jev

Попробуйте шаблон классификации, уточните границы категорий и проверьте неоднозначные сообщения до маршрутизации.

Читать руководство
Одна конкретная проверка черновика

Проверка абсолютных обещаний в тексте продукта

Отмечайте абсолютные обещания вопросом да/нет, затем самостоятельно проверяйте формулировку и контекст.

Читать руководство
Найдите пропуски до отправки

Проверка полноты ответа с Jev

Попробуйте шаблон, который проверяет, отвечает ли черновик на все явно сформулированные части запроса.

Читать руководство
Соотнесите вопрос с нужным решением

Jev Choice или Noul: выбор типа вопроса

Когда выбирать одну категорию с Choice, а когда проверять условие да/нет с Noul.

Читать руководство
Явно опишите границы категорий

Пересекающиеся метки при классификации с Jev

Различайте конкурирующие маршруты и совместимые свойства, уточняйте границы категорий и сохраняйте ручную проверку.

Читать руководство
Сопоставьте число с его вопросом

Вероятность и confidence в Jev: в чём разница

Разберитесь в вероятности варианта и confidence для Choice, не смешивая их с измеренной точностью.

Читать руководство

Начать без кода

Вы можете попробовать свой текст и вопрос в бесплатной независимой демоверсии этого сайта, не предоставляя API-ключ. Задайте правило «Да/Нет» или 2–6 вариантов. Чтобы подключить Jev к своему приложению, используйте отдельный официальный путь доступа к аккаунту и API TypeSafe, описанный ниже.

Демоверсия допускает до 10 000 символов суммарно в тексте, вопросе, правилах и вариантах, считая кодовые точки Unicode. Это лимит сайта, а не контекстное окно Jev. Живые проверки могут требовать подтверждения, что вы человек, и приостанавливаться при достижении квот или бюджета. Загрузка шаблона не запускает запрос и не подставляет результат модели.

Открыть редактор своей задачи · Загрузить шаблон классификации отзывов

1. Выберите подходящий способ получить доступ

По состоянию на 17 сентября 2026 года публичный сайт TypeSafe предлагает записаться в список ожидания. Официальное краткое руководство содержит инструкции по Playground и API. Доступность страницы документации не означает, что каждый аккаунт имеет доступ к модели.

  • Если у вас нет доступа: воспользуйтесь списком ожидания на официальном сайте TypeSafe. Этот сайт не может одобрять аккаунты или выдавать ключи API.
  • Если вашему аккаунту предоставлен доступ: откройте консоль TypeSafe и следуйте инструкциям для Playground или получения ключа API.

Условия доступа к аккаунтам и порядок подключения могут меняться. Проверить собственный статус можно в официальной консоли.

2. Попробуйте один узкий вопрос

В Playground возьмите короткое вымышленное сообщение в качестве входных данных и задайте один вопрос Noul. Например, используйте сообщение с просьбой перезвонить и спросите, содержится ли в нём явная просьба об обратном звонке. Затем замените его неопределённой просьбой о помощи и посмотрите, изменится ли результат.

Это ознакомительное упражнение, а не проверка точности. Два контрастных примера помогают понять, отражает ли вопрос именно то различие, которое вы хотели выделить.

Jev называет переданную информацию state, то есть контекстом. Это может быть строка, объект JSON или массив. В более сложных задачах используйте именованные поля, чтобы сообщение, подтверждающие записи и соответствующие правила оставались различимыми. Форматы входных данных

Для разработчиков

3. Отправьте первый запрос к API

Документированный адрес — POST https://api.typesafe.ai/v1/systemone. Он принимает имя модели, контекст и именованные вопросы. Для аутентификации используется bearer-токен. Справочник API

Безопасно задайте TYPESAFE_API_KEY в локальном окружении, затем выполните этот авторский пример в терминале:

Открыть технические подробности
curl --fail-with-body --silent --show-error \
  https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "jev-latest",
  "state": "Please call me tomorrow morning to discuss the setup.",
  "questions": {
    "callback_requested": {
      "type": "noul",
      "instructions": "Does the sender explicitly ask for a phone call?"
    }
  }
}
JSON

В успешном ответе прочитайте answers.callback_requested.noul и usage.input_tokens. Поля ответа

Noul выражает оценочную вероятность ответа «да». Как интерпретировать Noul

Храните ключи в окружении терминала или сервера. Не помещайте их в браузерный JavaScript, публичный репозиторий, снимок экрана или пример для общего доступа. Это руководство никогда не предлагает вставить ключ на данный сайт.

4. Добавляйте структуру по мере необходимости

Используйте Choice, когда следующий шаг зависит от категории, Score — когда у вас есть осмысленные упорядоченные уровни, и Noul — когда нужна вероятность ответа «да» или «нет». Объединяйте независимые вопросы к одному контексту в запросе, а результаты обрабатывайте в приложении.

В качестве конкретного следующего шага разберите пример обращения в поддержку. В нём показано, как документированный вывод превращается в предложение по маршрутизации.

5. Разбирайтесь с доступом и запросом по отдельности

Если вход в консоль не завершается, повторно откройте официальную консоль через обычную точку входа и проверьте, что используете аккаунт с доступом. Не пытайтесь решить проблему входа в браузере многократными изменениями API-запроса. Успешный вход также не подтверждает, что ключ API уже выдан. Если нужна помощь с аккаунтом, воспользуйтесь официальным каналом поддержки TypeSafe; никогда не публикуйте ключ или ссылку для входа в открытом сообщении о проблеме.

При работе с HTTP-запросом сначала проверьте статус и тело ошибки, а уже затем меняйте вопрос:

Признак Что проверить дальше
Ответ 401 Проверьте ключ и заголовок аутентификации bearer
Ответ 422 Прочитайте возвращённые сведения об ошибке валидации и проверьте поля запроса
Ответ 429 Снизьте частоту запросов и повторите попытку с увеличением интервала
Ответ 529 Рассматривайте его как временную перегрузку и повторите попытку с увеличением интервала

Эти коды описаны в справочнике API. При 429 или 529 используйте экспоненциальное увеличение интервала. SDK по умолчанию уже выполняют повторные попытки; учитывайте их, прежде чем добавлять внешний цикл повторов.

Тайм-аут отличается от отрицательного ответа. Установите общий предельный срок и ограниченное число попыток, после чего направляйте нерешённые случаи на проверку. Убедитесь, что повтор запроса к модели не может повторить последующее действие, например создание назначения.

6. Разберитесь с неожиданным ответом

Что вы наблюдаете Что полезно проверить
Формально верный ответ на другой вопрос Сравните точные инструкции с нужным условием; явно укажите исключения
Результат изменился после правки Сохраняйте вместе версию модели, контекст, метки вариантов, их порядок и шкалу оценки
Оценка оказалась между уровнями Понимайте её как взвешенную позицию, а не целочисленную метку или точную величину
Убедительный результат при слабой доказательной базе Проверьте фактическое содержимое контекста; уверенность не восполняет отсутствующие записи
Два ответа противоречат друг другу Проверьте каждый вопрос независимо и задайте в коде правила разрешения конфликтов

Это редакционные рекомендации по отладке. Руководство по Score объясняет дробные значения; наша страница ограничений ссылается на текущие оговорки поставщика и отдельно отмеченные наблюдения участников сообщества.

Псевдоним jev-latest может начать указывать на более новую модель. Во время тестирования записывайте возвращённый идентификатор модели; когда важна воспроизводимость, используйте версионный идентификатор, поддерживаемый вашим аккаунтом. Псевдонимы моделей

7. Определите, готов ли первый рабочий процесс

Прежде чем включать автоматические действия, соберите небольшой набор ожидаемых решений, изучите ошибки и выберите пороговые значения для своего процесса. С помощью калькулятора стоимости оцените расходы на входные токены, а сравнение инструментов поможет определить, какие задачи стоит оставить другим средствам.

Источники и дополнительные материалы

Руководство опирается на официальную документацию и сообщения сообщества по ссылкам. Авторы наблюдений сообщества указаны.

  1. Доступ к TypeSafe и список ожидания
  2. Официальное краткое руководство
  3. Справочник HTTP API
  4. Контекст и форматы входных данных
  5. Модели и псевдонимы
Как мы проверяем источники