---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
description: >-
  Как ИИ-агенту выбрать необходимые данные, обработать их в клиенте и проверить
  условия раскрытия.
vcsPath: motorway/magacg/support/docs/src/ru-x-ai/concepts/sensitive-data.md
updatedAt: '2026-11-12T12:16:53.000Z'
alternate:
  - href: https://yamagistrali.ru/docs/ru-x-ai/concepts/sensitive-data.md
    type: text/markdown
    title: Markdown version
  - href: https://yamagistrali.ru/docs/ru-x-ai/llms.txt
    rel: describedby
---

# Работа с персональными и чувствительными данными

Передавайте в API только данные, необходимые для задачи пользователя. Обрабатывайте полный ответ в клиенте и выбирайте поля, которые нужны для следующего вызова или ответа пользователю.

## Какие данные учитывать

| Данные | Примеры |
| --- | --- |
| Сведения о человеке | ФИО, телефон, личная почта, домашний адрес, идентификаторы учётной записи и документов |
| Сведения о заказах и организациях | Цены и ставки, ИНН, внутренние идентификаторы, адреса складов, точные координаты и маршруты |
| Данные аутентификации | Токены, пароли, содержимое заголовка `Authorization` |

Комментарии, вложения и другие поля произвольного формата могут содержать данные из любой строки таблицы. Сверяйте правила для конкретных полей в разделе «Работа с чувствительными данными» карточки метода. Если карточка не описывает условия раскрытия нужного поля, оставляйте исходное значение в клиенте.

## Перед вызовом API

1. Уточните цель запроса и проверьте [доступ к нужной организации и операции](https://yamagistrali.ru/docs/ru-x-ai/guides/api-access.md).
2. Передайте обязательные поля и те необязательные поля, которые нужны для задачи. Например, для [поиска координат](https://yamagistrali.ru/docs/ru-x-ai/methods/geo.geocoder.v2.md) достаточно адреса. Уберите из запроса имена, телефоны и комментарии к заказу.
3. Для токенов используйте [согласованный источник секретов](https://yamagistrali.ru/docs/ru-x-ai/guides/secrets.md). Значения остаются в среде выполнения клиента.

## При обработке ответа

- Оставляйте полные ответы и вложения в клиенте. Для следующего вызова передавайте только нужные поля. Идентификатор заказа можно использовать в запросе деталей внутри клиента, а пользователю показать статус заказа.
- По умолчанию пропускайте чувствительные значения, маскируйте их или сообщайте итог. Для [проверки профиля сотрудника](https://yamagistrali.ru/docs/ru-x-ai/methods/users.user-employees.get-list.v0.md) достаточно сообщить, найден ли профиль и доступна ли нужная роль.
- Передавайте исходное значение пользователю, в контекст ИИ или во внешнюю систему, только если карточка метода разрешает передачу по этому каналу, пользователь явно запросил её, значение необходимо для задачи и у получателя есть действующий доступ. Если получатель или цель неясны, уточните их до передачи. Данные аутентификации не раскрывайте.
- Если нужно сохранить результат вне клиента, согласуйте с пользователем состав данных, место хранения и доступ к нему. Сохраняйте только поля, необходимые для задачи.

## При диагностике и тестировании

Исключите исходные чувствительные значения из журналов, трассировок, метрик, сообщений об ошибках и материалов для поддержки. Сообщайте стенд, метод, HTTP-статус и какие шаги удалось выполнить. Для тестов и примеров используйте синтетические значения.