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