Начало работы с ИИ-агентом

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

Что содержит ИИ-агент

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

Модель

TEXT

Организация (rootChanelUuid)
  ├─ ИИ-агенты
  │   └─ Агент
  │       ├─ Контекст и промпт
  │       ├─ Набор товаров
  │       ├─ База знаний
  │       └─ API-интеграция
  │
  └─ Каналы
      └─ Настройки AI-оператора: { aiAgentId }

ИИ-агент и канал — это разные сущности. Одного и того же агента можно выбрать на нескольких каналах. Канал хранит лишь ссылку на выбранного агента — все данные (товары, база знаний, контекст, API) физически принадлежат агенту, а не каналу.

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

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

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

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

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

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

Начало работы с ИИ-агентом#

Что содержит ИИ-агент#

Модель#

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

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

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

Подписка#