> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Яндекс Диск

> Индексация файлов Яндекс Диска, включая общие папки

![Логотип Яндекс Диска](https://mintcdn.com/yahont-ai/WSGWTw-XlHTRNn2v/assets/admins/connectors/yandex_disk/yandex_disk_logo.svg?fit=max\&auto=format\&n=WSGWTw-XlHTRNn2v\&q=85\&s=2cc7287e6b30c460db2db7069556d38b)

## Как это работает

Коннектор индексирует файлы на Яндекс Диске: ваши и файлы общих папок,
которыми с этим аккаунтом поделились другие пользователи.
Документы из «Яндекс Документов» лежат на Диске обычными файлами (`.docx`, `.xlsx`) и индексируются как файлы.

Индексируются форматы, которые поддерживает Yahont: PDF, DOCX, XLSX, CSV, TXT, PPTX и другие. Изображения индексируются,
только если в **Настройки индекса** включено **Извлечение и описание изображений**. Файлы из «Корзины»,
файлы больше лимита размера и неподдерживаемые форматы (в том числе `.odt` и `.ods`) пропускаются без скачивания.

Коннектор только читает Диск: он ничего не меняет и не удаляет.
Ссылка в источнике ответа открывает папку файла в веб-версии Диска.

Используется технология Яндекса.

## Настройка

### Вход через Яндекс в Yahont Cloud

**1. Откройте коннектор**

Откройте **Панель администратора → Добавить коннектор** и выберите **Яндекс Диск** в разделе **Хранилища**.

**2. Войдите через Яндекс**

В блоке **Учётная запись для аутентификации** откройте **Новая учётная запись Яндекс Диск**, вкладка **OAuth**.
В строке **Войти через Яндекс Диск** нажмите **Подключить**.

**3. Разрешите доступ**

На странице Яндекса выберите аккаунт, чей Диск нужно индексировать, и разрешите доступ.
Yahont запрашивает только чтение Диска. Аккаунт появится в списке сохранённых аккаунтов,
проверки подключения запустятся сами.

> [!NOTE]
>
> Подключить можно любой аккаунт Яндекса. Токен обновляется сам. Все аккаунты, подключённые так,
> сначала называются одинаково (`Yandex_Disk OAuth Credential`):
> переименуйте аккаунт кнопкой с карандашом рядом с названием.

### Ручной токен

Способ для Yahont CE и запасной вариант в облаке.

**1. Зарегистрируйте приложение**

На [oauth.yandex.ru](https://oauth.yandex.ru) создайте приложение под своим аккаунтом Яндекса,
тип **Для доступа к API**. Платформа **Веб-сервисы**, Redirect URI `https://oauth.yandex.ru/verification_code`.
Права: **Чтение всего Диска** (`cloud_api:disk.read`) и **Доступ к информации о Диске** (`cloud_api:disk.info`).
Других прав не давайте.

**2. Выпустите токен**

Откройте `https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID приложения>` и разрешите доступ.
Токен появится на странице и в адресной строке после `#access_token=`.

**3. Добавьте токен в Yahont**

Откройте **Добавить коннектор → Яндекс Диск → Новая учётная запись Яндекс Диск**, вкладка **API-токен**.
Вставьте токен в поле **OAuth-токен**. Поле **Отображаемое имя** необязательное.

> [!NOTE]
>
> Выпускайте токен своего приложения для своего аккаунта и не передавайте его третьим лицам.
> Такой токен не обновляется сам. Когда Яндекс перестанет его принимать,
> выпустите новый и [замените его](#replace-token).

### Свой вход через Яндекс в Yahont CE

По умолчанию в CE доступен только ручной токен. Вкладка **OAuth** появится,
если подключить собственное приложение Яндекса:

1. На oauth.yandex.ru создайте приложение типа **Для авторизации пользователей**, платформа **Веб-сервисы**,
   права **Чтение всего Диска** (`cloud_api:disk.read`) и **Доступ к информации о Диске** (`cloud_api:disk.info`).
   Redirect URI: `<адрес Yahont>/connector/oauth/callback/yandex_disk`,
   например `https://yahont.example.ru/connector/oauth/callback/yandex_disk`.
2. В `deployment/docker_compose/.env` задайте `WEB_DOMAIN` (адрес, по которому открывают Yahont),
   `YANDEX_DISK_CLIENT_ID` и `YANDEX_DISK_CLIENT_SECRET` со страницы приложения.
3. Выполните `docker compose up -d` в каталоге `deployment/docker_compose`.

Дальше действуйте как в разделе [вход через Яндекс](#cloud-sign-in).

## Индексирование

В форме коннектора:

* **Папка** (необязательно): путь от корня Диска, как папка называется на Диске, например `Документы/Договоры`.
  Можно вставить адрес папки из браузера (`https://disk.yandex.ru/client/disk/…`) или `disk:/Документы`.
  Пустое поле — весь Диск, включая общие папки.
* **Максимальный размер файла, МБ** (в дополнительных настройках): по умолчанию 20, от 1 до 100.
  Файлы больше пропускаются.

Поле **Обновлять каждые** (по умолчанию 30 минут) забирает файлы, изменённые с прошлого запуска.
**Очищать каждые** (по умолчанию 7 дней) убирает из индекса файлы, удалённые на Диске.
**Индексировать документы после** исключает файлы, изменённые раньше этой даты.

Чтобы сменить папку, нажмите **Изменить настройки**, измените поле **Папка** и нажмите **Просмотреть изменения**.
Yahont покажет план: папка внутри прежней — очистка лишнего, папка выше — полная переиндексация,
другая папка — переиндексация с очисткой.

## Проверка подключения

Проверки запускаются после добавления аккаунта и кнопкой **Запустить проверки**:

* **Sign in to Yandex Disk**: Яндекс принял токен (показывает логин аккаунта).
* **Find the root folder**: папка из поля **Папка** существует (при пустом поле читается весь Диск).

| Сообщение | Причина | Что делать |
| - | - | - |
| Yandex Disk rejected the token | Токен отозван, истёк или неверный | Выпустите новый токен или войдите через Яндекс заново |
| Yandex sign-in expired | Яндекс отказался обновить токен входа | Войдите через Яндекс заново |
| Access denied | У приложения нет права «Чтение всего Диска» | Добавьте право и выпустите новый токен |
| Folder not found | Папки с таким путём нет | Проверьте путь или оставьте поле пустым |
| Path is a file | Путь указывает на файл | Укажите папку |

Отклонённый токен ставит коннектор на паузу. Лимит запросов, работы на стороне Яндекса и сбои сети паузу не ставят:
коннектор повторит запуск позже.

## Замена токена

На странице коннектора в блоке **Аккаунт для аутентификации** раскройте карточку аккаунта,
нажмите кнопку с карандашом **Обновить учётные данные** и введите новый токен. Если коннектор на паузе,
нажмите **Управление индексом → Возобновить индексацию и синхронизацию**. Аккаунт, подключённый через вход Яндекса,
заменяется новым входом.

Аккаунт нельзя удалить, пока им пользуется коннектор: сначала удалите коннектор.

## Ограничения

* Один коннектор — одна папка или весь Диск. Для нескольких папок нужно несколько коннекторов.
* Каждое обновление обходит всё дерево папок, поэтому на большом Диске запуск идёт дольше.
* Права доступа Диска не переносятся: документы доступны в Yahont по настройкам доступа коннектора.
* Переименование файла не меняет дату изменения: новое название появится после следующего изменения файла или полной
  переиндексации.
* Файл, который Яндекс не отдал для скачивания, пропускается. Он вернётся в индекс, когда изменится, или при полной
  переиндексации.
* На Диске с тысячами фото и включённым **Извлечением и описанием изображений** первая индексация идёт долго и
  расходует запросы к модели. Если фото не нужны, укажите папку с документами или выключите эту настройку.
* Общие диски организации Яндекс 360, Телемост, вложения писем и форматы `.odt`, `.ods` не поддерживаются.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.