AI-агент отвечает клиентам по заданному системному промту, использует подключенные инструменты и учитывает историю диалога. Раздел позволяет создавать агентов, настраивать их поведение и проверять ответы до запуска в рабочих каналах.
Быстрый старт
- Откройте Управление ИИ → Агенты.
- Нажмите Создать.
- Укажите название, модель и при необходимости описание.
- Выберите инструменты, которые разрешено использовать агенту.
- Заполните системный промт вручную или нажмите Сгенерировать промт.
- Оставьте дополнительные настройки по умолчанию, если для проекта не нужны особые ограничения.
- Нажмите Создать.
- Откройте агента и проверьте его через Тестовый чат.
Шаг 1. Основные настройки
Название
Используйте понятное внутреннее название, например Консультант сайта или Агент отдела продаж. Клиенту это название обычно не показывается.
Модель
Модель определяет возможности, скорость и стоимость ответов. Для первого запуска оставьте модель, выбранную по умолчанию, а меняйте ее после сравнения ответов в тестовом чате.
Для reasoning-моделей OpenAI в дополнительных настройках появляется поле Уровень reasoning. Чем выше уровень, тем больше модель уделяет внимания рассуждению, но ответ может формироваться дольше.
Описание
Кратко укажите назначение агента. Описание помогает отличать агентов в списке и не является заменой системного промта.
Активен
Активный агент может использоваться в подключенных сценариях. Отключите переключатель, если агент еще настраивается или его нужно временно вывести из работы.
Шаг 2. Инструменты агента
Инструменты дают агенту дополнительные действия: поиск по базе знаний, работу с таблицами или каталогом, расчет стоимости, создание заявки и передачу диалога оператору.
Выбирайте только те инструменты, которые агент действительно должен применять. Доступный набор зависит от настроек организации и подключенных источников.
Инструменты следует выбрать до генерации системного промта: генератор учитывает именно текущий список.
Шаг 3. Системный промт
Системный промт определяет роль агента, стиль общения, правила работы с фактами, допустимые действия и условия передачи вопроса оператору.
Хороший промт должен содержать:
- роль и задачу агента;
- сведения о компании и услугах, которые важно учитывать;
- правила тона и формата ответа;
- ограничения: что нельзя придумывать или обещать;
- порядок использования инструментов;
- ситуации, когда нужно создать заявку или передать диалог оператору.
Генерация промта по сайту
Нажмите Сгенерировать промт, укажите сайт и опишите пожелания к агенту. Система проанализирует доступные страницы и сформирует промт с учетом выбранных инструментов.
После генерации промт вставляется в поле формы. Обязательно проверьте факты, контакты, условия, ограничения и сценарии передачи оператору. До нажатия Создать или Сохранить результат остается изменением формы.
Шаг 4. Дополнительные настройки
Раздел свернут по умолчанию. Для первого запуска обычно достаточно стандартных значений.
Модель и память
- Температура влияет на вариативность ответов. Низкие значения делают ответы стабильнее.
- Максимум токенов ограничивает объем ответа и внутренних операций модели.
- Сообщений истории в диалоге определяет, сколько последних сообщений попадет в контекст разговора.
- Уровень reasoning доступен только для поддерживаемых reasoning-моделей OpenAI.
Валидация входных данных
Проверка запроса может отдельно обрабатывать приветствия, prompt injection, нерелевантные вопросы, слишком короткие или длинные сообщения и превышение rate limit.
После включения настройте нужные проверки и fallback-сообщения. Проверка релевантности через LLM использует отдельные параметры модели.
Валидация финального ответа
Проверка ответа помогает не показывать клиенту SQL-ошибки, stack trace, технические детали, пустой ответ или опасный HTML.
Доступны простая проверка, проверка через LLM или их сочетание. Автоисправление позволяет повторно сформировать ответ ограниченное число раз.
Настройки поиска
Гибридный поиск сочетает смысловой поиск и BM25. Веса определяют вклад каждого способа, минимальный порог отсекает слабые совпадения, а максимум результатов ограничивает объем найденного контекста.
Меняйте эти параметры после проверки на реальных вопросах: слишком высокий порог может скрыть полезные материалы, а слишком низкий добавить нерелевантные фрагменты.
Фильтрация стоп-слов
Фильтрация удаляет указанные слова из поискового запроса перед вызовом выбранных инструментов. Используйте ее только для слов, которые мешают поиску в конкретной базе знаний.
Проверка агента
Тестовый чат при редактировании
Кнопка Тестовый чат на странице редактирования использует текущие значения формы, включая еще не сохраненные изменения модели, промта, инструментов и дополнительных настроек.
Это удобно для сравнения вариантов. Рабочая конфигурация агента изменится только после нажатия Сохранить.
Playground
Playground — внутренний тестовый чат для сохраненной конфигурации агента. Его сообщения не попадают в клиентский контур.
- Новая сессия начинает отдельный тестовый диалог.
- Сбросить контекст очищает контекст текущего тестирования.
- Редактировать возвращает к настройкам агента.
Подключенные источники
На странице агента отображается таблица Подключенные источники. Она предназначена для просмотра и показывает название, тип и состояние источника.
Состав источников изменяется в соответствующих разделах управления базой знаний, документами, сайтами и другими источниками данных.
Список агентов
В списке можно найти агента по названию или описанию и отфильтровать записи по статусу, модели, runtime и дате создания.
Статус Активен означает, что агент разрешен к использованию. Статус Неактивен позволяет сохранить настройки, не включая агента в рабочие сценарии.
Доступ к разделу
Управление списком и создание AI-агентов доступны владельцам организации и администраторам на тарифе PRO. Изменять существующего агента могут пользователи своей организации с доступом к его странице.
Если функция недоступна на текущем тарифе, в меню отображается метка PRO, а создание агента блокируется. Операторы и руководители операторов не видят раздел управления агентами.
Если агент отвечает неправильно
- Проверьте ответ в Тестовом чате.
- Убедитесь, что в системном промте явно описаны нужные правила.
- Проверьте, выбран ли необходимый инструмент.
- Убедитесь, что нужный источник подключен и включен.
- Снизьте температуру, если ответы слишком непредсказуемы.
- Проверьте порог релевантности поиска, если агент не находит известные данные.
- Проверьте fallback-сообщения и настройки валидации.
- Сохраните изменения и повторите тест в новой сессии.