Cabi.Chat Oracles — виджет для сайта
Виджет для сайта — оракул, который живёт на вашем собственном сайте или в вашем приложении: посетитель вводит вопрос, и оракул отвечает из графа вашего проекта. Cabi.Chat Graph — Оракулы™
Два режима хостинга
На платформе. Cabi.Chat запускает виджет за вас на Spectral, системе плагинов платформы. Его токен хранит платформа, так что вам не приходится с ним иметь дело. Spectral — плагины через эмулятор Telegram-бота
Свой хостинг. Чат-интерфейс вы держите сами: окно чата на сайте, форма в приложении, собственный бот поддержки. Ваш сервер передаёт каждое сообщение посетителя оракулу одним вызовом API и показывает ответ.
В обоих режимах оракул работает в Cabi.Chat по агенде виджета, на тех же моделях, что и любой оракул. На своём хостинге может быть только виджет; аккаунты и боты Telegram всегда работают на платформе.
Настройка
- В Кабинете создайте оракул вида Cabi.Chat widget: выберите проект, режим хостинга и агенду-прошивку. Cabi.Chat Ignite — агенды
- Свой хостинг: скопируйте access-токен. Он показывается один раз. Потеряли? Сгенерируйте заново: старый токен сразу перестаёт работать.
- Запустите оракул.
Вызов (свой хостинг). Один вызов на каждое сообщение посетителя: POST /v0/call-ai к API, с access-токеном виджета в качестве bearer и телом:
client_nonce— nonce виджета, строкой;correspondent_ident— стабильный id, который вы присваиваете каждому посетителю;text— то, что написал посетитель.
В ответе приходят text ответа (пустой, когда отправлять ничего не нужно), модель, которая его написала, и потраченные токены. Держите id посетителя стабильным: тот же id продолжает тот же разговор; давайте каждому реальному посетителю один id. Токен привязан к своему виджету и не работает для другого оракула.
Тот же токен открывает API Cabi.Chat от имени агенды виджета: Cabi.Chat API — приложения