AI Агент — Руководство по настройке

Платформа поддерживает работу бота в режиме AI агента. В этом режиме сообщения пользователей обрабатываются нейросетевой моделью вместо статического конструктора диалогов.

Режимы работы

Режим выбирается в настройках бота: Редактировать бота → AI Агент → Режим работы.

Системный промпт

Инструкция для AI о его роли и поведении. Пример:

Ты дружелюбный ассистент компании «Название». Помогай клиентам выбрать 
продукт, отвечай кратко и по существу. Общайся на русском языке.

Рекомендации по промпту:

• Укажите тематику и роль: кто есть AI, какой компании.
• Задайте тон: формальный / неформальный.
• Укажите ограничения: о чём нельзя говорить.
• Чем конкретнее промпт — тем точнее ответы.

Промпт настраивается во вкладке AI Агент в конструкторе меню.

Поля для сбора данных

В ходе диалога AI автоматически собирает нужные данные у пользователей.

Как настроить: во вкладке AI Агент добавьте поля с кодами и подсказками.

Как работает сбор

Система использует отдельный AI-вызов для извлечения данных из диалога — это надёжнее встроенных маркеров:

1. Пользователь отвечает на вопрос AI.
2. После получения ответа система анализирует последние сообщения отдельным запросом.
3. Найденные значения сохраняются в базу данных.
4. При следующих запросах AI знает, что уже собрано, и не задаёт повторных вопросов.

Быстрые ответы

Кнопки, предлагаемые пользователю под каждым ответом AI. Удобны для частых запросов:

• «Узнать цену»
• «Связаться с менеджером»
• «Показать каталог»

Настраиваются во вкладке AI Агент → раздел «Быстрые ответы».

Глубина контекста

Количество предыдущих сообщений диалога, передаваемых в AI при каждом запросе.

• Больше контекста → AI лучше понимает историю разговора, но выше расход токенов.
• Рекомендуемое значение: 10–20 сообщений.

Настройка GigaChat (Сбер)

Шаг 1 — Регистрация и создание проекта

1. Перейдите на developers.sber.ru/studio.
2. Создайте новый проект.
3. Подключите продукт GigaChat API.

Шаг 2 — Authorization Key

1. В настройках проекта откройте раздел Credentials.
2. Скопируйте поле «Authorization Data» — это готовый Base64-ключ.
3. Вставьте его в поле Authorization Key в настройках бота.

⚠️ Важно: Используйте именно поле «Authorization Data», а не отдельные поля Client ID и Client Secret.

Шаг 3 — Тип доступа (Scope)

Шаг 4 — Выбор модели

Проверка ключа

При сохранении настроек система автоматически проверяет корректность ключа реальным запросом к API. Если ключ неверный — выводится предупреждение, а ключ сбрасывается (остальные настройки сохраняются).

Настройка YandexGPT (Яндекс)

Шаг 1 — Сервисный аккаунт

1. Перейдите в console.yandex.cloud.
2. Откройте IAM → Сервисные аккаунты → Создать.
3. Назначьте роль ai.languageModels.user.

Шаг 2 — API-ключ

1. Откройте созданный аккаунт.
2. Перейдите в Ключи доступа → Создать API-ключ.
3. Сохраните значение — оно отображается только один раз.

Шаг 3 — Folder ID

Folder ID виден в URL консоли:

console.yandex.cloud/folders/b1gXXXXXXX

Или в настройках каталога.

Шаг 4 — Выбор модели

Режим Гибрид

В режиме «Гибрид» система ведёт себя следующим образом:

Сообщение пользователя
        ↓
    AI-запрос
        ↓
Успех? → Ответ пользователю
Сбой?  → Статический конструктор (fallback)

Это позволяет обеспечить бесперебойную работу бота даже при временной недоступности AI сервиса.