API ВЕГАВаши данные
не уходят в модель
Защитник стоит между вашим кодом и нейросетью. Он находит персональные данные в промптах и документах и меняет их на метки вида #PERSON_1#. За границу уходят только метки, поэтому вопрос о трансграничной передаче ПДн не возникает.
Вы написали
Меня зовут Филиппов Дмитрий Семенович, телефон +7 900 123-45-67. Ответьте на почту vlasov@example.ru
Вам вернулось
Меня зовут Филиппов Дмитрий Семенович, телефон +7 900 123-45-67. Ответьте на почту vlasov@example.ru
Метки заменились обратно по словарю диалога. Вы видите настоящие данные.
fail-closed: любая ошибка защиты блокирует запрос, данные в модель не попадают
Зачем это нужно
Запрос в зарубежную модель: передача текста за пределы вашего контура. Всё, что попало в промпт, попало и туда: в логи провайдера, в разбор инцидентов, в чужие руки. Защитник вычищает персональные данные из промпта до отправки, наружу уходят только метки. Поэтому вопрос об их трансграничной передаче не возникает вовсе.
Данные вычищены до отправки
В промпте после щита нет персональных данных. Юристам проще спать.
Логи провайдера бесполезны
Там лежат только заглушки. Читать их нечего.
Чистит за человека
Данные вставляют руками, копируют из писем, шлют в поддержку. Шлюз чистит всё равно.
Как это работает
Словарь «метка → значение» живёт в изолированном хранилище диалога около 2 часов. Сырые chatId и ключи туда не попадают, только их хеши.
шаг 1
Вы отправляете как обычно
Тот же код, тот же SDK, тот же ключ. Меняется только адрес: /guard/v1 вместо /v1. В чате на сайте вообще ничего менять не нужно.
шаг 2
Шлюз меняет данные на метки
Наш сервис находит персональные данные и подставляет заглушки: #PERSON_1#, #PHONE_NUMBER_1#. Один и тот же человек получает одну и ту же метку во всём диалоге, поэтому модель отвечает связно.
шаг 3
Ответ возвращается настоящий
Модель видит только метки. В ответе шлюз меняет их обратно по словарю диалога. Вы получаете готовый текст с реальными именами и номерами, даже в потоковом стриме.
Какие данные обезличиваются
Проверка идёт по строгим правилам и контрольным суммам: «заказ 1234567890» не станет ИНН, а «версия 1.2.3» не станет IP-адресом. Ищем не только в тексте сообщений: проверяются системные инструкции, аргументы tool_calls, ответы инструментов и файлы.
ФИО
Филиппов Дмитрий Семенович → #PERSON_1#
В любом падеже, с отчеством или инициалами. Понимает склонения.
Телефон
+7 900 123-45-67 → #PHONE_NUMBER_1#
Российские и международные форматы.
Почта
vlasov@example.ru → #EMAIL_1#
Любые адреса электронной почты.
Паспорт
паспорт 4510 123456 → #PASSPORT_1#
Серия и номер рядом со словом «паспорт».
СНИЛС
112-233-445 95 → #SNILS_1#
С проверкой контрольного числа.
ИНН / ОГРН
ИНН 7707083893 → #INN_1#
10 и 12 знаков, с проверкой суммы. ОГРН тоже.
Карты и счета
4276 … 1234 → #CARD_1#
Номер карты по алгоритму Луна, расчётные счета, БИК.
Адреса
г. Москва, ул. Тверская, 1 → #ADDRESS_1#
Города, улицы, дома и квартиры.
Документы и сканы
договор.pdf → обезличенный текст
PDF, офисные форматы, картинки с текстом (через OCR).
Секреты и ключи
sk-… → #SECRET_1#
Токены, пароли, строки подключения.
Наши сервисы уже используют Защитника
Чат сайта
Страница /chat: тексты, файлы и картинки чистятся автоматически.
ru.vega.chat
Один из самых многофункциональных ИИ-чатов в России: работает под защитой Защитника.
Офисные ключи
Ключи officevega на обычных /api/v1/... идут под полным щитом, включая tools и картинки в сообщениях.
Guard-адреса
/api/guard/... включают щит для любого ключа, достаточно одного адреса.
Что это даёт
Что получаете вы
Имена не утекают
Ваши ФИО, телефон и почта не попадают в логи чужого провайдера и не читаются его сотрудниками.
Можно слать документы
Договоры, справки, сканы: текст извлекается и чистится до отправки. В модель уходит только безопасная версия.
Диалог не разваливается
Метки стабильны внутри диалога: #PERSON_1# не превратится в #PERSON_2# на следующей реплике.
Ничего настраивать не надо
В чате сайта защита уже включена. В API это одна строчка baseURL.
Честный отказ вместо тихой утечки
Если защита недоступна, запрос не уйдёт в модель. Вы увидите ошибку, а не дырку в безопасности.
Что получает бизнес
Проще с ФЗ-152
Защитник убирает персональные данные из запроса до отправки, поэтому вопрос об их трансграничной передаче просто не возникает.
Меньше рисков в логах
У провайдера модели хранятся только заглушки. Читать их бесполезно, и вам, и злоумышленнику.
Закрывает человеческий фактор
Сотрудник вставил данные руками, скопировал из письма, переслал в поддержку, а шлюз всё равно почистит.
Чистит и инструменты
Проверяются не только сообщения, но и аргументы tool_calls, ответы инструментов, системные инструкции.
Словарь живёт отдельно
Соответствие «метка → значение» хранится в изолированном словаре диалога около 2 часов и никому чужому не доступно.
Как подключиться
Меняется адрес, остальное остаётся как было. Выберите свой вариант: любой ключ через guard-адрес, офисный ключ через обычные адреса или чат в браузере.
| Ваш случай | Что использовать | Щит |
|---|---|---|
| Любой ключ, нужна защита | /api/guard/... | Всегда |
| Ключ офисного продукта (officevega) | /api/v1/... | Всегда |
| Чат в браузере | /chat | Всегда |
Чтобы #PERSON_1# не прыгнул в #PERSON_2#: шлите один и тот же X-Vega-Session на все реплики диалога. Работает и в SDK, и в cURL.
Если что-то пошло не так
503 pii_unavailable
Защита временно недоступна, поэтому запрос не отправлен. Повторите позже.
413 pii_too_large
Слишком большой контекст для проверки, сократите историю.
400 pii_attachment_not_allowed
Такой тип вложения сюда нельзя. Уберите файлы или отправьте через чат сайта.
422 pii_extract_failed
Не получилось вытащить текст из файла.
Если в ответе осталась метка вида #PERSON_1#, значит сменился X-Vega-Session или запрос шёл мимо щита. Проверьте адрес и имя ключа.