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

Видеоурок: Настройка Агента

Команда Nextbot подготовила видеоурок с обзором страницы Настроек Агента. **Посмотреть на YouTube:** \ **Посмотреть на Rutube:**

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

**В данном разделе разберем основные настройки вашего ИИ-агента. Они будут использованы во всех каналах связи и интеграций.** ## Имя агента Перейти к блоку «Имя агента»
Задайте ИИ-агенту понятное имя. Для ChatGPT оно никакой роли не играет, только для Вашего удобства. Это поле поддерживает как Кириллицу, так и Латинские буквы, специальные символы, цифры, но не принимает гиперссылки. ## Инструкция для ИИ-агента (Системный промпт) Перейти к блоку «Инструкция для ИИ-агента» Системный промпт является основой для всех последующих ответов ChatGPT и устанавливает первоначальный контекст для диалога. Он действует как 'инструкция' для ИИ, указывая на его роль, стиль общения и область знаний. Например, если ваш ИИ-агент— это виртуальный консультант по книгам, ваш промпт может быть таким: 'Ты эрудированный консультант в книжном магазине. Твоя задача — помогать посетителям подобрать книги по их интересам. Будь внимательным, предоставляй развернутые ответы и предлагай альтернативные варианты'. Этот текст задает тон взаимодействия и направляет ChatGPT, помогая гарантировать, что его ответы будут полезными, информативными и соответствующими заданной тематике. [Более подробно про Системный промпт](/functional/setting-up-agent/system-prompt.md) [Более подробно про Переменные в промпте](/functional/setting-up-agent/system-prompt/peremennye-v-prompte.md) ## Пользовательские переменные {% hint style="warning" %} Функционал "Пользовательские переменные" находится в режиме альфа-теста и будет доступен в ближайшие дни. Следите за обновлениями. {% endhint %} Пользовательские переменные позволяют сохранять свои данные прямо внутри Nextbot и затем использовать их в разных частях системы. Например: имя клиента, номер заказа, телефон, ID агента, JSON с данными заявки, дату или логический флаг.
У пользовательских переменных есть две области: * `Агент` — общие значения для всего агента; * `Диалог` — значения только для конкретного диалога. Такие переменные можно использовать в промпте, в действиях функций и сценариев, в `Custom API`, в `Python Script`, а также менять вручную или автоматически через действие **Управление переменными**. [Более подробно про Пользовательские переменные](/functional/setting-up-agent/polzovatelskie-peremennye.md) ## Температура Перейти к блоку «Температура»
Температура влияет на то, насколько разнообразными будут ответы вашего ИИ-агента. Если установить низкую температуру, агент будет давать более предсказуемые и осторожные ответы. При высокой температуре он будет генерировать более интересные и креативные идеи. Настройте этот параметр, чтобы достичь оптимального сочетания точности и оригинальности в ответах вашего агента. **Для чего использовать:** Этот параметр поможет вам настроить стиль общения вашего агента в зависимости от ваших нужд: если вам нужны четкие и точные ответы, установите низкую температуру, а если хотите получить креативные идеи или неожиданные решения — выберите высокую температуру. Чаще всего для бизнеса нужно довольно строгое выполнение инструкции, а высокая температура часто дает слишком большое поле для отхода от инструкции. С другой стороны при совсем низкой температуре ответы становятся слишком сухими, как будто это говорит робот, а слишком строгое следование инструкции приводит к тому что бот начинает буквально каждый вопрос возвращать обратно к инструкции. Постарайтесь найти значение нужное вам. #### [Более подробно о Температуре и как ее настроить](/functional/setting-up-agent/temperatura.md) ## Оптимизация истории диалога Перейти к блоку «Оптимизация истории диалога»
\ Включение опции "**Оптимизация истории диалога**" помогает лучше управлять длиной ваших разговоров с ChatGPT и регулировать их сохранение в контексте: Параметр "**Ограничение по количеству сообщений**" определяет, сколько последних сообщений будет сохраняться в памяти. Если количество сообщений превышает этот лимит, старые сообщения автоматически удаляются. Это снижает нагрузку на память и ускоряет обработку ваших запросов, при этом сохраняя качество и актуальность ответов. Параметр "**Ограничение по токенам**" ограничивает максимальное количество сообщений, сохраняемых в контексте. Полезно, если вы хотите контролировать объем истории независимо от размера сообщений. Параметр "**Ограничение по времени**" позволяет учитывать только сообщения, отправленные в течение указанного временного интервала. Особенно полезно для длительных диалогов, когда важно учитывать только недавние сообщения. Эти настройки нужны для длительных разговоров, так как они помогают экономить токены и предотвращает ошибки, которые могут возникнуть из-за большого объема сообщений. Не забывайте, что системный промпт и вложения тоже используют токены при запросе. Вот как выглядит диалог, если настройка "**Ограничение по количеству сообщений**" установлены на самый минимум:
[Более подробно о лимитах и как это использовать.](#optimizaciya-istorii-dialoga) ## Контроль вмешательства оператора Перейти к блоку «Контроль вмешательства оператора»
Управление этой настройкой позволяет автоматически приостанавливать работу ИИ-агента, когда к диалогу подключается оператор. Это помогает избежать путаницы в ответах и делает общение более логичным. Активируйте эту настройку, например, если готовите рассылки для пользователей. Вы также можете установить время, через которое диалог автоматически возобновится после последней паузы. Эта настройка будет действовать для всех диалогов, которые были приостановлены, как с помощью функций, так и вручную. Преимущества использования данной опции: 1. Автоматическая пауза предотвращает наложение ответов агента и оператора, что делает общение более четким. 2. Оператор может легко вмешиваться в разговор, не беспокоясь о том, что агент продолжит отвечать. 3. Установка интервала времени позволяет диалогу автоматически продолжаться, что экономит время и усилия. 4. Настройка работает для всех диалогов, что упрощает управление взаимодействием в разных ситуациях. При включении опции "**Игнорировать первое сообщение в диалоге**" первое сообщение оператора в диалоге не будет вызывать паузу в работе агента. Полезно для рассылок. А если добавить слова или фразы в "**Исключения**", ИИ-агент не будет вставать на паузу, если сообщение от оператора содержит любую из указанных фраз (достаточно частичного совпадения). Например, фраза ‘продолжай’ будет срабатывать в сообщениях вроде ‘продолжай диалог’ или ‘пожалуйста, продолжай’. #### [Более подробно об Управлении активностью агента](/functional/setting-up-agent/upravlenie-aktivnostyu-agenta.md) ## Управление диалогом по ключевым фразам Перейти к блоку «Управление диалогом по ключевым фразам»
При включенной опции "**Останавливать диалог по ключевым фразам**" Агент остановит диалог, если сообщение оператора содержит любую из указанных фраз (достаточно частичного совпадения). Например, фраза со скриншота «старший администратор» сработает в сообщениях вроде «на этот вопрос ответит старший администратор». Опция "**Возобновлять диалог по ключевым фразам"** возобновит диалог, если сообщение оператора содержит любую из указанных фраз (достаточно частичного совпадения). Например, фраза «продолжай» сработает в сообщениях вроде «продолжай диалог» или «пожалуйста, продолжай». ## Выбор языковой модели Перейти к блоку «Выбор языковой модели»
Выбор языковой модели — это возможность подобрать для вашего ИИ-агента наиболее подходящий «мозг» из нескольких доступных вариантов. Представьте, что это как выбрать двигатель для автомобиля: можно взять экономичный для городских поездок или мощный, быстрый, но сильно потребляющий топливо (боткоины) для гоночных трасс. **Зачем это нужно?** Каждая модель имеет свой баланс между скоростью, стоимостью работы и интеллектуальной мощностью. Более простые и старые модели отлично справляются с частыми, но стандартными вопросами, экономя ваши деньги. А новые и мощные модели способны решать сложные задачи, "рассуждать" и проявлять креативность, что критически важно для нестандартных и важных диалогов с вашими клиентами. Выбирайте модель исходя из ваших требований. Выбрав любую из списка, вы можете прочитать её описание и короткую характеристику в поле "Информация о модели".\ Не забудьте также выбрать "Уровень рассуждений" и "Подробность ответа" — у некоторых моделей эти гибкие настройки. ## Буфер сообщений Перейти к блоку «Буфер сообщений»
Функция "Буфер сообщений" добавляет паузу заданной длины между отправкой сообщения пользователем и получением ответа от ИИ-агента Это нужно для тех клиентов, которые ведут переписку, отправляя по несколько сообщений за раз, разбивая свой текст по частям.\ После того, как клиент отправит своё **последнее** сообщение, запустится таймер (настройка: время ожидания), по окончании которого все сообщения будут отправлены в GPT. Таким образом ИИ-агент ответит сразу на ВСЕ сообщения клиента одним ответом, а не по одному. Это помогает сэкономить ресурсы и сделать структуру ответов более естественной. Пример диалога с Буфером сообщений:
Преимущество очевидное: Пользователи отправляют короткие сообщения, а ИИ-агент собирает их и выдает одним ответом без путаницы, экономя токены. #### [Более подробно о Буфере сообщений](/functional/setting-up-agent/bufer-soobshenii.md) ## Деление сообщений Перейти к блоку «Деление сообщений»
**Деление сообщений** — это функция, которая позволяет разбивать ответы ИИ-агента на несколько частей и отправлять их поэтапно с небольшой задержкой, чтобы общение выглядело натуральнее, будто сообщение пишет настоящий менеджер. #### Как это работает * Клиент пишет сообщение ИИ-агенту * Если ответ ИИ-агента попадает под одно из **правил деления**, система автоматически разделит его на несколько частей и пришлёт по очереди * Между отправкой частей применяется задержка (настраиваемая), чтобы сообщения выглядели естественно. Подробнее про Деление сообщений можно прочитать в той статье: [Деление сообщений](/functional/setting-up-agent/delenie-soobshenii.md) ## Лимиты Перейти к блоку «Лимит расходов»
Блок "Лимиты" позволяет ограничить расход токенов на ИИ-агента, на одного пользователя или на то и другое, а так же ограничить количество вызовов функции. Настройте лимиты, выставив определённое количество Боткоинов, и, если пользователь или Агент потратят их в течение дня, чат автоматически переключится в режим "Пауза", а пользователь получит соответствующее сообщение, которое можно редактировать. Ближайшей ночью лимит снова сбросится и агент станет доступен для общения. **Для чего нужна опция:** 1. При спам-атаке на вашего агента со множества аккаунтов. 2. У вас ограниченный бюджет на нейросеть. Подробнее про лимиты расходов и лимиты вызовов функций можно прочитать в этих статьях:\ \ [**Лимит расходов на агента**](/functional/setting-up-agent/limit-rashodov-na-agenta.md)\ [**Лимит расходов на пользователя**](/functional/setting-up-agent/limit-rashodov-na-polzovatelya.md)\ [**Лимит вызовов функции**](/functional/setting-up-agent/limit-vyzovov-funkcii.md) ## Форматирование текста Перейти к блоку «Форматирование текста»
Если вы выключите форматирование текста, ответ будет отображаться в формате Markdown в Telegram. Подробности в [статье](/functional/setting-up-agent/formatirovanie-teksta.-markdown.md)
{% hint style="info" %} **В других мессенджерах это не работает, поэтому ответ будет просто обычным текстом без каких-либо выделений.** {% endhint %} В остальных мессенджерах будет просто обычным текстом как на скрине ниже:
## Дата и время Перейти к блоку «Дата и время»
Все функции GPT будут учитывать ваш часовой пояс. При желании, GPT сможет получать текущую дату, день недели и время. Эта функция особенно полезна, если вам нужно, например, записать что-то с учетом времени, планировать встречи, напоминания или любые другие действия, которые зависят от времени. Вы сможете получать более точные и актуальные ответы, учитывающие ваше местное время. При этом можно изменить часовой пояс нажав на соответствующее поле, откроется список с часовыми поясами Очень удобно, если вы планируете работу ИИ-агента для другого часового пояса. ## Расписание работы агента Перейти к блоку «Расписание работы агента»

ИИ-агент будет отвечать с ПН по ПТ с 8ч до 20ч

Включите расписание и выберите день недели и время, когда ИИ-агент будет отвечать пользователю. **Если расписание не включено, ИИ-агент будет отвечать в любое время.** Для чего это использовать: Эта функция поможет вам установить определенные дни и часы, когда ИИ-агент будет доступен для ответов. Это удобно, если вы хотите, чтобы пользователи знали, когда могут ожидать ответ, и чтобы избежать ответов в нерабочее время. При таких настройках, как на скриншоте выше, ИИ-агент будет отвечать с ПН по ПТ с 8ч до 20ч. ## Работа с файлами ### Голосовые сообщения Перейти к блоку «Голосовые сообщения»
Данный функционал позволяет гибко настраивать ИИ-агента при работе с голосовыми сообщениями. **Реакция агента на получение аудиофайлов:** Тут вы выбираете — **обрабатывать** ли ИИ-агенту входящее голосовое сообщение от клиента и сгенерировать на него ответ, либо **не обрабатывать** и отправить заранее заготовленное сообщение (например, "извините, я не могу прослушать это аудиосообщение") **Модель распознавания**. Whisper, Deepgram или ElevenLabs — это технологии, которые помогают распознавать речь. * **Whisper**: Поддерживает множество языков и акцентов, а также хорошо работает с повседневной речью и в шумной обстановке. * **Deepgram**: Оптимизирован для работы с большими объемами данных, ориентирован на скорость и эффективность, язык нужно выбирать вручную. * **ElevenLabs:** Создает самый реалистичный и выразительный синтез речи, ориентирован на качество и естественность звучания, но потребует интеграции с ElevenLabs **Голосовой ответ.** Возможность ИИ-агента синтезировать речь и отвечать пользователю голосовым сообщением, но необходима интеграция с ElevenLabs. Для большей информации перейдите на страницу "Интеграции" в документации. Примеры использования без голосового ответа (без интеграции с ElevenLabs). **Вариант 1:** Реакция агента на получение аудиофайлов: Отвечать стандартным сообщением => Голосовой ответ: Никогда. При данной настройке, если пользователь отправит голосовое сообщение, то ИИ-агент ответит текстовым сообщением, которые вы указали во вкладке "Прочие файлы", например "Мне не удобно прослушивать, отправьте текстом", или любое другое сообщение исходя из вашего проекта. **Вариант 2:** Реакция агента на получение аудиофайлов: Распознавать голос => Голосовой ответ: Никогда. При данной настройке, если пользователь отправит голосовое сообщение, то ИИ-агент сможет распознавать голосовое сообщение и ответить текстовым сообщением. ### Изображения Перейти к блоку «Изображения»
Данный функционал позволяет включать или отключать распознавание изображения ИИ-агентом. Если включить опцию "**Отвечать стандартным сообщением**", то при получении изображения оно не будет отправлено в GPT для формирования ответа, а будет отправляться стандартное сообщение, которое вы можете настроить, например, "прошу прощения, но я не могу загрузить это изображение". Если включить опцию "Распознавать изображения", то ИИ-агент принимает и распознает изображения. Поддерживаемые форматы jpg, jpeg, png, gif, webp, bmp. {% hint style="info" %} Распознавание происходит на стороне OpenAI. Botcoin будут сняты в зависимости от расходов токенов (если у вас введен свой ключ OpenAI, то цена будет как за обычный запрос). {% endhint %} **Отправлять изображения в мессенджер из ссылок в сообщении** — если эта опция включена, ИИ-агент будет отправлять изображения в мессенджер из ссылок на изображения, если они присутствуют в сообщении. **Удалять ссылки из сообщения ИИ-агента** — при активировании этой опции ссылки на изображения будут удалены из сообщения (учтите это в промпте ИИ-агента). ### Документы Перейти к блоку «Документы»
Блок "документы" позволяет настраивать работу и обработку документов ИИ-агентом. **На данный момент поддерживается только PDF**. Если вы хотите, чтобы ИИ-агент обрабатывал PDF-файлы и отвечал на них, выберите опцию "**Распознавать документ**".\ \ Включите "**Отвечать стандартным сообщением**" и заполните стандартное сообщение, чтобы ИИ-агент не обрабатывал документы и отправлял заготовленный текст пользователю — например, "извините, я не не могу скачать ваш PDF-файл. Пожалуйста, напишите текстом".\ \ **Отправлять документы в мессенджер из ссылок в сообщении (в Telegram, WhatsApp и VK)** — если эта опция включена, ИИ-агент будет самостоятельно отправлять документы в мессенджер по ссылкам на файлы, если они присутствуют в сообщении (учтите это в промпте ИИ-агента). Агент может отправлять PDF в чат в виде документа **только если вы дали ему прямую ссылку на PDF-файл**, то есть такую, которая ведёт непосредственно на сам файл (например, `https://site.com/file.pdf`).\ Ссылки на сторонние хранилища вроде **Google Диска, Яндекс Диска, Dropbox и других** не подходят, так как они открывают веб-страницу, а не сам PDF-документ. В таких случаях агент **всё равно отправит ссылку**, но **файл не будет прикреплён к сообщению**. Если вы хотите, чтобы документ корректно отображался как вложение, разместите его по прямой ссылке на своём сайте или другом источнике, где адрес оканчивается на `.pdf` и открывается стандартный просмотрщик PDF, а не страницу с предпросмотром или кнопкой скачивания. **Удалять ссылки из сообщения ИИ-агента** — при активировании этой опции ссылки на документы будут удалены из сообщения (учтите это в промпте ИИ-агента). ### Файлы Перейти к блоку «Файлы»
Этот блок регулирует, будет ли ИИ-агент отвечать стандартным сообщением в том случае, когда пользователь отправляет любой неподдерживаемый файл (например, видео, Excel и др.). Вы можете заполнить стандартное сообщение, например "извините, я не могу распознать формат этого файла" или просто оставить опцию на "**Ничего не делать**" — тогда Агент просто промолчит. ## Отложенная отправка Перейти к блоку «Отложенная отправка»
Очередь задач для отложенной отправки — это функционал, который позволяет отправить напоминание, если пользователь не ответил на последнее сообщение. Напоминание будет отправлено через заданный вами промежуток времени. **Для чего это использовать:** Эта функция полезна, чтобы не забыть напомнить о чем-то важном, если собеседник/пользователь не отреагировал на сообщение ИИ-агента. Например, вы можете использовать её для контроля сроков, "дожима" пользователя к определенным действиям, отправки напоминаний о встречах или важных событиях. \- Одна отправка за диалог: Напоминание будет отправлено только один раз в течение диалога/разговора, если пользователь не ответил на сообщение ИИ-агента, и это произойдет через указанный вами промежуток времени. \- Множество отправок за диалог: Напоминание будет отправляться каждый раз, когда пользователь не ответит на сообщение ИИ-агента, с интервалом, который вы указали. Блок **Расписание** позволяет настраивать "рабочие" часы, в течение которых ИИ-агент будет отправлять отложенные сообщения. Или же отключать(откладывать) их, если их отправка попадает на нерабочее время. Отложенная отправка сообщений - это ваш инструмент для "дожима" пользователя и возврата его в диалог, который позволяет вам заранее подготовить и запланировать отправку сообщений, чтобы они пришли в нужное время. Подробнее про все настройки **Отложенных сообщений** вы можете посмотреть в статье: #### [Отложенные сообщения](/functional/setting-up-agent/otlozhennaya-otpravka.md) {% hint style="info" %} Отложенная отправка не работает в разделе **Тестовый чат**, а также через канал **Чат на сайт** {% endhint %} ## Сообщение об ошибке Перейти к блоку «Сообщение об ошибке»
Не забывайте заполнить **Сообщение об ошибке** — оно будет отправлено пользователю в случае, если произошла какая-то неполадка, например, ошибка на стороне сервера Chat GPT. ## Свой API-key Перейти к блоку «Свой GPT API-key»
Поле **свой API-key** позволяет вам по желанию добавить свои API-ключи и использовать их для работы сервиса Nextbot вместо встроенных.\ Таким образом, каждый запрос будет стоить 0.01 BotCoin. На данный момент поддерживаются ключи от провайдеров OpenAI и Anthropic.\ \ **Как добавить:**\ Нажмите кнопку ДОБАВИТЬ КЛЮЧ, выберите провайдера, введите ключ и нажмите СОХРАНИТЬ после проверки.\ \ Обратите внимание: **вводить свой ключ не обязательно** — вы можете оставить это поле пустым и пользоваться сервисом по умолчанию. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.nextbot.ru/functional/setting-up-agent.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.