Яндекс Диск: Создание папки

Создание папки

Используй этот скилл, когда пользователь просит выполнить задачу в Яндекс Диск: Создать папку идемпотентно и корректно обработать уже существующий путь.

Перед началом

1. Открой актуальную официальную документацию: https://yandex.ru/dev/disk/api/reference/all-files.html
2. Уточни целевой аккаунт, объект, период и ожидаемый результат.
3. Проверь авторизацию: OAuth-токен с доступом к Яндекс Диску.
4. Никогда не проси вставлять секрет в чат и не выводи его в команды, логи или ответ.

Порядок работы

1. Сначала выполни доступный read-only запрос и проверь идентификаторы объектов.
2. Учитывай пагинацию, лимиты, актуальную версию API и повтор с backoff для 429/5xx.
3. Выполни задачу: Создать папку идемпотентно и корректно обработать уже существующий путь.
4. Для повторяемой записи используй идемпотентность либо предварительную проверку текущего состояния.
5. После изменения перечитай объект через API и сравни фактическое состояние с запросом пользователя.
6. Верни краткий отчёт: что изменено, идентификаторы, ошибки и что осталось сделать вручную.

Ограничения безопасности

• Перед удалением, публикацией, денежной операцией, запуском рекламы или необратимой сменой статуса получи явное подтверждение.
• Не расширяй права токена и не работай с аккаунтами, которые пользователь не указал.
• Не обходи модерацию, тарифные ограничения, rate limits и правила обработки персональных данных.
• Если документация расходится с памятью или примером, следуй текущей официальной документации.

Источник

• https://yandex.ru/dev/disk/api/reference/all-files.html
• Исходный Agent Skill: https://github.com/bizyumov/yandex-office