Скилл Яндекс Диск в Aizor: как подключить и работать с файлами

Клиент просит прислать договор ещё раз. Договор лежит на вашем Яндекс Диске среди фото и отчётов, и чтобы его отправить, надо открыть сайт, пролистать папки, найти файл и сделать ссылку. Каждый раз немного, но за месяц набегает заметно.

Скилл Яндекс Диск позволяет поручить это агенту Aizor, не открывая сайт. Подключение разберём на примере этого договора.

Что агент умеет на Яндекс Диске?

Официальное описание скилла от команды Aizor: агент работает с Яндекс Диском, просматривает папки, загружает и скачивает файлы, сохраняет файлы из интернета и публикует ссылки через REST API.

Агент работает с Диском вашего аккаунта. Подробнее об Aizor: «Что такое Aizor».

Что нужно подготовить?

Набор небольшой:

• Аккаунт Яндекса с Диском.
• Возможность создать OAuth-приложение на oauth.yandex.ru.
• Приложение Aizor для macOS или Windows и скилл Яндекс Диск из каталога.

Где взять токен?

Вместо ключа здесь OAuth-токен. Он даёт одному приложению доступ к Диску одного пользователя, поэтому получать его нужно через своё приложение. Порядок из документации:

1. Создайте своё OAuth-приложение по инструкции из справки OAuth Яндекс ID.
2. В разделе «Доступ к данным» выберите права. Список: cloud_api:disk.write (запись в любом месте Диска), cloud_api:disk.read (чтение всего Диска), cloud_api:disk.app_folder (доступ к папке приложения), cloud_api:disk.info (информация о Диске).
3. На странице приложения скопируйте идентификатор из поля ClientID.
4. Откройте ссылку https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>, подставив свой идентификатор.
5. Если токен выдаётся впервые или срок предыдущего истёк, откроется экран авторизации. Войдите в аккаунт.
6. Скопируйте токен с открывшейся страницы и сохраните.

Найти выданный токен в кабинете нельзя, потому что Яндекс OAuth не хранит токены в публичном доступе. Если токен потерялся, получите новый по той же ссылке. Затем установите скилл Яндекс Диск из каталога Aizor и вставьте токен в его настройки.

Какие права выбрать? Если агенту нужно только смотреть файлы, хватит cloud_api:disk.read. Если он должен работать в одной папке, выберите cloud_api:disk.app_folder: по документации, такое приложение работает только в своей папке в системном каталоге «Приложения», если вы не дали права на весь Диск.

Как проверить, что всё работает?

Идите от чтения к записи, и последний запрос лучше пускать под подтверждением:

• «Покажи, какие папки лежат в корне моего Яндекс Диска» (только чтение).
• «Найди в папке «Документы» последние пять файлов и назови их размер».
• «Скачай на компьютер файл договор.pdf из папки «Клиенты»».
• «Загрузи этот файл в папку «Отчёты»» (запись: лучше под подтверждением).

Как это выглядит в работе?

Как разобрать папку, не открывая сайт?

Вы просите агента показать содержимое папки и сгруппировать файлы по типам или датам. Агент читает список через API и выдаёт сводку, а менять ничего не нужно.

Как сохранить файл по ссылке?

Вы даёте агенту адрес файла, и он просит Диск скачать его в нужную папку. Диск скачивает такой файл не сразу: сначала он отвечает кодом 202 и присылает ссылку, по которой видно, как идёт загрузка. Если файл по ссылке не скачался, агент может скачать его сам и загрузить на Диск.

Как класть отчёты в папку каждый день?

По расписанию агент забирает готовый файл, например выгрузку из аналитики (см. скилл Яндекс Метрики), и кладёт его в папку отчётов. Запись нужно разрешить правом cloud_api:disk.write.

Как поделиться файлом по ссылке?

Вы просите агента опубликовать файл и прислать ссылку. Метод публикации возвращает публичную ссылку вида https://yadi.sk/...: открыть файл смогут все, кому вы её передадите.

Что делать, если Диск вернул ошибку?

Агент покажет код, а таблица подскажет следующий шаг.

Что видите	Причина	Что делать
401, не авторизован	Токен не передан, неверный или истёк.	Получите токен заново по ссылке авторизации.
403, API недоступно	Файлы занимают больше места, чем есть на Диске, либо не хватает прав.	Освободите место или увеличьте Диск; проверьте права приложения.
409, ресурс уже существует	Файл или папка по этому пути есть.	Выберите другое имя или разрешите перезапись.
413 или 423	Файл больше допустимого для вашего тарифа либо достигнут месячный лимит загрузки.	Размер и лимит зависят от тарифа Яндекс 360, смотрите справку Яндекс 360.
429 или 507	Слишком много запросов; недостаточно места.	Подождите и повторите; освободите место на Диске.

Как не потерять файлы и не раскрыть лишнего?

Токен даёт агенту доступ к вашим файлам, поэтому права лучше урезать.

• Выбирайте минимальные права. Для просмотра хватит cloud_api:disk.read, для одной папки cloud_api:disk.app_folder.
• Создайте отдельное OAuth-приложение под агента: его можно отключить, не затрагивая другие сервисы.
• Загрузку, публикацию и удаление включите под ручное подтверждение в Aizor. Публичная ссылка открывает файл всем, у кого она есть.
• Удаление через API по умолчанию отправляет файл в Корзину. Параметр permanently=true удаляет без Корзины, такие запросы не подтверждайте на ходу.
• Не пересылайте токен в чатах и письмах. Как отозвать токен, в документации Диска не описано: смотрите справку Яндекс OAuth.

Когда всё настроено, нужный договор вы просите у агента, а не ищете по папкам.

Инструкция написана по официальной документации Яндекс Диска REST API (yandex.ru/dev/disk-api), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.