Переменные и настройки
Раздел "Ключи и Переменные" позволяет централизованно управлять параметрами, которые используются вашими ботами и агентами. Здесь вы можете хранить API ключи, токены, конфигурационные данные и другие значения.
🔍 Что такое переменные
Переменные в Agent Lab — это именованные хранилища значений, которые могут быть: - Публичными - значения видны и доступны для редактирования. - Секретными - значения скрыты и отображаются как "••••••••••••" для обеспечения безопасности, используются для чувствительных данных (API ключи, пароли).
Преимущества использования переменных: - Централизованное управление: Все настройки в одном месте. - Безопасность: Защита конфиденциальных данных с помощью секретных переменных. - Гибкость: Быстрое изменение поведения ботов без редактирования их промптов или кода. - Многоразовость: Использование одних и тех же значений в разных ботах.
➕ Создание переменной
- Перейдите в раздел "Ключи и Переменные".
- Нажмите кнопку "Создать переменную" (иконка
+или соответствующая кнопка).
3. В открывшемся модальном окне заполните следующие поля:
- Ключ переменной: Уникальное имя для вашей переменной (например, telegram_bot_token, company_email). Рекомендуется использовать snake_case без пробелов.
- Описание: Краткое описание назначения переменной. Это поможет понять, для чего используется переменная.
- Значение: Само значение переменной (например, 123456:ABC...DEF, support@example.com).
- Группы / Теги: Вы можете добавить переменные в группы (например, telegram, api, auth) для лучшей организации и фильтрации. Начните вводить название группы и нажмите Enter или кнопку +.
- Пометить как секрет: Установите этот флажок, если значение переменной является конфиденциальным (например, API ключ). Секретные значения будут скрыты в интерфейсе.
4. Нажмите кнопку "Сохранить".
🛠️ Редактирование переменной
- В списке переменных найдите нужную и нажмите иконку карандаша (редактирование).
- В открывшемся модальном окне вы сможете изменить описание, значение и группы переменной. Ключ переменной изменить нельзя.
- Если переменная секретная, вы можете временно показать ее значение, нажав на иконку глаза рядом с полем значения. После редактирования значение снова будет скрыто.
- Нажмите кнопку "Сохранить" для применения изменений.
🗑️ Удаление переменной
- В списке переменных найдите нужную и нажмите иконку корзины (удаление).
- Подтвердите удаление во всплывающем окне.
Важно
Удаленная переменная не может быть восстановлена. Убедитесь, что она не используется активными ботами или flow.
🏷️ Группировка переменных
Для удобства работы с большим количеством переменных вы можете использовать группировку по тегам. Нажмите кнопку "Группировать по тегам", чтобы организовать переменные по их категориям (например, api, telegram, database). Вы можете переключать этот режим для более удобного просмотра.
⚙️ Использование переменных в ботах и агентах
В промптах или конфигурации ботов вы можете ссылаться на переменные, используя синтаксис @var:ключ_переменной. Например, если у вас есть переменная с ключом telegram_bot_token, вы можете использовать ее как @var:telegram_bot_token.
Это позволяет легко менять конфиденциальные данные (токены API) или общие настройки без необходимости редактировать промпт или конфигурацию каждого бота вручную. Например, если у вас несколько ботов используют один и тот же API ключ, вы можете сохранить его как переменную и просто ссылаться на нее в каждом боте. При изменении ключа, достаточно обновить значение переменной в одном месте.