Web API
Вызов персонажей из любого движка
Web API Neocortex позволяет любому движку, языку или платформе общаться с персонажами, созданными в редакторе, по обычному HTTP. Всё, что делают SDK Neocortex, проходит через те же эндпоинты, поэтому собственный движок, игровой сервер или бэкенд-инструмент получают ровно тех же персонажей, что и проект на SDK. Отправьте id персонажа и сообщение игрока, и ответ придёт в виде структурированных данных, с которыми игра сразу может работать.
Web API: возможности
Web API подходит для движков без SDK, для серверов и для всего остального, что умеет отправлять HTTPS-запросы.
Три ключевые возможности и преимущества
Один базовый URL обслуживает чат, групповой чат, историю разговоров, синтез речи, потоковую речь и распознавание речи, а аутентификация идёт по API-ключу, привязанному к вашей команде. Другие преимущества:
Ответы приходят структурированными данными, а не сплошным текстом: от одной до трёх реплик, у каждой своя эмоция, игровые действия, которые выбрал персонаж, с id целевого объекта для каждого из них, и контрольная точка сценария диалога, до которой дошёл ход.
Игра может сообщать персонажу, что он воспринимает и что только что произошло: до 40 сущностей и 20 событий на запрос. Данные о мире всегда обрабатываются как данные и никогда как инструкции.
Эндпоинт использования показывает расход по каждому игроку и каждому персонажу относительно лимитов, заданных в панели, так что игра может узнать о превышении лимита ещё до запроса.
Для браузерных игр Web SDK добавляет небольшой серверный прокси, который хранит API-ключ на вашем сервере, так что браузер его никогда не видит.