Настройка AI-агента

AI-агент — это «мозг» вашего бота. Один агент хранит языковую модель (например, GigaChat или OpenAI), базу знаний (загруженные документы и сайты), а также персону: имя, роль, тон общения и приветствие. Когда клиент пишет в Telegram, MAX или VK, сообщение обрабатывает именно агент, привязанный к этому боту.

Важно понимать главный принцип платформы: решения принимает не «свободная фантазия» нейросети, а ваши настройки и данные. Агент отвечает строго на основе того, что вы загрузили (документы, курсы, филиалы) и настроили (персона, сценарии). Поэтому чем аккуратнее заполнены настройки, тем точнее и безопаснее работает бот.

В этой статье разберём весь путь: создать агента → выбрать модель и параметры → задать роль, тон и правила поведения → привязать к боту → включить в работу.

Где находятся агенты

Откройте в боковом меню дашборда раздел «Агенты» (/dashboard/agents). Здесь вы увидите список всех своих агентов в виде карточек.

На странице есть:

• Поиск — по названию агента.
• Фильтр по статусу: «Все», «Активные», «Неактивные».
• Кнопка «Создать агента» в правом верхнем углу.

Каждая карточка показывает: иконку модели, название, описание, статус («Активен» зелёным или «Отключён» серым), провайдера модели и время создания. Если у агента включены особые режимы, под описанием появятся пометки Strict RAG и Web Search.

[скриншот: список агентов с карточками, поиском и кнопкой «Создать агента»]

Шаг 1. Создание агента

1. Нажмите «Создать агента».
2. В блоке «Основная информация» заполните:
   • Название агента (обязательно) — например, «Консультант Алгоритмика». Это служебное имя, его видите только вы в дашборде.
   • Описание (необязательно) — короткая заметка, для чего этот агент.
3. В блоке «Языковая модель» выберите провайдера:
   • GigaChat (Сбер) — русский язык, быстрая и экономичная модель. Выбрана по умолчанию.
   • OpenAI — мощная многоязычная модель (GPT-4o и др.).
4. Ниже появится выпадающий список «Модель» — конкретная версия выбранного провайдера. Под каждой моделью есть подсказка: для чего она лучше подходит и её «уровень» (lite / pro / max). Если не уверены — оставьте модель, предложенную по умолчанию.
5. Нажмите «Создать агента».

После создания платформа сразу откроет страницу настроек этого агента — там вы продолжите настройку.

[скриншот: форма создания агента — название, описание, выбор провайдера и модели]

Подсказка по выбору модели. Для большинства школ и бизнесов в России хорошо подходит GigaChat — он быстрый, понимает русский и дешевле. Если нужны сложные диалоги-продажи или работа на нескольких языках, выбирайте OpenAI GPT-4o. Модель всегда можно сменить позже в настройках.

Шаг 2. Базовые настройки агента

На странице агента нажмите кнопку «Настройки» (или перейдите по карточке агента → «Настройки»). Откроется экран Настройки: <имя агента> с несколькими блоками.

Основная информация

• Название агента — можно переименовать.
• Описание — свободный текст.

Языковая модель

• Переключатель провайдера (GigaChat / OpenAI).
• Выпадающий список «Модель» с подсказкой под выбранной моделью.
• Temperature (ползунок от «Точнее» до «Креативнее»). Это «температура» ответов:
  • ближе к 0 — ответы строгие, предсказуемые, точно по данным (рекомендуется для консультанта);
  • ближе к 1 — ответы более свободные и «творческие», но выше риск отклонений от фактов.
  • Значение по умолчанию — 0.2. Для бота-консультанта, который должен говорить только по делу, мы советуем держать низкое значение.
• Max Tokens — максимальная длина ответа (по умолчанию 2048). Чем больше число, тем длиннее может быть ответ. Менять обычно не требуется.

После любых изменений нажмите внизу «Сохранить».

[скриншот: блок «Языковая модель» с ползунком Temperature и полем Max Tokens]

Шаг 3. Роль, тон и правила поведения

Имя бота, его роль, тон общения, приветствие и бизнес-данные настраиваются в отдельном продвинутом редакторе. На странице настроек агента найдите блок «Поведение бота» и нажмите кнопку «Настроить поведение» — откроется страница «Настройка бота» (/dashboard/bot-config) для выбранного агента.

Здесь поведение задаётся через шаблон. Шаблон — это готовая заготовка персоны, в которую вы подставляете свои значения. Логика такая: создаёте черновик из шаблона → заполняете поля → активируете.

Как создать и заполнить персону

