💬AI-консультант для внешней системы

AI-консультант для вашей внешней системы

Sensei не размещает чат на вашем сайте и не переписывается с клиентами сам. Диалог живёт в вашей системе — в чате на сайте, CRM или мессенджере клиентов, — а Sensei отвечает на вопросы по вашей базе знаний по API. Контакты и история общения остаются у вас, знания — в одном месте.

Как подключить

1. Создайте консультанта в разделе «AI-консультанты» (вручную или в конструкторе) и в поле «Для кого консультант» выберите «Внешняя система». Консультанты «для сотрудников» предназначены для кабинета и мессенджера — для внешней системы заведите отдельный профиль со своим промптом.
2. В Настройки → Интеграции выпустите API-токен с правом bot:chat.
3. Ваша система вызывает POST /api/bot/{slug}/chat с заголовком Authorization: Bearer <токен>; slug — адрес консультанта из его карточки.

Что передавать

• message — вопрос клиента, до 4000 символов.
• chat_history — предыдущие реплики диалога, старые первыми. Sensei не хранит историю: каждый запрос самодостаточен.
• context — данные о клиенте или записи из вашей системы, до 8000 символов. Консультант использует их как справочные данные — например, чтобы назвать дату ближайшего занятия. Идентификаторы (номер клиента, номер записи) ставьте в начало.
• session_id — ваш идентификатор диалога; вернётся в ответе и попадёт в логи.

Что приходит в ответ

• answer — текст ответа по базе знаний.
• sources и referenced_articles — статьи, на которых основан ответ (если у консультанта включено «Показывать источники»).
• is_empty — в базе знаний ничего не нашлось, консультант ответил запасной фразой.
• json_valid — для консультантов в JSON-режиме: разбирается ли ответ как JSON.

JSON-режим

Если вашей системе нужен структурированный ответ — например, текст плюс признак «нужен человек», — включите у консультанта «Ответ в формате JSON» и опишите нужные поля в промпте. Sensei проверит ответ модели и при необходимости починит его, а json_valid покажет, можно ли его разбирать.

Показ ответа клиенту, передача оператору и сохранение контактов остаются на стороне вашей системы — Sensei отдаёт только знания. Все обращения видны в разделе «AI-консультанты → Логи»: видно, о чём спрашивают и где базе знаний не хватает ответов.

Помощник «Спросить Sensei» в этой справке работает по тому же принципу: отвечает по опубликованным статьям help-центра и честно говорит, если ответа нет.