Cabi.Chat Ignite — инструменты, эндпоинты и секреты
Оракул действует только через инструменты, которые вы ему выдали. Разговор — лишь один инструмент из многих: отправить сообщение, забронировать время, проверить заказ, создать лид в вашей CRM — всё это вызовы, которые делает оракул. Cabi.Chat Ignite решает, когда вызывать; ваша агенда решает, что можно вызывать. link Cabi.Chat Ignite — агенды
Базовые инструменты. Их каждый оракул получает от платформы:
- send — ответить на своей поверхности: аккаунт Telegram, бот или виджет;
- передать человеку — отметить разговор для вас, с причиной Cabi.Chat Inbox — передача человеку;
- завершить разговор — перестать отвечать тому, кому отвечать не следует;
- look — посмотреть фото из разговора и спросить модель зрения, что на нём, при необходимости — ещё раз, другим вопросом;
- таймер — вернуться к разговору позже, один раз или регулярно;
- заметки — записать и стереть короткие заметки о человеке link;
- история — пролистать назад к более старым сообщениям разговора.
Эндпоинты. Всё остальное — карточка API-эндпоинта: метод, путь, домен, имя операции, описание, схемы запроса и ответа. Оракул может вызывать только эндпоинты из списка своей агенды. Он ищет их обычными словами, читает полную схему нужного и вызывает его. Воркспейс эндпоинтов работает как набор инструментов: его описание говорит оракулу, для чего нужен весь набор.
Секреты. Ключи — это карточки secret. У секрета есть имя (secret_, затем строчные буквы, цифры и подчёркивания), значение и хост, к которому он относится.
- Значение только для записи: его больше никогда не показывают, API его не возвращает, модель его не видит. Чтобы сменить ключ, удалите секрет и создайте новый.
- Ключ отправляется только на тот хост, к которому привязан.
- Секрет должен лежать в воркспейсе. Добавьте его в агенду — и платформа подставит его в вызовы в момент вызова.
- Удалите секрет — и каждая агенда, которая им пользовалась, сразу перезагрузится.
Когда вызов не удался. У каждого вызова есть ограничение по времени. Недоступный хост пропускается до конца хода, а ответ всё равно можно отправить. Отправка с неизвестным итогом доставки никогда не повторяется: оракул устроен так, чтобы не слать дубли.