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

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

Следите за обновлениями.
{% endhint %}

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

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

* что именно нужно хранить;
* какой у переменной будет тип;
* где она будет использоваться;
* как и когда её значение должно меняться.

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

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

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

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

<figure><img src="/files/UVjUaKpYmXWopbzPjrLb" alt=""><figcaption></figcaption></figure>

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

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

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

* создать новую переменную;
* редактировать и удалять уже созданные переменные;
* менять текущее значение переменных области `Агент`;
* копировать переменные из другого агента.

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

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

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

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

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

* ID агента во внешней CRM;
* имя менеджера или название проекта;
* общие настройки для интеграции;
* стандартные JSON-данные, которые нужны всем диалогам.

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

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

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

* имя клиента;
* номер заказа;
* стоимость заказа;
* выбранная дата;
* JSON с данными текущей заявки.

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

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

* строка;
* число;
* логическое значение;
* JSON;
* дата и время.

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

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

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

* добавить в системной промпте, например `{{vars.dialog.ClientName}}` или `{{vars.agent.Unique_Agent_ID}}`, чтобы ИИ-агент получил необходимый контекст;
* в отчётах администратору в действиях функций и сценариев;
* в `Custom API` и `Python Script`
* в сценариях и функциях через действие `Управление переменными`.

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

* У каждой переменной есть уникальный `Ключ` (имя переменной для системы). Внутри одного агента два одинаковых ключа создать нельзя.
* Если текущее значение пустое, система использует значение по умолчанию.
* При действии `Очистить переменную` значение переменной сбрасывается к значению по умолчанию.
* Для переменных области `Диалог` текущее значение меняется на странице конкретного диалога или через действие `Управление переменными`.

## Подробнее

* [Создание и редактирование переменных](/functional/setting-up-agent/polzovatelskie-peremennye/sozdanie-i-redaktirovanie-peremennykh.md)
* [Переменные в промпте](/functional/setting-up-agent/system-prompt/peremennye-v-prompte.md)
* [Управление переменными в функциях и сценариях](/functional/setting-up-agent/polzovatelskie-peremennye/upravlenie-peremennymi-v-funkciyakh-i-scenariyakh.md)


---

# 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/polzovatelskie-peremennye.md?ask=<question>
```

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.