# Яндекс Аудитории: Загрузить файл сегмента (device id / MAC / хеши) — MCP-инструмент (tool)

**MCP-инструмент (tool) для Яндекс Аудиторий:** Создаёт сегмент из TSV/TXT-файла с данными: идентификаторы устройств (IDFA/GAID), MAC-адреса или SHA256-хеши, по одной записи в строке; минимум 100 записей, до 1 ГБ, UTF-8.

Техническое имя: `upload_segment_file`

## Какую задачу решает

> Я хочу загрузить файл сегмента (device id / MAC / хеши).

Создаёт сегмент из TSV/TXT-файла с данными: идентификаторы устройств (IDFA/GAID), MAC-адреса или SHA256-хеши, по одной записи в строке; минимум 100 записей, до 1 ГБ, UTF-8.

## Когда использовать

Используйте эту возможность, когда нужен результат «Загрузить файл сегмента (device id / MAC / хеши)» без ручной работы в интерфейсе Яндекс Аудиторий. Операция выполняется только по вызову из AI-приложения.

## Что нужно передать

- `file_path` — **необязательно**. Путь к локальному файлу с данными. Укажите либо file_path, либо content (ровно одно).
- `content` — **необязательно**. Содержимое файла строкой (для небольших сегментов). Укажите либо content, либо file_path (ровно одно).
- `file_name` — **необязательно**. Имя файла для загрузки. По умолчанию — имя из file_path или стандартное имя.

## Что вернёт

Возвращает компактный JSON-ответ исходного API или понятную ошибку MCP-инструмента. Точный состав полей зависит от операции и описан в техническом справочнике.

## Что изменится в Яндекс Аудиториях

Инструмент изменяет реальные данные Яндекс Аудиторий так, как описано выше. Автоматического отката сервер не обещает.

## Пример запроса

> Загрузить файл сегмента (device id / MAC / хеши) в Яндекс Аудиториях. Если не хватает обязательных идентификаторов, сначала уточни их.

## Возможные ошибки и ограничения

Это первый шаг двухфазного создания: в ответе сегмент со статусом uploaded и его id — затем сегмент нужно сохранить инструментом confirm_segment (имя, тип содержимого, хеширование). Источник данных: file_path (путь к локальному файлу) или content (содержимое строкой) — ровно одно из двух. Квота на создание сегментов: 10/мин, 100/час, 500/сутки.

Доступ также зависит от прав токена, квот и ограничений исходного API.

## Связанные MCP-инструменты

- [Сохранить загруженный сегмент](./confirm-segment.md) — `confirm_segment`
- [Создать lookalike-сегмент](./create-lookalike-segment.md) — `create_lookalike_segment`
- [Создать сегмент на основе пикселя](./create-pixel-segment.md) — `create_pixel_segment`
- [Удалить сегмент](./delete-segment.md) — `delete_segment`

## Технические сведения

- **Воздействие:** изменяет данные
- **Группа:** Сегменты
- **Источник описания:** регистрация `upload_segment_file` в `src/tools/segments.ts`
- [Полный технический справочник](../TOOLS.md)
- [Все MCP-возможности](./index.md)