Что он делает
Официальный JavaScript SDK подключает приложения на JavaScript и TypeScript к API TypeSafe. Типизированные помощники для вопросов позволяют согласовать типы ответов с определёнными вами вопросами, поэтому выбранную категорию можно использовать в остальной части программы, не разбирая ответ как абзац текста.
В веб-продукте такой вызов обычно должен выполняться на сервере. Браузер отправляет запрос пользователя вашему приложению, сервер обращается к Jev, а интерфейс показывает полученную рекомендацию. Чёткая граница между клиентом и сервером также не позволяет ключу API попасть в браузерный пакет.
Кому подходит
Это простой вариант для команд, которые уже поддерживают серверную часть на JavaScript. Он хорошо подходит, когда продукту нужно одно целевое решение рядом с существующим кодом — например, предлагаемая категория лида или очередь поддержки. Если ваша команда уже использует AI SDK для разных провайдеров, сравните и эту интеграцию: единые соглашения могут быть важнее самого прямого клиента.
Знакомая вам ситуация
Форма обращения на сайте принимает и предложения о партнёрстве, и вопросы клиентов. Сервер может попросить Jev определить предполагаемую цель обращения и показать сотруднику, работающему с входящими сообщениями, предлагаемое направление. При этом проверяющий должен видеть исходное обращение и иметь возможность изменить категорию.
Если посетитель отправит одну и ту же форму дважды, используйте собственный идентификатор запроса, чтобы предотвратить создание дубликатов. Ответ модели не заменяет такой контроль. Точно так же решение о срочности запроса само по себе не должно давать разрешение на отправку сообщения или изменение учётной записи.
Разумная первая настройка
- Проверьте текущие требования к среде выполнения и установите @typesafe-ai/sdk в серверный проект.
- Загружайте ключ API из окружения развёртывания и не помещайте его в клиентский код.
- Определите короткий список осмысленных категорий, затем отправьте пример с помощью официального клиента.
- Добавьте заметный запасной вариант на случай недоступности сервиса или неуверенной классификации.
- Протестируйте полный процесс от отправки формы до проверки результата, прежде чем разрешать ему запускать дальнейшие действия.
Что учесть перед выбором
Вывод типов помогает находить несоответствия полей при разработке, но не выявляет плохо определённую бизнес-категорию. Результат может быть корректным по структуре и при этом направить обращение не той команде. Сохраняйте проверочную выборку и тестируйте сообщения со смешанным намерением, опечатками и на языках, которыми пользуются ваши клиенты.
Не заставляйте интерактивную страницу бесконечно ждать решения. Если классификация занимает слишком много времени, сохраните обращение и позвольте пользователю продолжить; приложение сможет завершить классификацию позже.
Учётные записи и расходы на запуск
SDK — это способ получить доступ к сервису, а не включённый запас вызовов модели. Вам нужен подходящий доступ к API, а расходы на хостинг не входят в плату за инференс. Сравнивайте затраты по объёму текста в каждом запросе и фактическому числу вызовов. Обновление страницы или повторная отправка формы не должны без необходимости заново классифицировать неизменившийся текст.