# Хранилище и приватность

В [Хранилище](/storage/) находятся загруженные файлы и результаты. Здесь можно найти нужный материал, проверить занятое место или добавить новый файл. Начните с [пошаговой инструкции загрузки](/docs/knowledge/guides/studio-files.md), если раньше не пользовались этим разделом.

## Как проверить место и доступ

1. Откройте [Хранилище](/storage/) и проверьте занятое место.
2. Убедитесь, что смотрите нужные личные файлы или материалы проекта. Квоту файлов проекта расходует его владелец.
3. Если места не хватает, освободите его осознанно или выберите подходящий [тариф хранения](/storage/plans/).
4. Перед повторной генерацией проверьте, сохранился ли исходный файл. При необходимости [добавьте его заново](/docs/knowledge/guides/studio-files.md).

Базовая личная квота сейчас 10 ГиБ. Новые загрузки при нехватке места не принимаются автоматически; не рассчитывайте, что система сама удалит старые файлы ради новой загрузки.

## Подписка и файлы

Отмена автопродления сохраняет оплаченный объём до конца периода и не удаляет файлы автоматически. Если затем доступного места станет недостаточно, освободите квоту или измените тариф.

Удаление, архивирование, копирование и перенос имеют разный результат. Проверьте действие и проект назначения; копия файла отдельно расходует место. Подробнее — [проекты и права](/docs/knowledge/guides/projects-and-roles.md).

Условия обработки данных смотрите в [политике конфиденциальности](/privacy/). Юридически значимая редакция находится в опубликованном оригинале PDF. Не следует считать отсутствие текста в отдельной диагностике обещанием, что нигде не сохраняются никакие данные.

Дальше: [открыть хранилище](/storage/) или [разобраться с недоступным файлом и повторением задачи](/docs/knowledge/guides/repeat-and-settings.md).

## Для API, CLI и MCP

Да, хранилищем можно пользоваться через Public API, MCP и CLI: загружать файлы, искать их, скачивать, копировать между личным хранилищем и проектами, удалять неиспользуемые файлы.

### Инструкции агентов и skills

Хранилище принимает Markdown (`.md`, `.markdown`) и обычные текстовые файлы (`.txt`, `.text`) в UTF-8, до 10 МиБ на документ. Здесь можно хранить инструкции агентов `AGENTS.md`, определения навыков (skills) `SKILL.md` и сопроводительные текстовые материалы. Это файлы конфигурации и инструкций: их применение и запуск агента выполняет ваш клиент. Загрузка не устанавливает skill и не добавляет документ в контекст языковой модели автоматически.

| Действие        | Public API                                                                    | MCP                                                                | CLI                                                               |
| --------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------- |
| Загрузить       | `POST /api/v1/files/` или `/files/from-url/`                                  | `upload_file`                                                      | `artillect upload ./SKILL.md`                                     |
| Найти           | `GET /api/v1/assets/?kind=file&q=SKILL`                                       | `list_media_assets({kind:"file",q:"SKILL"})`                       | `artillect assets list --kind file --query SKILL`                 |
| Получить ссылку | `GET /api/v1/assets/{asset_id}/`                                              | `get_media_asset`                                                  | `artillect assets get ast_…`                                      |
| Скачать         | Получить свежий `url`, выполнить GET без API-ключа                            | Получить `url` через `get_media_asset`, скачать средствами клиента | `artillect assets download ast_… --out ./skills/example/SKILL.md` |
| Скопировать     | `POST /api/v1/assets/{asset_id}/` с `target` и при необходимости `project_id` | `copy_media_asset`                                                 | `artillect assets copy ast_… --project 12`                        |
| Удалить         | `DELETE /api/v1/assets/{asset_id}/`                                           | `delete_media_asset`                                               | `artillect assets delete ast_…`                                   |

Для загрузки нужен ключ с `files:write`; права на проект проверяются отдельно. Без `project_id` файл попадает в личное хранилище. Через hosted MCP используйте публичный HTTPS URL; для локального файла — CLI или stdio MCP `file_path`. Виджет `request_user_upload` предназначен для изображений, видео и аудио. Для текстовых документов используйте обычную загрузку, а не presigned upload, который поддерживает только изображения и аудио.

Для skill с несколькими файлами загрузите каждый поддерживаемый документ отдельно и сохраните их Asset IDs и относительные пути у себя. При восстановлении скачайте их в структуру каталогов, принятую вашим клиентом. Хранилище не собирает пакет skill автоматически. Файлы проекта доступны участникам с соответствующими правами; используемые файлы защищены от удаления.

- Базовая личная квота — 10 ГиБ.
- Можно хранить Markdown и обычный текст (.md, .markdown, .txt, .text; UTF-8, до 10 МиБ): инструкции агентов AGENTS.md, описания skills SKILL.md и сопроводительные документы.
- Хранилище доступно через Public API, MCP и CLI: загрузка, поиск, скачивание, копирование и удаление. Файлы инструкций загружаются в агентский клиент явно; сохранение не запускает агента и не устанавливает skill.
- Ассеты проекта учитываются по квоте владельца проекта.
- При нехватке места новые загрузки не принимаются автоматически.
- Старые файлы не удаляются системой автоматически — освобождайте место осознанно.

### Для своего приложения или агента

Для долгоживущей ссылки на файл сохраняйте Asset ID вида ast_…, а не внутренний object key. Assets API возвращает свежий разрешённый URL. Доступ к personal/project scope по-прежнему проверяется. Копирование создаёт отдельный Asset и отдельно расходует квоту.

### Что означает приватность диагностики?

Provider diagnostics не сохраняет промпты, исходники, аргументы инструментов, изображения, URL и auth headers. Это правило конкретной диагностики, а не обещание zero-retention всех данных у всех внешних сервисов. Такое универсальное обещание не подтверждено.

Контракты: [Assets API](/docs/artillect-api.md#формат-url-input-vs-output), [восстановление оплаты](/docs/knowledge/questions/cancellation-and-recovery.md).