Переменные в промпте

Переменные позволяют передавать динамические данные в промпт ИИ-агента. В Nextbot можно использовать как системные переменные вида {{system_data_*}}, так и пользовательские переменные вида {{vars.dialog.KEY}} и {{vars.agent.KEY}}.

Например, в промпт можно передавать имя и телефон клиента, данные по объявлению Avito Pro, значения из пользовательских переменных агента и диалога, а также другие данные из подключенных интеграций. При необходимости через эту кнопку также можно добавить ссылки на файлы из Облака.

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

Допустим, клиент пишет из WhatsApp. Добавьте в ваш промпт вот такую инструкцию: Номер телефона клиента: {{system_data_phone_number_whatsapp}} Имя клиента в мессенджере: {{system_data_user_name}}

В значения, находящиеся в фигурных скобках будут вставлены динамические переменные — номер телефона клиента и его имя в мессенджере. Теперь ИИ-агент с самого начала диалога будет держать в памяти имя клиента и с какого номера он пишет. Аналогично, если клиент пишет с Avito, можно добавить переменные объявления: название объявления, цену, адрес места продажи. Это поможет ИИ-агенту получить информацию о каком объявлении ведётся речь и выдавать точные ответы и консультации.

Обратите внимание: Переменные YClients и Altegio (услуги, специалисты) добавляются в промпт автоматически — просто включите опции "Автоматически загружать специалистов" и "Автоматически загружать услуги" в настройках интеграции и создайте функции через Мастер создания функций — переменные будут добавлены автоматически.

Добавление переменных в промпт

1. Откройте блок Системный промпт Перейдите во вкладку Настройка агента → блок Системный промпт → нажмите кнопку Переменные (справа вверху).

2. Выберите нужную переменную Откроется список доступных переменных. Здесь могут быть как системные переменные, так и пользовательские переменные агента и диалога. Выберите нужную (например, Avito Pro — название объявления или Имя Клиента). ⚠️ Убедитесь, что соответствующая интеграция уже подключена.

3. Переменная добавится в промпт В системный промпт автоматически вставится код в формате {{system_data_avito_title}}, {{vars.dialog.ClientName}} или {{vars.agent.Unique_Agent_ID}} — в зависимости от выбранной переменной.

4. Оформите переменную как инструкцию Не оставляйте переменную без контекста! Добавьте пояснение для ИИ-агента:

   Клиент обращается по объявлению: {{system_data_avito_title}}

1. Протестируйте работу Проверьте в тестовом диалоге: напишите из Avito и спросите агента, по какому объявлению вы обращаетесь. Он должен назвать правильное название из переменной.

Важно: Не изменяйте текст внутри {{...}} и сами скобки — это нарушит работу переменных!

Пользовательские переменные в промпте

Пользовательские переменные создаются вами в блоке Пользовательские переменные на странице Настройка Агента.

Для них используются два формата:

• {{vars.dialog.KEY}} — переменная области Диалог;

• {{vars.agent.KEY}} — переменная области Агент.

Например:

Обращайся к клиенту по имени, если оно уже известно.
Имя клиента: {{vars.dialog.ClientName}}

Для служебной интеграции используй ID агента: {{vars.agent.Unique_Agent_ID}}

Если текущее значение переменной ещё не задано, будет использоваться значение по умолчанию.

Подробнее о создании и использовании таких переменных читайте в разделе Пользовательские переменные.

Где посмотреть переменные диалога

Если вы используете в промпте переменные области Диалог, их текущее значение можно посмотреть и при необходимости изменить вручную на странице конкретного диалога.

Для этого:

1. Откройте нужный диалог.

2. Нажмите кнопку Метаданные диалога в правом верхнем углу.

3. В боковой панели найдите блок Переменные диалога.

4. При необходимости нажмите на иконку редактирования рядом с нужной переменной.

Это удобно, если вы хотите проверить, какое значение реально будет подставлено в конструкцию вида {{vars.dialog.ClientName}}.

Подробнее про страницу диалога читайте в статье Диалоги.

Пример использования переменных для Avito Pro

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

Как настроить в промпте:

Когда клиент спросит о наличии, подтверди: "{{Avito Pro — название объявления}} есть в наличии за {{Avito Pro — цены объявления}}. Забрать можно по адресу: {{Avito Pro — адрес объявления}}."

Что получает клиент:

Представим, человек пишет по объявлению о продаже велосипеда. ИИ-агент ответит:

Здравствуйте! Да, Горный велосипед Stels есть в наличии, цена — 15 000 руб. Вы можете забрать его по адресу: ул. Ленина, д. 42. Когда вам удобно подъехать?

Результат:

Ответы ИИ становятся персонализированными, контекстными и точными. Клиент чувствует, что с ним общаются предметно, а не отписываются шаблонными фразами.

Список динамических переменных регулярно пополняется — следите за обновлениями.