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

# Notion

> Подключение страниц и баз данных Notion к Yahont с помощью токена интеграции

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

Yahont читает страницы и содержимое баз данных, которыми вы поделились с подключением Notion.
Оставьте **Root Page ID** пустым, чтобы индексировать все доступные страницы, или задайте его,
чтобы индексировать одну страницу и её дочерние.

Yahont проверяет изменения содержимого по расписанию обновления коннектора.
Интервал обновления по умолчанию — **30 минут**. Время индексации также зависит от размера рабочего пространства,
ограничений API и очереди индексации. Интервал обновления не гарантирует, что изменения появятся за это время.
Без корневой страницы Yahont использует API поиска Notion и получает страницы, изменённые в каждом окне индексации.
Если корневая страница задана, Yahont обходит эту страницу и её дочерние при каждом запуске.

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

Вам нужны аккаунт администратора Yahont и токен внутреннего подключения Notion. Если нужно новое подключение,
попросите владельца рабочего пространства Notion создать его.
Также нужно разрешение делиться целевыми страницами с этим подключением.
Участники рабочего пространства могут делиться страницами с существующим подключением,
если это позволяют права на страницу и политики рабочего пространства.
Владельцы рабочих пространств Enterprise могут ограничить, кто управляет доступом подключений.

> [!NOTE]
>
> Notion теперь называет интеграции **подключениями** (connections).
> В текущем процессе используются **New connection** и **Access token**.
> Токен также может называться **Installation access token** или **Internal Integration Secret**.

## Получение учётных данных Notion

### Создание внутреннего подключения

**1. Откройте портал разработчиков Notion**