1. Если у вас несколько агентов — вверху выберите нужного агента в списке «Выберите агента».
2. В блоке «Создать из шаблона» выберите подходящий шаблон и нажмите «Создать черновик».
3. Откроется редактор. Заполните блок «Персона — кто ваш бот»:
   • Имя бота — как зовут вашего консультанта (например, «Оксана»).
   • Роль — кто он (например, «консультант школы программирования»).
   • Тон общения — каким голосом говорит бот (например, «дружелюбный, тёплый, заботливый»).
   • Приветствие — первая фраза при старте диалога (например, «Здравствуйте! Рада вас видеть! Чем могу помочь?»).
4. Заполните блок «Бизнес — о чём говорит бот»:
   • Название школы — например, «Алгоритмика».
   • Сайт — адрес вашего сайта.
   • Образовательная лицензия — номер лицензии (если есть).
5. Нажмите «Сохранить».

Поля, отмеченные звёздочкой * и красной рамкой, обязательны для активации. Платформа сама подскажет, что осталось заполнить, в блоке «Заполните обязательные поля для активации».

[скриншот: редактор персоны — Имя бота, Роль, Тон, Приветствие и блок «Бизнес»]

Активация шаблона

Когда все обязательные поля заполнены, появится зелёная плашка «Все обязательные поля заполнены», а статус сменится на «Готов к активации». Нажмите зелёную кнопку «Активировать» — с этого момента бот начнёт использовать эту персону.

• Статус «АКТИВЕН» означает, что шаблон сейчас работает в боте.
• Кнопкой «Деактивировать» можно временно отключить шаблон, «Удалить» — удалить черновик.

Адреса, телефоны, часы работы и приём заявок настраиваются не здесь, а в разделе «Филиалы». Логика диалога (что спрашивать, в каком порядке, как вести к заявке) — в разделе «Сценарии». Персона задаёт «кто говорит», а сценарии — «как ведётся разговор».

Расширенные настройки (System Prompt)

В редакторе есть свёрнутый блок «Расширенные настройки → System Prompt». Это низкоуровневые системные инструкции для модели. В большинстве случаев он не нужен — достаточно персоны и сценариев. Открывайте его только если точно понимаете, зачем правите системный промпт: ошибки здесь влияют на поведение бота во всех диалогах.

Шаг 4. Привязка агента к боту

Сам по себе агент пока ни с кем не общается. Чтобы он начал отвечать клиентам, его нужно привязать к боту/каналу (Telegram, MAX, VK).

При создании или редактировании бота есть поле «AI Агент» — выпадающий список ваших агентов. Выберите нужного:

[скриншот: создание бота, выпадающее поле «AI Агент» со списком агентов]

• Поле подписано подсказкой «Агент определяет базу знаний и настройки ИИ».
• Привязку можно сделать сразу или позже (в списке есть пункт «Выберите агента (можно позже)»).

После привязки все входящие сообщения этого бота будет обрабатывать выбранный агент: его модель, его база знаний, его персона и сценарии.

Шаг 5. Включение агента в работу

У каждого агента есть статус «Активен» / «Отключён». Отключённый агент не отвечает, даже если привязан к боту.

Включить/выключить агента можно:

• на странице агента — кнопкой «Включить» / «Отключить» (значок питания);
• в списке агентов — через карточку.

[скриншот: страница агента — кнопки «Включить/Отключить», «Настройки» и статус]

Страница агента: что ещё есть

Открыв конкретного агента (/dashboard/agents/<id>), вы увидите:

• Статус и модель в шапке, а также кнопку копирования ID агента (пригодится для интеграций и поддержки).
• Статистику: сколько загружено документов, сколько было чатов, сколько векторов в базе знаний.
• Базу знаний — сюда вы загружаете документы (PDF, DOCX, HTML, до 50 МБ, до 20 файлов за раз) и добавляете сайты по кнопке «URL». Это то, на основе чего агент отвечает. Подробнее — в статьях раздела про базу знаний.
• Кнопки «Настройки», «Включить/Отключить» и удаления (корзина). Удаление требует подтверждения: после первого нажатия кнопка меняется на «Подтвердить?».

Внимание: удаление агента необратимо — вместе с ним удаляются все его документы, векторы базы знаний и история диалогов. Перед удалением убедитесь, что агент ни к кому не привязан и больше не нужен.

Короткий чек-лист запуска

1. Создали агента, задали название.
2. Выбрали провайдера и модель, выставили Temperature (0.1–0.3 для консультанта).
3. В «Поведении бота» создали шаблон, заполнили имя, роль, тон, приветствие и название школы, нажали «Активировать».
4. Загрузили документы в базу знаний (на странице агента).
5. Настроили Филиалы и Сценарии (отдельные разделы).
6. Привязали агента к боту через поле «AI Агент».
7. Убедились, что агент «Активен», и проверили его в тестовом диалоге.

После этого ваш AI-консультант готов отвечать клиентам.