Переменные проекта

Переменные помогают настраивать приложение без хранения приватных значений в коде. В обычном интерфейсе Agnostic показывает только безопасное описание.

• Нужно передать приложению настройку, которая отличается между средами.
• Нужно проверить, какие безопасные переменные уже заведены в проекте.
• Нужно обновить переменную окружения перед новой публикацией backend-сервиса.

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

1. Откройте проект и выберите нужную среду в верхнем переключателе.
2. В левом меню откройте «Переменные» или нажмите «Переменные» в разделе «Подключения».
3. Нажмите Добавить переменную.
4. Введите ключ переменной и значение в защищённом поле. Ключ может содержать буквы, цифры и _; первый символ — буква или _.
5. Сохраните переменную.
6. Опубликуйте backend-сервис, если переменная должна попасть в новую рабочую конфигурацию.

Найти переменную можно через Найти по ключу. Рядом выберите Сначала изменённые или По алфавиту. Действие Скопировать ключ копирует только название переменной, без значения.

Чтобы изменить ключ или значение, нажмите Изменить в строке. Сохранённое значение не подставляется: введите новое. При переименовании обновите обращения к ключу в приложении. Если новый ключ сохранился, но старый не удалился, форма сообщит об этом; Повторить сохранение завершит переименование.

Чтобы убрать переменную, нажмите Удалить и подтвердите действие в окне с указанным окружением. Проверьте, что приложение больше не использует этот ключ. При ошибке сохранения или удаления окно остаётся открытым и предлагает повторить действие. Закрытие формы с введёнными изменениями запрашивает подтверждение: можно продолжить редактирование или не сохранять черновик.

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

В разделе Переменные будет видно имя и время обновления. Значение переменной не показывается в обычном списке.

Переменные общие для выбранной среды проекта. Если в этой среде несколько backend-сервисов, они получают один и тот же набор переменных при публикации. Runtime SDK не нужен для чтения этих значений: SDK использует собственный служебный контекст для работы с данными, событиями и другими возможностями платформы.

Приватные значения должны оставаться на backend-сервисе.

Если нативные переменные включены для вашего окружения, откройте Проекты → проект → окружение → Переменные. Тот же раздел доступен из Подключений. Список показывает ключ и время изменения; Копировать ключ копирует только ключ. Поиск и переключатель Сначала изменённые недавно помогают найти запись.

Добавить переменную и Изменить открывают защищённую форму. Ключ начинается с латинской буквы или _, содержит латинские буквы, цифры и _, максимум 128 символов. Значение до 64 КиБ вводится заново; сохранённое значение не подставляется. При обычной ошибке текущий ввод остаётся только в открытой форме. Закрытие с подтверждением, уход в фон и выход из аккаунта очищают значение.

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

Удалить требует подтверждения с ключом и окружением. Роль только для просмотра позволяет копировать ключи; защищённых форм изменений нет. Сохранение переменной не публикует и не перезапускает сервис автоматически.