Начало работы с AI

AI оператор и Copilot работают поверх четырёх типов Ресурсов AI, которые создаются один раз в организации и затем привязываются к конкретным каналам. Эта страница объясняет, что где хранится и зачем нужно.

Карта ресурсов

Ресурс	Что это	Где используется
Контекст	Общее описание компании/домена (домен деятельности, доставка…)	Подставляется в каждый запрос AI оператора и Copilot
Набор товаров	Каталог товаров — через ссылки или из CSV	AI подбирает релевантные товары на вопрос клиента
База знаний	Текстовые материалы (FAQ, политики, инструкции)	AI использует для ответов на вопросы не про товар
API интеграция	Ручки вашего бэкенда, доступные AI оператору во время диалога	AI вызывает ваш API (получение профиля, статус заказа, и т.п.)

Модель

TEXT

Организация (rootChanelUuid)
  ├─ Ресурсы AI
  │   ├─ Контексты    — один на все каналы или разный под канал
  │   ├─ Наборы товаров
  │   ├─ Базы знаний
  │   └─ API интеграции
  │
  └─ Каналы
      └─ Настройки AI оператора: { contextUuid, productUuid, knowledgeUuid, apiIntegrationUuid }

Ресурс и канал — это разные сущности. Один и тот же набор товаров можно привязать к нескольким каналам. Товар физически принадлежит набору, а не каналу; база знаний — базе, а не каналу. Канал лишь хранит UUID-ссылки на выбранные ресурсы.

Где что настраивается в UI

Настройки → Ресурсы AI — создание и редактирование всех ресурсов: контекстов, товаров (с ссылками, без ссылок), баз знаний, API интеграций.
Настройки → Каналы → (конкретный канал) → AI оператор — включение AI оператора для канала и выбор ресурсов.

Типичный сценарий через API

Выпустите API токен с нужными scope-ами в Настройках → API токены.
Создайте контекст / набор / базу / интеграцию через API соответствующего раздела.
Получите channelId через GET /external/channels.
Привяжите ресурсы к каналу через PATCH /external/channels/{channelId}/ai-operator.
Включите AI оператора (status: true).
Заполняйте товары / файлы / ручки через API — изменения подхватятся без перенастройки канала.

Разделы документации

Работа AI оператора требует активной подписки на соответствующий тариф в Настройки → Оплата → AI оператор. Без подписки status канала остаётся false даже при вызове PATCH.

Начало работы с AI#

Карта ресурсов#

Модель#

Где что настраивается в UI#

Типичный сценарий через API#

Разделы документации#