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

> Перед прочтением мы рекомендуем ознакомиться со статьями [Переменные](/sozdanie-scenariev/peremennye.md) и [Специальные переменные](/sozdanie-scenariev/peremennye/specialnye-peremennye.md)

## Создание переменной

Создать переменную можно в разделе **"переменные"** или в шаге **"установить переменную"**.

Перейдите в раздел "переменные" и нажмите кнопку **"добавить переменную":**

![](/files/-M0iOjRiPnEe5jAmDTau)

Откроется окошко создания переменной. Вам необходимо указать **ключ переменной**, ее **тип**, **начальное значение** и **формат** (локальная или глобальная)

![](/files/-M0iPYlL64gSZG_voZ8i)

На картинке выше мы создали переменную **%баллы%**, которая является числом, начальное значение равно 0 и она не может быть меньше 0 (минимальное значение 0).

Такую переменную можно использовать, например, для накопления баллов участниками группы за разные действия (ответы на комментарии, прохождение квестов в ЛС с ботом и тд) :wink: 

## Локальные переменные

{% hint style="info" %}
**Локальные переменные** хранят свое значение для конкретного пользователя и меняются для него. Одна и та же локальная переменная может иметь разные значения у разных пользователей.
{% endhint %}

В примере выше мы создали переменную %баллы% и сделали ее локальной. Это значит, что ее значение зависит от пользователя, который общается с ботом. Например:

![](/files/-M0iQuD4xxHuIraOBNM5)

![Пример использования локальной переменной](/files/-M0iR0NpQJRH4icKWzOu)

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

Изменять локальные переменные можно с помощью шага "установить переменную" или в разделе "пользователи".

## Глобальные переменные

{% hint style="info" %}
**Глобальные переменные** хранят одинаковое значение для всех пользователей
{% endhint %}

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

Например, вы создали глобальную  переменную %количество\_заявок% и хотите сохранять в ней количество пользователей, которые оставили заявку на ваш товар. В таком случае в конце сценария-цепочки ([Цепочка диалога](/sozdanie-scenariev/cepochka-dialoga.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://docs.smartbot-vk.ru/sozdanie-scenariev/peremennye/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.