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

#Как устроена схема

Откройте агента: Коммуникации → AI-агенты → карточка агента. На вкладке «Схема» — холст с блоками, похожий на конструктор ботов:

• «Сообщение клиента» — откуда приходят вопросы: шаг «AI-агент» в боте.
• Базы знаний — слева, связью к порту «Знания».
• Сам агент — его имя и начало роли.
• Режим, навык и модель — какая нейросеть отвечает.
• Под агентом — что он умеет: «Данные клиента», «Цель», «Менеджер», интеграции, «Память и лимиты».

Нажмите на блок — справа откроется панель настройки (на телефоне — шторка снизу). Вверху справа на холсте — кнопки «Навык», «База знаний» и «Интеграция», чтобы добавить новое.

Связи на схеме следуют из настройки — тянуть мышкой можно только от базы знаний к порту «Знания». Блоки можно перетаскивать: их места запоминаются сами и на работу агента не влияют. Кнопка «Упорядочить схему» вверху слева расставит всё заново.

Пока чего-то не хватает, на холсте висит список «Чтобы агент заработал» — нажмите на пункт, и схема покажет нужный блок.

#Роль и правила

Нажмите на блок агента — откроется панель «Роль и правила». Главное поле — «Роль и правила» (до 12 000 символов): это промт, инструкция обычными словами.

#Модель

Блок модели — справа от навыка. Здесь выбирают «Подключение» и «Модель», а ещё:

• «Температура» — от 0 до 1,5. Ниже — ответы точнее и одинаковее (цены, консультации), выше — разнообразнее (тексты, идеи).
• «Длина ответа, токенов» — «Коротко · 300», «Обычно · 700», «Подробно · 1500» или «Максимум · 4000». Один токен — около 3–4 символов.

Блок «Режим»: «Один навык» подходит большинству. «Маршрутизатор» — несколько навыков, например «продажи» и «поддержка», и на каждое сообщение быстрая модель выбирает подходящий. «Цепочка» — навыки по очереди: один пишет черновик, второй проверяет тон. Навыков — до 6. Кнопка «Навык» вверху справа добавляет ещё один; если стоял «Один навык», Sender сам включит «Маршрутизатор».

#Данные клиента

Блок «Данные клиента» — что агент должен узнать: имя, телефон, удобное время. Для каждого поля укажите «Что узнать», «Переменная» (латиницей, заполнится сама) и «Подсказка агенту». Отметка «Обязательно для цели» просит агента собрать это поле, прежде чем отметить цель. Это указание нейросети, а не жёсткая проверка, — убедитесь в окне проверки, что агент его выполняет. Полей — до 12.

Агент сам спросит и сохранит ответы в переменные подписчика — их видно в карточке подписчика и можно использовать дальше в боте: {%phone%}.

#Цель и передача менеджеру

«Цель» — когда разговор закончен: «Клиент выбрал услугу и время, оставил имя и телефон». Агент подтверждает итог клиенту, а бот идёт по выходу «цель достигнута». Краткий итог разговора — в переменной {%agent_summary%}. Без цели агент просто отвечает на вопросы, пока клиент пишет.

«Менеджер» — панель «Передача менеджеру». Переключатель «Агент может позвать менеджера» включён по умолчанию. В поле «Когда звать менеджера» опишите случаи: «клиент недоволен, просит скидку или вопроса нет в базе». Если поле пустое, агент зовёт человека, когда клиент просит живого человека, недоволен, спрашивает о чём-то вне задач агента или агент не может помочь. Заполняете поле сами — впишите и случай «клиент просит позвать человека». Клиент получит короткое сообщение, бот пойдёт по выходу «менеджеру», а сотрудникам придёт уведомление «AI-агент передал разговор менеджеру» со ссылкой на диалог. Причина передачи — в переменной {%agent_summary%}.

#Интеграции

Интеграция — вебхук вашего сервиса (n8n, Make или свой сервер), который агент вызывает сам, когда нужно: проверить наличие товара, найти запись, создать заказ. Нажмите «Интеграция» вверху справа на холсте и заполните:

Sender отправит запрос POST с данными в формате JSON: ваши параметры придут в поле arguments. Сервис отвечает текстом или JSON вида {"result": "текст для агента"} — агент прочитает до 3 000 символов ответа. Сервис должен ответить за 15 секунд; за один ответ клиенту агент вызывает интеграции не больше 3 раз. Интеграций — до 8, параметров у каждой — до 10.

#Память и лимиты

Блок «Память и лимиты» бережёт бюджет:

Лимит исчерпан — бот идёт по выходу «ошибка или лимит». Тем, у кого включено уведомление «Ошибки AI-агентов» (по умолчанию — администраторам и владельцу), придёт сообщение — не чаще раза в час по одному агенту.

#Частые вопросы

Как сделать копию агента?

В шапке агента нажмите «⋯» → «Дублировать». Копия создаётся выключенной — включите её переключателем, когда настроите.

Агент не удаляется.

Агента, который стоит в ботах, удалить нельзя. Сначала уберите из этих ботов шаг «AI-агент» — список ботов виден под заголовком агента, в строке «В ботах».