Режимы применения: observe, shadow и enforce

Прежде чем правило заблокирует production-трафик, вы хотите знать, что оно срабатывает на правильных вещах и ни на чём лишнем. OrcaRouter даёт вам три позиции — observe, shadow и enforce — которые позволяют вам выкатываться постепенно, с видимостью на каждом шаге и без сюрпризов. На этой странице объясняется, что означает каждая позиция механически, как переходить между ними и как уровни автономии устанавливают всё это в один шаг.

​

1. Три позиции с первого взгляда

​

2. Позиция Observe — измеряйте перед написанием правил

Позиция observe — это не один переключатель. Это комбинация трёх независимых механизмов, которые вместе производят «разрешать всё, записывать всё»:

​

Observe mode firewall (настройка рабочего пространства)

Когда вызов инструмента разрешается в отсутствие политики вообще — нет привязки ключа и нет default’а рабочего пространства — workspace-level observe mode firewall определяет, что происходит:

• Observe mode включён: вызов разрешается и логируется как пробел в покрытии. Представление Discovered Tools наполняется из этих gap-событий, показывая именно какие инструменты запускают ваши агенты без покрывающего их правила.
• Observe mode выключен: вызов разрешается молча — побайтно идентично рабочему пространству, которое никогда не включало эту функцию.

Observe mode — поверхность детектирования пробелов. Она срабатывает только когда политика не разрешается. Это не то же самое, что наличие политики с audit.

​

Вердикт audit firewall (дефолт на уровне политики)

Когда политика разрешается, но ни одно правило не совпадает с вызовом инструмента, применяется default_verdict политики. Значение по умолчанию для default_verdict — audit — разрешить вызов и записать для разбора. Новая политика без правил и изменений конфигурации ничего не блокирует и ничего молча не пропускает: она аудирует всё, что видит. audit — это также обычный вердикт правила. Правило, которое совпадает и выдаёт audit, пропускает вызов и записывает его — аналог режима аудита guardrail для firewall.

​

Действие flag guardrail (действие правила)

На стороне guardrails действие flag — это эквивалент observe: правило срабатывает, совпадение записывается в ленту Matches, и запрос продолжается без изменений. Нет блокировки. Нет редактирования. Используйте flag, когда хотите измерить правило — посмотреть, как часто оно срабатывает и на чём — перед тем как принять block или mask.

---

Вместе эти три механизма производят позицию observe: observe mode перехватывает непокрытые вызовы инструментов; вердикты audit покрывают вызовы инструментов под политикой, но ещё не под конкретным правилом; действия flag покрывают проверки guardrail, которые вы ещё не готовы применять.

​

3. Позиция Shadow — валидируйте перед применением

Shadow mode — это флаг на уровне политики (shadow_mode: true) на политике firewall. Когда он включён:

• Политика оценивает каждый вызов инструмента ровно так, как в production — правила сопоставляются, вердикты вычисляются, предикаты аргументов тестируются.
• Каждый применяющий вердикт (deny, sanitize, pending_approval) понижается до audit до того, как он достигнет инструмента.
• Логируемая причина имеет префикс [shadow] would …, чтобы вы могли видеть в ленте событий, что именно было бы заблокировано, очищено или удержано.

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

​

4. Позиция Enforce — реальные вердикты, реальные последствия

В позиции enforce ничего не понижается:

• Firewall deny → агент видит ошибку инструмента (MCP) или HTTP 400 firewall_blocked (поверхность inbound). Ошибка называет инструмент и причину. Помечается skip-retry.
• Firewall sanitize → совпавшие подстроки редактируются из аргументов инструмента и очищенный вызов пересылается.
• Firewall pending_approval → вызов удерживается; агент получает HTTP 400 firewall_approval_pending и id подтверждения для опроса.
• Guardrail block → HTTP 400 guardrail_blocked с именем guardrail и правила, которое сработало. Квота не списывается.
• Guardrail mask → совпадение редактируется (например, jane@acme.com → [EMAIL]) и запрос продолжается с очищенным текстом.

Чтобы достичь позиции enforce: выключите shadow_mode на политике firewall и измените действия правил guardrail с flag на block или mask по мере необходимости.

​

5. Рекомендуемый порядок выкатывания

​

6. Уровни автономии — установите всё сразу

Тонкая настройка политик правило за правилом — точный путь. Уровни автономии — быстрый. Один элемент управления атомарно устанавливает позицию Firewall и Guardrails вашего рабочего пространства в одной транзакции с отменой в один клик: Применяйте через POST /api/workspace/firewall/autonomy (Developer+). Эндпоинт Simulate (GET /api/workspace/firewall/simulate?level=) предварительно просматривает изменение уровня до его применения.

​

7. Карта механизмов — какая настройка что контролирует

Эта таблица является авторитетным справочником. Четыре термина различны — не смешивайте их:

---

Режимы применения — не бинарное включено/выключено. Двигайтесь через observe → shadow → enforce, и ваши правила проверяются на реальном трафике прежде, чем они когда-либо его заблокируют.