Подключить Яндекс.Диск к ИИ-агенту на платформе «СуперИнтеллект» можно за пять шагов: открыть каталог интеграций, выбрать карточку «Яндекс.Диск», указать профиль доступа (только папка приложения или весь Диск), нажать «Подключить аккаунт» и войти в Яндекс, а затем включить нужные модули инструментов. Токен вводить вручную не нужно — авторизация проходит на стороне Яндекса. Ниже — разбор каждого шага и, главное, того, как выбрать периметр доступа: именно это решение определяет, что агент сможет увидеть на вашем Диске.
Что умеет коннектор «Яндекс.Диск»
Коннектор даёт агенту 16 инструментов, сгруппированных в три модуля. Агент умеет не только видеть структуру папок, но и читать содержимое файлов как текст — pdf, docx, xlsx, csv, txt, json, html — и загружать файлы на Диск по внешней ссылке: файл в этом случае скачивает сам Яндекс. Вызовы инструментов коннектора не расходуют нейроны платформы.
| Модуль | Инструментов | По умолчанию | Что даёт агенту |
|---|---|---|---|
| Обзор и чтение | 6 | Включён | Информация о Диске (занято/свободно, аккаунт, активный периметр), просмотр содержимого папки с постраничностью и сортировкой, плоский список файлов с фильтром по типу, метаданные файла или папки, чтение содержимого файла как текста (до 15 МБ), временная ссылка на скачивание для вас |
| Создание и загрузка | 5 | Включается вручную | Создать папку, сохранить подготовленный текст файлом (до 8 МБ), загрузить файл по внешней ссылке прямо на Диск, копировать, переместить или переименовать |
| Удаление и публичные ссылки | 5 | Выключен полностью | Удалить (по умолчанию в корзину, обратимо; безвозвратно — отдельным флагом), опубликовать файл и получить публичную ссылку, снять публикацию, посмотреть корзину, восстановить файл из корзины |
Шаг 1. Найдите Яндекс.Диск в каталоге интеграций
Откройте каталог интеграций и выберите карточку «Яндекс.Диск». Подключение здесь выполняется кнопкой, а не ручным вводом токена — как устроен этот механизм, разобрано в материале подключение аккаунта одной кнопкой.
Шаг 2. Выберите профиль доступа — это главное решение
Профиль доступа выбирается до нажатия кнопки подключения, потому что именно он определяет, какие права вы выдадите на стороне Яндекса. Вариантов два, и разница между ними принципиальная: в одном случае агент физически не может выйти за пределы одной служебной папки, во втором — видит весь Диск. Ограничение обеспечивает не платформа, а сам Яндекс на уровне выданного доступа.
| Вариант | Что видит агент | Когда выбирать |
|---|---|---|
| Только папка приложения (рекомендуется, по умолчанию) | Единственную папку «Приложения/СуперИнтеллект». Выйти за её пределы агент не может — изоляцию обеспечивает сам Яндекс | Старт, пилот, личный Диск с чувствительными файлами, сценарии «агент готовит и складывает результаты» |
| Весь Диск | Все файлы Диска | Когда нужно работать с уже существующими документами, разбросанными по разным папкам |
| Рабочая папка (дополнительно, поверх любого профиля) | Только указанную подпапку внутри выбранного доступа | Когда агент обслуживает один проект, отдел или клиента, а не весь Диск целиком |
Рабочая папка: сузить периметр ещё раз
Рабочая папка — это второй контур ограничения. Вы указываете конкретную подпапку внутри выбранного доступа, и агент не сможет выйти за её пределы, даже если формально у подключения есть доступ ко всему Диску. Практичный сценарий: профиль «Весь Диск» выбран потому, что нужные документы уже лежат в рабочих папках, но агенту вы отдаёте только /Проекты/Клиент А. Всё остальное остаётся за периметром. Заодно это дисциплинирует формулировки задач: агент точно знает, где искать, и не тратит шаги на обход соседних веток.
Шаг 3. Нажмите «Подключить аккаунт»
- Нажмите «Подключить аккаунт» в карточке интеграции.
- Войдите в аккаунт Яндекса в открывшемся окне авторизации.
- Подтвердите выдачу доступа — в том объёме, который соответствует выбранному профилю.
- Вернитесь в карточку интеграции: подключение отображается как активное.
- При необходимости укажите рабочую папку.
Ручной ввод токена в этой схеме не используется: вы подтверждаете доступ в аккаунте Яндекса, и подключение появляется в карточке интеграции. Периметр остаётся ровно тем, который вы выбрали на втором шаге.
Шаг 4. Включите нужные модули
Права выдаются по принципу «сначала минимум». Сразу после подключения агент работает только на чтение — модуль «Обзор и чтение» включён, остальные нет. Дальше вы решаете, что добавить, исходя из задач.
- Только читаете документы и делаете выжимки — оставьте один модуль «Обзор и чтение». На уровне интеграции есть отдельный режим «Только чтение», он фиксирует это состояние.
- Агент должен складывать результаты на Диск — включите «Создание и загрузку»: появятся создание папок, сохранение подготовленного текста файлом, загрузка по внешней ссылке, копирование, перемещение и переименование.
- Нужны удаление и публичные ссылки — включайте модуль «Удаление и публичные ссылки» осознанно и точно понимая, зачем. По умолчанию он выключен целиком.
Шаг 5. Проверьте подключение
Первый запрос лучше сделать диагностическим: он покажет, какой аккаунт подключён и какой периметр доступа реально активен. Это снимает половину будущих вопросов вида «почему агент не видит файл».
Проверочные запросы агенту
Покажи информацию о Диске: какой аккаунт подключён, какой периметр доступа
активен, сколько места занято и сколько свободно.
Выведи содержимое рабочей папки — первые 20 элементов, отсортируй по дате
изменения.
Открой файл «Регламент возвратов.docx» в папке /Документы/Политики
и перескажи его пятью пунктами.
Создай в рабочей папке подпапку «Отчёты 2026» и сохрани туда текстовый файл
«Черновик сводки.txt» с текстом, который я сейчас продиктую.Честное ограничение: поиска по имени файла нет
У API Яндекс.Диска нет полнотекстового поиска по названиям файлов. Агент обходит папки и фильтрует результаты в пределах страницы выдачи — то есть «найди на Диске договор с Ромашкой» превращается в слепой обход дерева и работает медленно и ненадёжно. Решение простое: говорите агенту папку. Одна строка с путём экономит ему десяток шагов и делает результат воспроизводимым.
Как формулировать задачи с учётом ограничения
# Слабо — агент обходит папки вслепую
Найди на Диске договор с «Ромашкой».
# Точно — указываем папку
В папке /Договоры/2026 найди файл, в названии которого есть «Ромашка»,
и прочитай его.
# Ещё надёжнее — сначала список, потом чтение
Покажи плоский список файлов в /Договоры/2026 с фильтром по документам.
Выбери подходящий и прочитай содержимое.
# Загрузка по ссылке — Яндекс скачивает файл сам
Загрузи файл по ссылке https://example.com/price-list.xlsx
в папку /Прайсы и сообщи, когда он там появится.Безопасность и лимиты, о которых стоит знать заранее
- По умолчанию только чтение. Запись включается вручную, модуль удаления и публикации выключен полностью.
- Режим «Только чтение» доступен на уровне интеграции — фиксирует безопасное состояние независимо от того, какие модули кто-то попробует включить.
- Подтверждения в чате. Удаление и публикация проходят через явное согласие; публичная ссылка сопровождается предупреждением о том, что файл станет доступен всем в интернете без авторизации.
- Лимиты. Чтение содержимого файла — до 15 МБ, сохранение подготовленного текста файлом — до 8 МБ.
- Поиска по имени нет — периметр и точные пути к папкам заменяют его. Подробный разбор модели доступа — в материале безопасность доступа к файлам.
Что делать дальше
После подключения логично сразу поставить агенту первую содержательную задачу — например, разобрать папку с документами: как это устроено, показано в гайде ИИ-агент читает документы с Яндекс.Диска. Если параллельно вы смотрите на Google-коннектор, учтите: там периметр устроен иначе — агент работает только с файлами, которые создал сам или которые ему явно открыли, а существующий Google Диск пользователя ему не виден. Это осознанное решение ради безопасности. Сравнение периметров — в разборе Google Workspace или Яндекс.Диск. Если аккаунта на платформе ещё нет, начните с регистрации: создать аккаунт.
Частые вопросы
Нужно ли получать и вводить токен вручную?
Нет. Подключение выполняется кнопкой «Подключить аккаунт»: вы входите в аккаунт Яндекса и подтверждаете выдачу доступа в том объёме, который задаёт выбранный профиль. Ручной ввод токена в этой схеме не используется.
Увидит ли агент весь мой Диск?
Только если вы сами выберете профиль «Весь Диск». При профиле «Только папка приложения» агент видит единственную папку «Приложения/СуперИнтеллект» и не может выйти за её пределы — это ограничение обеспечивает сам Яндекс, а не настройки платформы. Дополнительно можно указать рабочую папку и сузить периметр до одной подпапки.
Может ли агент работать с моими уже существующими файлами?
Да — в пределах выбранного периметра: папка приложения, рабочая папка или весь Диск, как вы решите. Это отличие от Google-коннектора: там агент по соображениям безопасности работает только с файлами, которые создал сам или которые ему явно открыли, и существующий Google Диск пользователя ему не виден.
Что происходит при удалении файла и при публикации ссылки?
Модуль удаления и публичных ссылок выключен по умолчанию. Если включить его, удаление по умолчанию отправляет файл в корзину и обратимо (безвозвратное — отдельным флагом), а публикация создаёт ссылку, открытую всем в интернете без авторизации, о чём агент предупреждает. Оба действия подтверждаются с вами в чате. В корзину можно заглянуть и восстановить файл.
Какие ограничения по размеру файлов?
Чтение содержимого файла как текста — до 15 МБ (pdf, docx, xlsx, csv, txt, json, html). Сохранение подготовленного текста файлом — до 8 МБ. При загрузке по внешней ссылке файл скачивает сам Яндекс, минуя платформу.
Подключение занимает меньше минуты, а весь риск управляется одним решением — выбором периметра. Начните с папки приложения, добавьте рабочую папку под конкретный проект и включайте запись только тогда, когда агенту действительно нужно что-то положить на Диск. Создать рабочее пространство и подключить интеграцию можно сразу после регистрации.
