Маскирование данных

Персональные данные и секреты заменяются псевдонимами до отправки модели и возвращаются в ответе.

Маскирование данных уменьшает объем персональных данных и секретов, которые получает провайдер модели. Роутер находит в запросе ФИО, email, телефоны, паспорта, ИНН и счета физлиц, СНИЛС, банковские карты, IP-адреса, ключи и токены и заменяет каждое значение псевдонимом вида [EMAIL_1]. Модель отвечает с псевдонимами, а роутер возвращает в ответ исходные значения — и в обычном ответе, и в стриме, и в аргументах вызовов инструментов.

Маскирование включает владелец или администратор пространства Router в кабинете, на странице «Защита данных». Код клиента менять не нужно.

Как это работает

Запрос приходит в роутер: «Ответьте Анне на anna@example.com».
Роутер заменяет значения: «Ответьте Анне на [EMAIL_1]». Одно значение получает один псевдоним, даже если записано по-разному.
Модель получает только псевдонимы и отвечает с ними. Чтобы модель не меняла псевдонимы, роутер добавляет в начало диалога короткую инструкцию (около 100 входных токенов, оплачиваются как обычные) — только если в запросе что-то замаскировано.
Роутер ставит значения на место и отдает ответ: «Готово, письмо для anna@example.com».

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

Категории

Категория	Что находит
ФИО	Полное ФИО на русском, фамилию с инициалами, имя с фамилией рядом со словами «ФИО», «клиент», «Уважаемый»
Email	Адреса электронной почты
Телефон	Российские номера с +7 или 8 и международные с кодом страны
Паспорт РФ	Серию и номер рядом со словами «паспорт», «серия»
ИНН физлица	12 цифр с верной контрольной суммой рядом со словом «ИНН»
СНИЛС	Номер с верной контрольной суммой
Счет физлица	20-значные счета физлиц (40817, 40820, 423, 40802)
Банковская карта	Номера карт Мир, Visa и Mastercard с верной контрольной суммой
IP-адрес	IPv4 и IPv6, кроме локальных адресов
Секреты и ключи	Ключи и токены облаков, LLM-провайдеров, Git-платформ, пароли в URL и в `.env`

Для отдельного ключа можно оставить только часть категорий, например «только секреты» для ключа кодового агента. Это делает тот, кто управляет всеми ключами пространства.

Файлы и картинки

Роутер не читает картинки, аудио и файлы. Пока маскирование включено, такие запросы по умолчанию не уходят в глобальные модели: если подходящей модели не осталось, роутер отвечает 400 с metadata.reason: "masking_files_blocked". В российские модели файлы уходят как обычно. Блокировку можно выключить на странице «Защита данных».

Стоимость

Пока маскирование включено, к стоимости каждого запроса добавляется надбавка. Ставка указана в кабинете на странице «Защита данных». Надбавка видна отдельной строкой в карточке вызова, в Статистике и в месячном отчете договорной оплаты. Цены в списке моделей указаны без нее.

Логи

В Логах фильтр «Чувствительные данные» показывает запросы, в которых маскирование что-то нашло: любые данные, только персональные данные, только секреты или одну категорию. Карточка вызова показывает, сколько значений каждой категории заменено. Журнал содержимого хранит запрос и ответ с псевдонимами.

Ошибки

Если маскирование не смогло выполниться, роутер не отправляет запрос модели и ничего не списывает: ответ 503 с metadata.reason: "guardrail_unavailable". Запрос можно повторить.

Ограничения

Поиск вероятностный: часть значений может остаться незамеченной.
Одиночные имена («Оля, привет»), иностранные имена и адреса пока не маскируются.
Значение возвращается в той форме, в которой было записано впервые. Склонения ФИО не исправляются.
Подписанные reasoning_details передаются без изменений.
Маскирование не делает данные обезличенными: пока у роутера есть соответствие псевдонимов и значений, данные остаются персональными. Оно уменьшает объем данных у провайдера модели, но не меняет их правовой статус и не снимает обязанностей оператора, в том числе по трансграничной передаче.