---
read_when:
    - Налаштування типових значень режиму elevated, allowlist або поведінки slash-команд
    - Розуміння того, як sandboxed-агенти можуть отримувати доступ до хоста
summary: 'Режим elevated exec: запуск команд поза sandbox із sandboxed-агента'
title: Режим Elevated
x-i18n:
    generated_at: "2026-04-05T18:19:18Z"
    model: gpt-5.4
    provider: openai
    source_hash: f6f0ca0a7c03c94554a70fee775aa92085f15015850c3abaa2c1c46ced9d3c2e
    source_path: tools/elevated.md
    workflow: 15
---

# Режим Elevated

Коли агент працює всередині sandbox, його команди `exec` обмежені
середовищем sandbox. **Режим elevated** дозволяє агенту вийти за межі sandbox і натомість запускати команди
поза sandbox, із налаштовуваними етапами погодження.

<Info>
  Режим elevated змінює поведінку лише тоді, коли агент **sandboxed**. Для
  агентів без sandbox `exec` і так уже виконується на хості.
</Info>

## Директиви

Керуйте режимом elevated для кожної сесії за допомогою slash-команд:

| Directive        | What it does                                                              |
| ---------------- | ------------------------------------------------------------------------- |
| `/elevated on`   | Запускати поза sandbox на налаштованому шляху хоста, зберігаючи погодження |
| `/elevated ask`  | Те саме, що й `on` (псевдонім)                                            |
| `/elevated full` | Запускати поза sandbox на налаштованому шляху хоста та пропускати погодження |
| `/elevated off`  | Повернутися до виконання, обмеженого sandbox                              |

Також доступно як `/elev on|off|ask|full`.

Надішліть `/elevated` без аргументу, щоб побачити поточний рівень.

## Як це працює

<Steps>
  <Step title="Перевірка доступності">
    Elevated має бути ввімкнено в config, а відправник має бути в allowlist:

    ```json5
    {
      tools: {
        elevated: {
          enabled: true,
          allowFrom: {
            discord: ["user-id-123"],
            whatsapp: ["+15555550123"],
          },
        },
      },
    }
    ```

  </Step>

  <Step title="Установіть рівень">
    Надішліть повідомлення лише з директивою, щоб установити типове значення для сесії:

    ```
    /elevated full
    ```

    Або використайте вбудовано в повідомлення (застосовується лише до цього повідомлення):

    ```
    /elevated on run the deployment script
    ```

  </Step>

  <Step title="Команди запускаються поза sandbox">
    Коли elevated активний, виклики `exec` залишають sandbox. Ефективний хост типово —
    `gateway`, або `node`, коли налаштована/сеансна ціль exec дорівнює
    `node`. У режимі `full` погодження exec пропускаються. У режимах `on`/`ask`
    налаштовані правила погодження все ще застосовуються.
  </Step>
</Steps>

## Порядок визначення

1. **Вбудована директива** в повідомленні (застосовується лише до цього повідомлення)
2. **Перевизначення сесії** (установлюється надсиланням повідомлення лише з директивою)
3. **Глобальне типове значення** (`agents.defaults.elevatedDefault` у config)

## Доступність і allowlist

- **Глобальний бар’єр**: `tools.elevated.enabled` (має бути `true`)
- **Allowlist відправника**: `tools.elevated.allowFrom` зі списками для кожного каналу
- **Бар’єр для окремого агента**: `agents.list[].tools.elevated.enabled` (може лише додатково обмежувати)
- **Allowlist для окремого агента**: `agents.list[].tools.elevated.allowFrom` (відправник має відповідати і глобальному, і агентському списку)
- **Запасний варіант для Discord**: якщо `tools.elevated.allowFrom.discord` пропущено, як запасний варіант використовується `channels.discord.allowFrom`
- **Усі бар’єри мають пройти**; інакше elevated вважається недоступним

Формати записів allowlist:

| Prefix                  | Matches                         |
| ----------------------- | ------------------------------- |
| (none)                  | ID відправника, E.164 або поле From |
| `name:`                 | Ім’я відображення відправника   |
| `username:`             | Ім’я користувача відправника    |
| `tag:`                  | Тег відправника                 |
| `id:`, `from:`, `e164:` | Явне націлення на ідентичність  |

## Чим elevated не керує

- **Політика інструментів**: якщо `exec` заборонено політикою інструментів, elevated не може це перевизначити
- **Політика вибору хоста**: elevated не перетворює `auto` на вільне перевизначення між хостами. Він використовує правила цілі exec, налаштовані в config/сесії, вибираючи `node` лише тоді, коли ціллю вже є `node`.
- **Окремо від `/exec`**: директива `/exec` налаштовує типові значення exec для сесії для авторизованих відправників і не потребує режиму elevated

## Пов’язане

- [Інструмент Exec](/tools/exec) — виконання shell-команд
- [Погодження Exec](/tools/exec-approvals) — система погоджень і allowlist
- [Sandboxing](/uk/gateway/sandboxing) — налаштування sandbox
- [Sandbox vs Tool Policy vs Elevated](/uk/gateway/sandbox-vs-tool-policy-vs-elevated)
