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

Пользовательские переменные в Nextbot помогают сохранять важные данные в переменную и использовать их в логике агента, сценариях, функциях и интеграциях.

Функционал "Пользовательские переменные" находится в режиме альфа-теста и будет доступен в ближайшие дни.

Следите за обновлениями.

Пользовательские переменные — это значения, которые вы сами создаёте и храните в Nextbot для своей бизнес-логики. С их помощью агент может запоминать и использовать важные данные: имя клиента, номер заказа, телефон, ID ответственного сотрудника, сумму, статус, согласие, дату, время или JSON-объект с дополнительной информацией и многое-многое другое.

В отличие от системных данных, пользовательские переменные полностью настраиваются под ваши задачи. Вы сами определяете:

• что именно нужно хранить;

• какой у переменной будет тип;

• где она будет использоваться;

• как и когда её значение должно меняться.

Переменные помогают передавать контекст в работу агента и автоматизаций. Например, их можно подставлять в промпт, использовать в сценариях и функциях, передавать в отчёты администратору, отправлять во внешние системы через API или сохранять в CRM.

В Nextbot переменные бывают двух областей:

Переменные агента — общие для всего агента. Их можно изменять в Настройках агента. Переменные диалога — относятся только к конкретному диалогу. Их можно менять прямо в карточке нужного диалога.

Значение переменной можно задать сразу при создании, изменить вручную позже или обновлять автоматически через действие Управление переменными в сценариях и функциях.

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

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

Здесь вы можете:

• создать новую переменную;

• редактировать и удалять уже созданные переменные;

• менять текущее значение переменных области Агент;

• копировать переменные из другого агента.

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

Области переменных

Переменные агента

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

Такие переменные удобно использовать для общих данных, например:

• ID агента во внешней CRM;

• имя менеджера или название проекта;

• общие настройки для интеграции;

• стандартные JSON-данные, которые нужны всем диалогам.

Переменные диалога

Переменные области Диалог живут только внутри одного диалога и не влияют на остальные обращения.

Такие переменные удобно использовать для данных конкретного клиента, например:

• имя клиента;

• номер заказа;

• стоимость заказа;

• выбранная дата;

• JSON с данными текущей заявки.

Доступные типы переменных

В пользовательских переменных доступны следующие типы:

• строка;

• число;

• логическое значение;

• JSON;

• дата и время.

От типа переменной зависит, какие варианты изменения будут доступны в действии Управление переменными.

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

После создания пользовательские переменные можно использовать в разных частях Nextbot:

• добавить в системной промпте, например {{vars.dialog.ClientName}} или {{vars.agent.Unique_Agent_ID}}, чтобы ИИ-агент получил необходимый контекст;

• в отчётах администратору в действиях функций и сценариев;

• в Custom API и Python Script

• в сценариях и функциях через действие Управление переменными.

Что важно помнить

• У каждой переменной есть уникальный Ключ (имя переменной для системы). Внутри одного агента два одинаковых ключа создать нельзя.

• Если текущее значение пустое, система использует значение по умолчанию.

• При действии Очистить переменную значение переменной сбрасывается к значению по умолчанию.

• Для переменных области Диалог текущее значение меняется на странице конкретного диалога или через действие Управление переменными.

Подробнее

• Создание и редактирование переменных

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

• Управление переменными в функциях и сценариях