Levanto Sage: API для классификации текста

Что такое Levanto Sage и зачем он нужен?

Sage — сервис Levanto Labs для классификации текста через API и принятия решений по заданным вариантам. Например, клиент пишет, что не может войти в личный кабинет. Sage может отнести сообщение к проблемам с доступом. Приложение использует результат, чтобы отправить обращение нужной команде. На сайте доступны документация и панель для подключения API.

Категории обращений и приоритеты очереди

Укажите допустимые категории в Choice, если нужна одна очередь. В Tags модель оценивает каждую метку отдельно, поэтому обращение может касаться и оплаты, и доставки. Yes/No проверяет одно условие, Scale присваивает оценку по вашей шкале, а Sort сортирует список по заданному критерию. Для срочных случаев полезно заранее определить, по каким признакам оператор должен перепроверять решение.

Извлечение полей и решения по ходу диалога

Передайте текст и описание полей в POST /v1/extract. Можно выделить дату, сумму или текстовую ссылку из сообщения. Проверьте фрагмент, на который ссылается результат, и предусмотрите пустые значения. Если важно отслеживать ход переписки, откройте WebSocket на /v1/stream, задайте вопрос и добавляйте новые реплики. Для исправления отправленного ранее текста потребуется новая сессия.

Как проверить первую классификацию

1. Создайте ключ в панели Decision model → API keys. Храните его на сервере и передавайте в качестве токена Bearer.
2. Отправьте тестовое сообщение в поле content запроса POST /decide. Задайте вопрос с идентификатором, типом yesno и инструкцией, например «Пользователь сообщает о проблеме со входом?».
3. Сопоставьте result.answer с ожидаемой меткой. Проверьте ясное обращение, нерелевантный запрос и сообщение без подробностей. Настройте отдельную обработку неопределённых ответов и ошибок до запуска автоматической маршрутизации.

Расходы на API и хранение данных

Публичный прайс в долларах США, проверенный 10 ноября 2026 года, предусматривает бесплатный месячный объём и платные месячные подписки. Учитываются входные и выходные токены, а также выполненные поисковые запросы. Для предварительной оценки вызова решения используйте POST /usage/estimate. Тарифы Sage

Частые вопросы

Есть ли бесплатный лимит?

Да. В плане Free предусмотрен месячный лимит. После его исчерпания запросы возвращают HTTP 402 до следующего расчётного периода или повышения тарифа. Остаток не переносится.

Используются ли данные API для обучения?

Levanto заявляет, что не обучает модели на входных данных и ответах Sage. Содержимое обычного запроса удаляется после ответа. Для неудачных или необычно медленных запросов диагностические данные могут храниться 30 дней. Политика конфиденциальности Levanto

Как обработать ответ null?

На вопрос Yes/No модель может вернуть null, если не может определить ответ. Направьте такой случай на проверку. Вероятность можно использовать для дополнительного порога после проверки на своих примерах.

Официальные ресурсы

• Быстрый старт Sage — Получение ключа и примеры запросов.
• Levanto Labs на GitHub — Публичные примеры и сравнительные тесты.