> ## 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.

# Обзор

> Управление коннекторами и источниками данных в Yahont

Коннекторы Yahont создают мост между источниками данных вашей организации и функциями генеративного ИИ в Yahont.
Почти все коннекторы постоянные и регулярно синхронизируют изменения из вашего источника.

> [!NOTE]
>
> И данные, получаемые из источника, и данные, к которым ваши пользователи имеют доступ через Yahont,
> можно настроить под ваши потребности!

Инструкции по каждому коннектору смотрите в разделе [Поддерживаемые коннекторы](#supported-connectors).

![Страница добавления коннектора в Yahont](https://mintcdn.com/yahont-ai/GgKRVXXDNIirDkuK/assets/admins/connectors/add_connector.png?fit=max\&auto=format\&n=GgKRVXXDNIirDkuK\&q=85\&s=26c1456ac4dde9014b10c9b45d913497)

## Добавление коннектора

Чтобы добавить новый коннектор, откройте **панель администратора** и нажмите **Добавить коннектор** на боковой панели.
На этой странице показаны все официально поддерживаемые коннекторы.

> [!NOTE]
>
> Раздел «ИИ и наблюдаемость» (коннектор Braintrust) показывается, если в окружении задано `SHOW_EXTRA_CONNECTORS=true`.
> В Yahont CE шаблон `.env` задаёт это значение.

Нажмите на любую плитку, чтобы начать создание нового коннектора.

### Учётные данные

Большинству коннекторов нужна та или иная аутентификация, чтобы Yahont мог получить доступ к вашему источнику.
Эта аутентификация называется учётными данными и зависит от коннектора.

![Страница учётных данных коннектора Yahont](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/generic_credentials.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=6da478953217be2646530e331ef38052)

### Конфигурация

Каждому коннектору нужно задать название. Кроме того, у каждого коннектора есть собственные параметры конфигурации,
определяющие индексируемые данные.

![Страница конфигурации коннектора Yahont](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/generic_config.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=5061f903063eb3a6b45d5963040b8cd2)

### Управление доступом к документам

Коннекторы можно настроить как **Приватные**, **Публичные** или с **автосинхронизацией прав**.

**Приватный**: только пользователь, создавший коннектор, видит данные этого коннектора в Yahont.
Вы также можете предоставить доступ к данным коннектора отдельным пользователям и группам пользователей.

**Публичный**: все пользователи Yahont видят данные этого коннектора.

> [!WARNING]
>
> Если вы настроите коннектор на доступ к приватным данным в источнике,
> все пользователи Yahont смогут увидеть эти данные.

#### Коннекторы с синхронизацией прав

Если задать для коннектора тип доступа **Автосинхронизация прав**,
Yahont будет вести список управления доступом из источника и ограничивать пользователей только теми данными,
к которым у них есть доступ.

Синхронизация прав доступна только для следующих коннекторов:

* Confluence
* Jira
* Google Drive (нужно использовать сервисный аккаунт или учётные данные OAuth администратора Google Workspace)
* Gmail (нужно использовать сервисный аккаунт или учётные данные OAuth администратора Google Workspace)
* GitHub

> [!NOTE]
>
> Коннекторы с синхронизацией прав — функция Enterprise Edition.

### Расширенная конфигурация

Нажатие **Расширенная конфигурация** в левом нижнем углу страницы конфигурации коннектора откроет дополнительные
необязательные параметры индексации.

**Частота очистки**: как часто старые данные (которых больше нет в источнике) удаляются из Yahont. По умолчанию 30 дней.

**Частота обновления**: как часто из источника получаются новые данные. По умолчанию 30 минут.

**Дата начала индексации**: дата и время, начиная с которых индексируются данные (данные,
созданные или обновлённые до этой даты, индексироваться не будут). По умолчанию даты начала нет,
поэтому первая попытка индексации читает всю историю источника.
В большом источнике эта первая попытка может занять несколько дней. Задайте дату начала при создании коннектора,
если вам нужно только недавнее содержимое или вы хотите, чтобы коннектор стал доступен для поиска быстрее.

![Страница расширенной конфигурации коннектора Yahont](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/generic_advanced_config.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=66d6247479ef3c16b9ac5f4daeb253f0)

## Управление существующими коннекторами

Чтобы увидеть существующие коннекторы,
откройте **панель администратора** и нажмите **Существующие коннекторы** на боковой панели.
На этой странице показан обзор ваших коннекторов, их статус и объём проиндексированных данных.

![Страница существующих коннекторов Yahont со статусами коннекторов](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/indexing_status.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=2f4e3bd758ccf37b9b0cfa3e49f9c617)

### Статус коннектора

Статус коннектора может быть таким:

#### Активные

| Статус | Описание |
| - | - |
| **Проиндексирован** | Коннектор полностью работает, и все данные синхронизированы на момент последней попытки индексации. |
| **Запланирован** | Новые коннекторы или коннекторы, достигшие частоты обновления, но ещё не начавшие новую попытку индексации. |
| **Индексация / Первичная индексация** | Коннектор сейчас получает данные из источника. |

#### Неактивные или полуактивные

| Статус | Описание |
| - | - |
| **Приостановлен** | Коннектор приостановлен и не будет получать новые данные, пока его не возобновят. Пользователи по-прежнему могут пользоваться проиндексированными данными. |
| **Ошибка** | В коннекторе произошла ошибка во время индексации. Данные, проиндексированные до ошибки, остаются доступными. Yahont попробует проиндексировать снова. Если ошибок будет слишком много, коннектор будет приостановлен. |

> [!NOTE]
>
> Большинство статусов «Ошибка» временные и проходят сами в течение нескольких часов. Если вы видите статус «Ошибка»,
> который сохраняется, пожалуйста, свяжитесь с нами.

### Сведения о коннекторе

Нажатие на существующий коннектор покажет сведения о его конфигурации, статусе и попытках индексации.

В меню **Управление** можно приостановить, возобновить, удалить коннектор или запустить его полную переиндексацию.

В разделе **Расширенные** можно увидеть настройки очистки и обновления, а также историю попыток индексации.

![Страница сведений о коннекторе Yahont](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/connector_details.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=591fe9458474821a6f8980c1aee24391)

![Страница сведений о коннекторе Yahont: попытки индексации и сбои](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/indexing_attempts.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=0d89db9f9c093e1aeabc4be548569e55)

### Сбои индексации

Редко вы увидите попытку индексации **Завершено с ошибками**. Если это произошло,
нажмите кнопку **Устранить все ошибки**, чтобы запустить полную переиндексацию коннектора.

## Поддерживаемые коннекторы

> [!WARNING]
>
> Не нашли нужный коннектор? Сообщите нам через [GitHub Issues](https://github.com/pipedude/yahont-ce/issues)!

### База знаний и вики

> **[Confluence](/admins/connectors/official/confluence)**

> **[SharePoint и OneDrive](/admins/connectors/official/microsoft-365/sharepoint)**

> **[Notion](/admins/connectors/official/notion)**

> **[BookStack](/admins/connectors/official/bookstack)**

> **[Discourse](/admins/connectors/official/discourse)**

> **[GitBook](/admins/connectors/official/gitbook)**

> **[Outline](/admins/connectors/official/outline)**

> **[MediaWiki](/admins/connectors/official/mediawiki)**

> **[Wikipedia](/admins/connectors/official/wikipedia)**

> **[Google Sites](/admins/connectors/official/google_sites)**

### Облачные хранилища

> **[Google Drive](/admins/connectors/official/google_drive/overview)**

> **[Dropbox](/admins/connectors/official/dropbox)**

> **[AWS S3](/admins/connectors/official/s3/overview)**

> **[Google Storage](/admins/connectors/official/google_storage)**

> **[S3 (совместимые хранилища)](/admins/connectors/official/s3_compatible)**

### Тикеты и управление задачами

> **[Jira](/admins/connectors/official/jira)**

> **[Freshdesk](/admins/connectors/official/freshdesk)**

> **[TestRail](/admins/connectors/official/testrail)**

### Обмен сообщениями

> **[Slack](/admins/connectors/official/slack/slack_indexed)**

> **[Microsoft Teams](/admins/connectors/official/microsoft-365/teams)**

> **[Gmail](/admins/connectors/official/gmail/overview)**

> **[Outlook](/admins/connectors/official/microsoft-365/outlook)**

> **[Email (IMAP)](/admins/connectors/official/imap)**

> **[Яндекс Почта](/admins/connectors/official/yandex_mail)**

> **[Mail.ru](/admins/connectors/official/mailru_mail)**

> **[Discord](/admins/connectors/official/discord)**

> **[XenForo](/admins/connectors/official/xenforo)**

> **[Zulip](/admins/connectors/official/zulip)**

### Репозитории кода

> **[GitHub](/admins/connectors/official/github)**

> **[GitLab](/admins/connectors/official/gitlab)**

> **[Bitbucket](/admins/connectors/official/bitbucket)**

### Другое

> **[Веб-скрейпер](/admins/connectors/official/web)**

> **[Загрузка файлов](/admins/connectors/official/file)**

> **[Braintrust](/admins/connectors/official/braintrust)**


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