Платформа
Яндекс Диск
Подключение Диска, поиск файлов, папки, загрузка и обмен с проектом.
Яндекс Диск
Приложение Яндекс Диск подключает файлы и папки аккаунта Яндекса к рабочему пространству Promto. Агент может находить документы, читать метаданные, получать ссылки для загрузки и скачивания, создавать папки, перемещать файлы, работать с корзиной и публиковать ссылки.
Назначение
Яндекс Диск удобен для задач, в которых исходные или итоговые материалы уже находятся в облаке:
- поиск файла по пути, имени, типу и дате изменения;
- просмотр занятого и свободного места;
- анализ выгрузок и документов;
- поиск дублей и старых версий;
- создание папок, копирование и перемещение;
- восстановление из корзины;
- подготовка публичной ссылки после подтверждения.
Подключение
Подключить и отключить Диск может владелец рабочего пространства.
- Откройте Яндекс Диск → Настройки.
- Нажмите Получить код подтверждения.
- Откройте страницу Яндекса и войдите под аккаунтом, где лежат нужные файлы.
- Введите код и разрешите чтение и запись на Диске.
- Дождитесь появления сведений о занятом и свободном месте.
Токен передаётся сразу на сервер Promto и не появляется в браузере или окружении агента.
Для ручного подключения создайте приложение Яндекс OAuth и включите права cloud_api:disk.info и cloud_api:disk.read. Право cloud_api:disk.write нужно для загрузки, публикации, перемещения, удаления и восстановления. Затем укажите ClientID, получите токен и вставьте его в Promto.
Интерфейс
На Главной находятся сценарии поиска документа, расчётов по выгрузке, проверки места и новых файлов, поиска дублей, восстановления из корзины и публикации ссылки.
В Настройках приложение показывает:
- подключённый аккаунт и маску токена;
- общий, занятый и свободный объём;
- размер корзины и максимальный размер файла, если эти данные вернул Яндекс;
- системные папки приложений и загрузок;
- состояние соединения и кнопку отключения.
Полноценного файлового проводника в приложении Диска нет: содержимое папок агент разбирает через чат. Локальные файлы рабочего пространства открываются в отдельном приложении Файлы.
Возможности агента
Основной агент использует promto_yadisk.
| Задача | Действия |
|---|---|
| Сведения и поиск | disk_info, list, list_files, get_meta |
| Передача файлов | download_link, upload_link |
| Папки и файлы | create_folder, copy, move, delete |
| Публичный доступ | publish, unpublish |
| Корзина | list_trash, restore_trash |
| Дополнительные методы API | request |
Обычно агент начинает с list для конкретного пути. Корень можно обозначить / или disk:/.
Сценарии
Найти актуальный документ
Назовите часть имени, формат или папку. Агент покажет полный путь, размер и дату изменения и сравнит найденные версии.
Посчитать показатели по выгрузке
Агент получает временную ссылку на скачивание, загружает файл в рабочее пространство, анализирует его и возвращает таблицу с результатами. Исходник на Диске при этом не меняется.
Восстановить или опубликовать файл
Перед восстановлением агент показывает найденный объект в корзине. Перед публикацией — точный путь и предупреждение, что любой обладатель ссылки сможет открыть файл.
Ограничения и безопасность
download_linkиupload_linkвозвращают короткоживущую ссылку примерно на 30 минут. Файловые байты не проходят через сервер Promto: агент переносит их по подписанной ссылке Яндекса.- Публичная ссылка открывает доступ всем, у кого она есть. Не публикуйте секреты, персональные данные и внутренние документы.
- Обычное удаление перемещает объект в корзину. Параметр постоянного удаления обходит корзину и необратим — его нельзя использовать без отдельного подтверждения.
- Перемещение с перезаписью может заменить существующий объект. Перед операцией проверьте оба пути.
- Путь внутри корзины считается относительно корня корзины, а не
disk:/. - Рекурсивный список файлов не возвращает общий итог; агент определяет конец по размеру очередной страницы.
- Токен хранится только на сервере, все действия через подключение журналируются.
Если что-то не работает
Нет права на запись. Переподключите аккаунт с cloud_api:disk.write. Без него доступны только сведения и чтение.
Файл не найден. Уточните фактический путь и сначала попросите агента показать содержимое родительской папки. В именах и путях учитывается регистр.
Ссылка перестала работать. Получите новую ссылку: временные URL нельзя сохранять для постоянного использования.
Не удаётся создать папку. Проверьте, существует ли родительская папка и не занят ли целевой путь.
Токен отклонён. Отключите Диск и пройдите подключение заново; не отправляйте токен агенту.