Войдите на [портал разработчиков Notion](https://app.notion.com/developers/connections)
под аккаунтом владельца рабочего пространства. Выберите **New connection**.

**2. Выберите аутентификацию по токену доступа**

Введите имя, например `Yahont`. Выберите **Access token** в качестве метода аутентификации,
затем нажмите **Create connection**. При настройке выберите рабочее пространство,
которое Yahont должен индексировать.

![Диалог нового подключения Notion с именем Yahont и выбранным Access token](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/notion/notion-create-connection.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=cea6223663af62e21d1f445a1c657191)

**3. Задайте доступ на чтение**

Откройте настройки возможностей подключения. Включите **Read content** и сохраните изменения.
Для индексации страниц Yahont не нужны **Update content** и **Insert content**.

**4. Скопируйте токен доступа**

Откройте **Configuration**. В разделе **Integration token** скопируйте **Access token**.
В старых экранах он называется **Internal Integration Secret**. Это значение вы вставите в Yahont.

![Поле Access token в Notion со скрытым токеном и кнопками показа, обновления и копирования](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/notion/notion-token-location.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=90a05bfff1e980b2492d0e4faeec59d9)

Храните токен в тайне. Не включайте его в снимки экрана, исходный код и сообщения в поддержку.

### Повторное использование существующего подключения

В Notion откройте меню рабочего пространства и выберите **Settings → Connections → Manage → All connections**.
Найдите внутреннее подключение. Откройте его меню **•••** и выберите **Manage connection**.
В разделе **Copy access token** нажмите **Copy**. Также можно открыть **Developer portal**,
чтобы посмотреть его конфигурацию.

Не нажимайте **Refresh**, чтобы скопировать существующий токен.
Refresh создаёт новый токен и может нарушить работу существующих коннекторов.

Расположение токена описано в [руководстве по авторизации внутреннего
подключения](https://developers.notion.com/guides/get-started/authorization#internal-connection-auth-flow-set-up)
Notion,
а подробности о разрешениях — в его [справочнике возможностей
подключения](https://developers.notion.com/reference/capabilities).

### Предоставление подключению доступа к страницам

Создание подключения не даёт ему доступа ко всему содержимому рабочего пространства.
Поделитесь страницами и базами данных, которые хотите индексировать.
Также можно управлять общими страницами в портале разработчиков в разделе **Content access → Edit access**.

**1. Откройте страницу или базу данных в Notion**

Откройте исходную страницу или базу данных, которую должен читать Yahont.

**2. Добавьте подключение**

Откройте меню **•••** в правом верхнем углу.
В разделе **Connections** выберите **Add connections** или **+ Add connection**. Найдите созданное подключение,
выберите его и подтвердите доступ.

**3. Проверьте область содержимого**

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

См. [инструкции Notion по подключению страниц](https://www.notion.com/help/add-and-manage-connections-with-the-api).

## Добавление учётных данных в Yahont

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

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

**2. Создайте учётные данные**

В разделе **Select a credential** выберите **Create New**. При запросе введите описательное название учётных данных.
Вставьте токен Notion в **Notion Integration Token** и нажмите **Create**. Вставляйте только токен,
без префикса `Bearer` и кавычек.

Если вы уже сохранили учётные данные для этого рабочего пространства, выберите их.

![Диалог создания учётных данных Notion в Yahont с полями Name и Notion Integration Token](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/notion/onyx-notion-credential.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=9ee62a143d08b8dc306132c5144dbfb1)

**3. Настройте коннектор**

Нажмите **Continue**, чтобы открыть шаг конфигурации. Задайте коннектору название, например `Notion Knowledge Base`.
Задавайте **Root Page ID** только если хотите ограничить индексацию одной страницей и её дочерними.

| Root Page ID | Что индексируется |
| - | - |
| Пусто | Все страницы, доступные подключению Notion. |
| ID страницы | Эта страница и её доступные дочерние страницы. |

Чтобы найти ID страницы, скопируйте её ссылку Notion.
Используйте 32-символьный ID в конце пути URL до строки запроса `?`. Например,
у `https://www.notion.so/Team-Wiki-0123456789abcdef0123456789abcdef` ID страницы —
`0123456789abcdef0123456789abcdef`. Вводите ID, а не полный URL.

Корневая страница всё равно должна быть доступна подключению в Notion.

**4. Проверьте параметры доступа и индексации**

Проверьте, кто имеет доступ к проиндексированному содержимому в Yahont.
**Public**-содержимое доступно всем пользователям Yahont.
Для содержимого с меньшей аудиторией используйте доступные параметры ограниченного доступа. Не считайте,
что предоставление доступа странице подключению Notion сохраняет права каждого пользователя Notion в Yahont.

Выберите **Advanced**, чтобы проверить интервал обновления и параметры очистки. Нажмите **Create Connector**,
чтобы сохранить коннектор и начать индексацию.

## Проверка индексации и использование содержимого

**1. Проверьте результат индексации**

Откройте **Панель администратора → Существующие коннекторы** и выберите коннектор Notion.
Дождитесь завершения запуска индексации. Проверьте число документов и сообщённые ошибки.

![Панель индексации коннектора Yahont со статусом Indexed и одним проиндексированным документом](https://mintcdn.com/yahont-ai/gQVGDVoirOMFHw3D/assets/admins/connectors/notion/onyx-notion-indexed.png?fit=max\&auto=format\&n=gQVGDVoirOMFHw3D\&q=85\&s=806994520012dd00dbf066cc01bf3556)

Если появилось **Some documents failed to index**, откройте **View details**, даже если статус — **Indexed**.
После исправления ошибки выберите **Manage → Re-Index** и выберите нужное обновление или полную переиндексацию.

**2. Найдите известную страницу**

Вернитесь в Yahont и найдите характерную фразу с общей страницы Notion.
Используйте агента с доступом к документам коннектора.
Проверьте источник цитаты и откройте связанную страницу Notion.

**3. Ограничьте агента выбранным содержимым**

Чтобы дать агенту определённую коллекцию, создайте набор документов в **Панель администратора → Наборы документов**.
Включите в него коннектор Notion и выберите этот набор документов в настройках знаний агента.

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

| Проблема | Что проверить |
| - | - |
| Недействительный или просроченный токен (401) | Скопируйте токен заново из нужного подключения Notion и обновите сохранённые учётные данные в Yahont. |
| Недостаточно прав (403) | Проверьте **Read content** и доступ подключения к нужному содержимому. |
| Ресурс не найден (404) | Проверьте ID корневой страницы, рабочее пространство и общий доступ к страницам. Notion может возвращать 404 для содержимого без общего доступа. |
| Нет документов или отсутствуют страницы | Поделитесь исходными страницами и базами данных с подключением. Проверьте, не исключает ли их **Root Page ID**. |
| Ограничение частоты (429) | Подождите, пока ограничение частоты Notion снимется, затем повторите запуск индексации. |
| Содержимое проиндексировано, но отсутствует в ответах | Проверьте доступ пользователя в Yahont и выбранные агентом наборы документов. |

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


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