Индексирование содержимого из SharePoint в Microsoft 365 (предварительная версия)

SharePoint в индексаторе Microsoft 365 (предварительная версия) импортирует документы из библиотек документов SharePoint и делает их доступными для поиска в Поиск с использованием ИИ Azure. Сначала идут шаги настройки, за которыми следуют поведение и сценарии.

В Поиск с использованием ИИ Azure индексатор извлекает данные и метаданные, доступные для поиска, из источника данных. SharePoint в индексаторе Microsoft 365 предоставляет следующие функции:

• Индексирует файлы и метаданные из одной или нескольких библиотек документов.
• Индексирует списки SharePoint и значения полей их элементов, при этом каждый столбец списка доступен в качестве исходного поля для сопоставления полей. Эта возможность доступна в предварительной версии, начиная с REST API 2026-05-01-preview.
• Индексирует страницы сайта ASPX (современные страницы сайта ). Эта возможность доступна в предварительной версии, начиная с REST API 2026-05-01-preview.
• Индексирует смешанное содержимое SharePoint (библиотеки документов, списки и страницы сайта) в одном индексаторе с помощью значения контейнера allSiteContent. Эта возможность доступна в предварительной версии, начиная с REST API 2026-05-01-preview.
• Индексирует содержимое во всех дочерних сайтах, если includeSubsites=true задан в запросе к источнику данных. Эта возможность доступна в предварительной версии, начиная с REST API 2026-05-01-preview.
• Индексы постепенно собирают только новые и измененные файлы, элементы списка, страницы и метаданные.
• Автоматически обнаруживает удаленное содержимое. Удаление файлов, элементов списка или страниц выбирается при следующем запуске индексатора, а соответствующий документ поиска удаляется из индекса.
• Извлекает текст и нормализованные изображения из индексированных документов автоматически. При необходимости можно добавить набор навыков для более глубокого обогащения ИИ, например оптического распознавания символов (OCR) или распознавания сущностей.
• Поддерживает приём документов с базовыми списками управления доступом (ACL) в режиме предварительной версии. Начиная с версии 2026-05-01-preview, изменения ACL обнаруживаются и обновляются постепенно для каждого успешного запуска индексатора для элементов с уникальными разрешениями. Этот выпуск также распространяет обработку ACL на элементы списков, страницы сайта ASPX и группы SharePoint. Сведения об оговорках и шагах по настройке см. в статье Использование индексатора SharePoint для приема метаданных разрешений.
• Поддерживает прием и учет меток конфиденциальности Microsoft Purview во время запроса. Эта функция доступна в предварительной версии.

Необходимые условия

• Заполните форму регистрации индексатора предварительной версии. Регистрация автоматически утверждена.

• Поиск с использованием ИИ Azure, ценовая категория "Базовый" или более поздняя.

• SharePoint в составе облачной службы Microsoft 365 (OneDrive не является поддерживаемым источником данных).

• Файлы в библиотеке документов.

• Visual Studio Code с расширением клиента REST для настройки и запуска конвейера индексатора.

Выбор настройки разрешений

Перед созданием регистрации приложения на шаге 3 определите сценарий в следующей таблице. Обратите внимание на необходимые разрешения Microsoft Graph, разрешения SharePoint API и тип учетных данных. Затем выполните описанные ниже действия, описанные в этой статье, чтобы применить их.

При настройке разрешений рассмотрите следующие сведения:

• Делегированные разрешения подходят только для небольших тестов и не поддерживают загрузку ACL.
• Федеративные учетные данные — рекомендуемый способ аутентификации без использования секретов. Он охватывает как аутентификацию индексатора, так и разрешение групп SharePoint во время выполнения запроса.
• При использовании Sites.Selected предоставьте приложению явный доступ к каждому целевому сайту SharePoint перед индексированием. Согласие администратора для Sites.Selected в Microsoft Entra ID само по себе не предоставляет приложению разрешение на доступ к содержимому сайта. Необходимо также назначить разрешение для каждого целевого сайта. Если вы добавите сайт в источник данных без явного разрешения на доступ к сайту, индексатор завершит работу с ошибкой. См. раздел «Предоставление доступа к сайту при использовании Sites.Selected».

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

SharePoint в индексаторе Microsoft 365 может извлекать текст из следующих форматов документов:

• CSV (см. индексирование BLOB-объектов CSV)
• EML
• EPUB
• GZ
• HTML
• JSON (см Индексация JSON-блоков)
• KML (XML для географических представлений)
• Markdown
• форматы Microsoft Office: DOCX/DOC/DOCM, XLSX/XLS/XLSM, PPTX/PPT/PPTM, MSG (письма Outlook), XML (WORD XML версий 2003 и 2006 годов)
• Форматы открытых документов: ODT, ODS, ODP
• PDF
• Обычные текстовые файлы (см. также индексирование обычного текста)
• RTF
• XML
• ZIP

Ограничения и рекомендации

Ниже приведены ограничения этой функции.

• Файлы записных книжек OneNote не поддерживаются.

• Ограничения добавочного индексирования:

  • Переименование SharePoint папки прерывает добавочное индексирование. Переименованная папка обрабатывается как новое содержимое.

  • Microsoft 365 процессы, обновляющие метаданные файловой системы SharePoint, могут активировать добавочное индексирование, даже если другие изменения в содержимом отсутствуют. Протестируйте настройку перед использованием индексатора или обогащения ИИ. Проверьте, как Microsoft 365 обрабатывает документы.

• Ограничения безопасности:

  • Поддержка частных конечных точек не поддерживается. Безопасная конфигурация сети должна быть включена через брандмауэр.

  • Нет поддержки клиентов с включенным условным доступом Microsoft Entra ID.

  • Поддержка зашифрованных пользователем файлов и ZIP-файлов, защищенных паролем, не поддерживается. Однако зашифрованное содержимое допускается, если оно защищено метками конфиденциальности Microsoft Purview и если конфигурация для сохранения и соблюдения этих меток (предварительная версия) включена.

  • Ограниченная поддержка разрешений доступа на уровне документа. Базовый уровень синхронизации ACL в настоящее время находится в предварительной версии. Дополнительные сведения и настройка см. в документации по конфигурации SharePoint ACL. Сведения о необходимых разрешениях для каждого сценария см. в разделе "Выбор настройки разрешений".

Ниже приведены некоторые рекомендации по использованию этой функции:

• Чтобы создать пользовательское приложение Copilot или приложение дополненной генерации (RAG), которое взаимодействует с данными SharePoint с помощью Azure AI Поиск, Microsoft рекомендует использовать удаленный источник знаний SharePoint. Этот источник знаний использует API извлечения Copilot для запроса текстового содержимого непосредственно из SharePoint в Microsoft 365, возвращая результаты обрабатывающему агенту для объединения, ранжирования и составления ответа. Нет индекса поиска, используемого этим источником знаний, и запрашивается только текстовое содержимое. Поиск с использованием ИИ Azure не реплицирует данные. Он применяет модель разрешений SharePoint, возвращая только результаты, которые каждый пользователь авторизован для просмотра.

• Если вам нужно создать пользовательское приложение Copilot/RAG или агент ИИ для чата с данными SharePoint в рабочих средах, попробуйте сначала создать его непосредственно через Microsoft Copilot Studio. Если Copilot Studio не соответствует вашим потребностям, попробуйте:

  • Создание настраиваемого соединителя с помощью SharePoint веб-перехватчиков, вызовом API Microsoft Graph для экспорта данных в контейнер BLOB-объектов Azure, а затем использование индексатора BLOB-объектов Azure для инкрементного индексирования.

  • Создание собственного рабочего процесса Azure Logic Apps, использующего соединитель Azure Logic Apps SharePoint и соединитель Поиск с использованием ИИ Azure. Коннектор Поиск с использованием ИИ Azure станет доступен, когда сервис перейдёт на стадию общей доступности. Используйте рабочий процесс, созданный мастером портала Azure в качестве отправной точки, а затем настройте его в конструкторе Azure Logic Apps, чтобы добавить необходимые шаги преобразования. Рабочий процесс, который создает мастер Поиск с использованием ИИ Azure, является рабочим процессом потребления. Для рабочих нагрузок перейдите в стандартный рабочий процесс приложения логики для использования дополнительных корпоративных функций.

Независимо от того, какой подход вы выберете, будь то создание пользовательского соединителя с помощью веб-перехватчиков SharePoint или создание рабочего процесса в Azure Logic Apps, обязательно обеспечьте надежную безопасность. Эти меры включают настройку общих частных ссылок, настройку брандмауэров и сохранение разрешений пользователей из источника и соблюдение этих разрешений во время запроса. Также следует регулярно проверять и отслеживать конвейер.

Если вы индексируете ACL SharePoint, ознакомьтесь с поддерживаемыми отношениями между группами. Microsoft Entra группы, вложенные в группы SharePoint, не расширяются.

Настройка SharePoint в индексаторе Microsoft 365

Чтобы настроить SharePoint в индексаторе Microsoft 365, используйте REST API предварительной версии. В этом разделе приведены действия.

(Необязательно) Шаг 1. Включение управляемого удостоверения, назначаемого системой

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

Выполните этот шаг, если сайт SharePoint и служба поиска находятся в одном клиенте Microsoft Entra. Пропустите этот шаг, если они находятся в разных арендаторах Microsoft Entra. Удостоверение используется для обнаружения арендатора. Этот шаг также можно пропустить, если вы хотите поместить идентификатор клиента Microsoft Entra в строка подключения. Чтобы использовать управляемое удостоверение, назначаемое системой или назначаемое пользователем, для индексирования без секрета настройте разрешения приложения с помощью проверки подлинности без секрета.

После выбора "Сохранить" вы получите идентификатор объекта, назначенный службе поиска.

Шаг 2. Определите разрешения, необходимые индексатору

Матрицу принятия решений для сценариев с ACL и без ACL см. в разделе Выбор настройки разрешений. Если вы выбираете делегированные разрешения, маркеры, делегированные пользователем, истекают каждые 75 минут и требуют ручного индексирования с помощью run Indexer (предварительная версия) по истечении срока действия. Делегированные разрешения рекомендуется использовать только для небольших операций тестирования.

Шаг 3. Создание регистрации приложения Microsoft Entra

SharePoint в индексаторе Microsoft 365 использует приложение Microsoft Entra для проверки подлинности. Создайте регистрацию приложения перед настройкой его разрешений и учетных данных.

1. Войдите на портал Azure.

2. Найдите или перейдите к Microsoft Entra ID.

3. На странице "Обзор" нажмите кнопку "Добавить>регистрацию приложения".

   1. Введите имя приложения.
   2. Выберите только один клиент — имя клиента.
   3. Пропустите шаг обозначения URI. URI перенаправления не требуется.
   4. Выберите "Зарегистрировать".

4. В левой области выберите "Управление разрешениями>API".

5. Выберите и добавьте разрешение, а затем выберите Microsoft Graph.

   • Если индексатор использует разрешения API приложения, выберите разрешения приложения.

     • Для стандартного индексирования выберите:

       • Files.Read.All
       • Sites.Read.All

       

     • Если вы включаете прием ACL (предварительная версия), необходимые разрешения зависят от того, какие типы элементов (файлы библиотек документов, элементы списков, страницы ASPX) и какие типы групп (Microsoft Entra или группы сайтов SharePoint) вы индексируете. Перед выполнением этого шага см. статью "Разрешения по ACL". Сводка по кросс-сценариям см. в разделе "Выбор настроек разрешений".

       Использование разрешений приложения означает, что индексатор обращается к сайту SharePoint в контексте службы. Таким образом, при запуске индексатора он имеет доступ ко всему содержимому в клиенте SharePoint, для которого требуется утверждение администратора клиента. Для аутентификации также требуется либо секрет клиента, либо конфигурация без использования секрета. Настройка механизма проверки подлинности описана далее в этой статье в разделе "Доступные методы проверки подлинности" только для разрешений API приложений.

   • Если индексатор использует делегированные разрешения API, выберите делегированные разрешения и выберите:

     • Files.Read.All
     • Sites.Read.All
     • User.Read

     

     Делегированные разрешения позволяют клиенту поиска подключаться к SharePoint под удостоверением безопасности текущего пользователя.

6. Выберите "Предоставить согласие администратора" для имени клиента.

   При использовании разрешений API приложения требуется согласие администратора клиента. Некоторые клиенты блокируются таким образом, чтобы согласие администратора клиента также требовалось для делегированных разрешений API. Если применяется любое условие, администратор клиента должен предоставить согласие для этого приложения Microsoft Entra перед созданием индексатора.

   

7. В левой области выберите "Управление>проверкой подлинности (предварительная версия)".

8. На вкладке Конфигурация URI перенаправления выберите + Добавить URI перенаправления.

   1. Выберите мобильные и настольные приложения.
   2. Выберите https://login.microsoftonline.com/common/oauth2/nativeclient URI перенаправления.
   3. Нажмите Настроить.

9. На вкладке "Параметры" включите переключатель "Разрешить общедоступные потоки клиента " и нажмите кнопку "Сохранить".

10. Настройте метод проверки подлинности индексатора в соответствии с потребностями решения.

Предоставление доступа к сайту при использовании Sites.Selected

Если вы настроили регистрацию приложения с помощью Sites.Selected, выполните следующие действия перед запуском индексатора. Согласие администратора для Sites.Selected в Microsoft Entra ID позволяет приложению использовать только ограниченные разрешения SharePoint. Он не предоставляет доступ ни к одному сайту, пока вы отдельно не назначите разрешение для сайта.

1. В Microsoft Entra ID: добавьте Sites.Selected в регистрацию приложения и предоставьте согласие администратора. Добавьте разрешение в область API, которую требует сценарий, например Microsoft Graph и для сценариев приема ACL, SharePoint.

2. В SharePoint: назначьте приложению роль разрешений для каждого целевого сайта. Для индексирования содержимого предоставьте по крайней мере доступ на чтение.

   Чтобы предоставить разрешение сайта, используйте Microsoft Graph. Замените {siteId} идентификатором сайта:

   POST https://graph.microsoft.com/v1.0/sites/{siteId}/permissions
   Content-Type: application/json
   
   {
     "roles": ["read"],
     "grantedToIdentities": [
       {
         "application": {
           "id": "<application-client-id>",
           "displayName": "<application-display-name>"
         }
       }
     ]
   }
   

   Чтобы предоставить то же разрешение с помощью PnP PowerShell:

   Grant-PnPEntraIDAppSitePermission `
     -AppId "<application-client-id>" `
     -DisplayName "<application-display-name>" `
     -Site "https://<tenant>.sharepoint.com/sites/<site-name>" `
     -Permissions Read
   

Доступные методы проверки подлинности только для разрешений API приложений

Для проверки подлинности приложения Microsoft Entra с разрешениями приложения индексатор использует секрет клиента или конфигурацию без секрета.

Использование секрета клиента

Эти инструкции настраивают приложение для использования секрета клиента для проверки подлинности индексатора, поэтому он может получать данные из SharePoint.

• Выберите сертификаты и секреты в меню слева, а затем выберите секреты клиента и новый секрет клиента.

  

• В всплывающем меню введите описание нового секрета клиента. При необходимости измените дату окончания срока действия. Если срок действия секрета истекает, необходимо повторно создать его и обновить индексатор с новым секретом.

  

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

  

Использование аутентификации без необходимости в секретах для получения токенов приложения

Используйте федеративные учетные данные для входа без секрета клиента. Microsoft Entra позволяет управляемому удостоверению получать маркер приложения, поэтому индексатор может принимать данные из SharePoint без хранимого секрета. В следующем разделе пошагово описывается процесс настройки управляемого идентификатора.

Настройка зарегистрированного приложения с помощью управляемого удостоверения

1. Создайте (или выберите) управляемую идентичность, назначаемую пользователем,, и назначьте её вашей службе поиска, или используйте управляемую идентичность, назначаемую системой, в зависимости от требований вашего сценария.

2. Получите идентификатор объекта (основного). Используйте это значение в рамках конфигурации учетных данных при создании источника данных.

3. Выберите сертификаты и секреты в меню слева.

4. В разделе федеративных учетных данных выберите +Добавить учетные данные.

5. В разделе "Федеративные учетные данные" выберите "Управляемое удостоверение".

6. Выберите управляемое удостоверение: выберите управляемое удостоверение, созданное на шаге 1.

7. Добавьте имя для учетных данных и нажмите кнопку "Сохранить".

Шаг 4. Создание источника данных

Начиная с этого раздела, используйте последнюю предварительную версию REST API и REST-клиент или последний поддерживаемый бета-пакет SDK для остальных шагов.

Источник данных указывает, какие данные следует индексировать, учетные данные и политики для эффективной идентификации изменений данных (новые, измененные или удаленные строки). Несколько индексаторов в одной службе поиска могут использовать один источник данных.

Для индексирования SharePoint источник данных должен иметь следующие обязательные свойства:

• имя — это уникальное имя источника данных в службе поиска.
• тип должен быть "SharePoint". Это значение чувствительно к регистру.
• credentials укажите конечную точку SharePoint и метод проверки подлинности, разрешенный приложению запрашивать маркеры Microsoft Entra. Пример конечной точки SharePoint — https://[your-tenant-name].sharepoint.com/teams/MySharePointSite. Вы можете получить конечную точку, перейдя на домашнюю страницу сайта SharePoint и скопируйв URL-адрес из браузера. Просмотрите формат строка подключения для поддерживаемого синтаксиса.
• контейнер указывает, какую библиотеку документов следует индексировать. Свойства определяют, какие документы индексируются.

Чтобы создать источник данных, вызовите создание источника данных (предварительная версия).

Ниже приведен пример определения источника данных для учетных данных с секретом приложения или управляемым удостоверением, назначенным системой.

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-datasource",
    "type" : "sharepoint",
    "credentials" : { "connectionString" : "[connection-string]" },
    "container" : { "name" : "defaultSiteLibrary", "query" : null }
}

Конфигурации федеративных учетных данных требуют наличия FederatedCredentialApplicationId в строке подключения. Значение отличается по типу удостоверения:

• Управляемый идентификатор, назначаемый системой: задайте FederatedCredentialApplicationId идентификатор приложения (клиента) управляемого идентификатора, назначаемого системой, для службы. Опустите identity блок.
• Управляемая идентификация, назначенная пользователем: заполните блок identity, указав путь к ресурсу управляемой идентификации, назначенной пользователем. Задайте FederatedCredentialApplicationId идентификатор собственного приложения (клиента) управляемого удостоверения, назначаемого пользователем.

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-datasource",
    "type" : "sharepoint",
    "credentials" : { "connectionString" : "[connection-string]" },
    "container" : { "name" : "defaultSiteLibrary", "query" : null },
    "identity": {
      "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
      "userAssignedIdentity": "/subscriptions/[Azure subscription ID]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[user-assigned managed identity]"
    }
}

Формат строки подключения

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

• Формат строки подключения делегированных разрешений API

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID]

• Разрешения API приложений с форматом строки подключения с секретом приложения

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];ApplicationSecret=[Microsoft Entra application client secret];TenantId=[SharePoint site's Microsoft Entra tenant ID]

• Разрешения API для приложения в формате строки подключения без секрета (учетные данные федеративного удостоверения):

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];FederatedCredentialApplicationId=[managed identity's application (client) ID];TenantId=[SharePoint site's Microsoft Entra tenant ID]

В следующей таблице описывается каждое поле строка подключения.

При настройке разрешений рассмотрите следующие сведения:

Для обеспечения обратной совместимости индексатор SharePoint по-прежнему принимает FederatedCredentialObjectId (идентификатор объекта или субъекта безопасности учетных данных федеративной идентификации в приложении приема данных) в строке подключения, поэтому существующие источники данных продолжают работать без изменений. Используйте FederatedCredentialApplicationId для новых и обновлённых источников данных.

Чтобы получить TenantId, откройте центр администрирования Microsoft Entra для клиента, которому принадлежит сайт SharePoint, и скопируйте идентификатор клиента из раздела Обзор.

Вы можете получить управляемое удостоверение object (principal) ID из раздела Настройка зарегистрированного приложения с управляемым удостоверением.

При настройке разрешений рассмотрите следующие сведения:

Если сайт SharePoint и служба поиска находятся в одном клиенте Microsoft Entra и включено управляемое удостоверение, назначаемое системой, вам не нужно включать TenantId в строку подключения. Если они находятся в разных клиентах Microsoft Entra, необходимо включить TenantId.

В следующих примерах показаны источники данных, созданные с помощью FederatedCredentialApplicationId:

Назначаемое системой управляемое удостоверение с федеративными учетными данными:

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
  "name": "sharepoint-ds",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[system-assigned managed identity's application (client) ID]"
  },
  "container": { "name": "defaultSiteLibrary" }
}

Назначаемое пользователем управляемое удостоверение с федеративными учетными данными (один клиент):

{
  "name": "sharepoint-uami-fed",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[user-assigned managed identity application (client) ID]"
  },
  "container": { "name": "defaultSiteLibrary" },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/[subscription-id]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[uami-name]"
  }
}

Межтенантное управляемое удостоверение, назначаемое пользователем, с федеративными учетными данными (расширенный вариант):

Перед использованием этой конфигурации убедитесь, что ваш управляемый идентификатор, назначаемый пользователем, настроен с учетными данными федеративного удостоверения, предусматривающими доверие к многоклиентскому приложению Microsoft Entra. Инструкции по настройке см. в разделе "Настройка зарегистрированного приложения с помощью управляемого удостоверения".

{
  "name": "sharepoint-uami-crosstenantfed",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[multitenant app client ID]"
  },
  "container": { "name": "defaultSiteLibrary" },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/[subscription-id]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[uami-name]",
    "federatedIdentityClientId": "[multi-tenant app client ID]"
  }
}

Используйте межтенантную конфигурацию управляемого удостоверения, назначаемого пользователем, если само это управляемое удостоверение, назначаемое пользователем, настраивает федерацию с мультитенантным приложением Microsoft Entra. В этом случае установите для federatedIdentityClientId в блоке identity значение идентификатора клиента мультитенантного приложения, а для FederatedCredentialApplicationId в строке подключения — идентификатора клиента того же мультитенантного приложения. Установка значения FederatedCredentialApplicationId в собственный идентификатор клиента управляемого удостоверения, назначаемого пользователем, в этом сценарии не проходит проверку.

Если ваш индексатор использует конфигурацию ACL SharePoint (предварительная версия) или сохранение и соблюдение меток конфиденциальности Microsoft Purview (предварительная версия), ознакомьтесь с соответствующими статьями перед созданием индексатора. Каждая функция имеет определенные этапы настройки источника данных, индекса и набора навыков.

Шаг 5. Создание индекса

Индекс задает поля в документе, атрибутах и других конструкциях, которые формируют интерфейс поиска.

Чтобы создать индекс, вызовите create Index (preview):

POST https://[service name].search.windows.net/indexes?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-index",
    "fields": [
        { "name": "id", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "metadata_spo_item_name", "type": "Edm.String", "key": false, "searchable": true, "filterable": false, "sortable": false, "facetable": false },
        { "name": "metadata_spo_item_path", "type": "Edm.String", "key": false, "searchable": false, "filterable": false, "sortable": false, "facetable": false },
        { "name": "metadata_spo_item_content_type", "type": "Edm.String", "key": false, "searchable": false, "filterable": true, "sortable": false, "facetable": true },
        { "name": "metadata_spo_item_last_modified", "type": "Edm.DateTimeOffset", "key": false, "searchable": false, "filterable": false, "sortable": true, "facetable": false },
        { "name": "metadata_spo_item_size", "type": "Edm.Int64", "key": false, "searchable": false, "filterable": false, "sortable": false, "facetable": false },
        { "name": "content", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false }
    ]
}

Шаг 6. Создание индексатора

Индексатор подключает источник данных с целевым индексом поиска и предоставляет расписание для автоматизации обновления данных. Создав источник данных и индекс, создайте индексатор.

Чтобы создать индексатор, выполните следующие действия.

1. Отправьте запрос создания индексатора (предварительная версия):

   POST https://[service name].search.windows.net/indexers?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   
   {
       "name" : "sharepoint-indexer",
       "dataSourceName" : "sharepoint-datasource",
       "targetIndexName" : "sharepoint-index",
       "parameters": {
       "batchSize": null,
       "maxFailedItems": null,
       "base64EncodeKeys": null,
       "maxFailedItemsPerBatch": null,
       "configuration": {
           "indexedFileNameExtensions" : ".pdf, .docx",
           "excludedFileNameExtensions" : ".png, .jpg",
           "dataToExtract": "contentAndMetadata"
         }
       },
       "schedule" : { },
       "fieldMappings" : [
           { 
             "sourceFieldName" : "metadata_spo_site_library_item_id", 
             "targetFieldName" : "id", 
             "mappingFunction" : { 
               "name" : "base64Encode" 
             } 
            }
       ]
   }
   

   Для источников данных, использующих значения контейнера allSiteLists, allSitePages или allSiteContent, сопоставляйте metadata_spo_site_asset_item_id вместо metadata_spo_site_library_item_id.

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

2. При создании индексатора в первый раз запрос создания индексатора (предварительная версия) ожидает завершения следующего шага. Вы должны вызвать Get Indexer Status, чтобы получить ссылку и ввести новый код устройства.

   GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

   Если вы не вызовете Get Indexer Status в течение 10 минут, срок действия кода истечет, и вам потребуется заново создать источник данных.

3. Скопируйте код входа на устройстве из ответа Get Indexer Status. Код входа устройства можно найти в файле errorMessage.

   {
       "lastResult": {
           "status": "transientFailure",
           "errorMessage": "To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code <CODE> to authenticate."
       }
   }
   

4. Введите код, включенный в сообщение об ошибке.

   

5. Индексатор SharePoint в Microsoft 365 получает доступ к контенту SharePoint от имени вошедшего в систему пользователя. Пользователь, который выполняет вход на этом этапе, — это пользователь, уже вошедший в систему. Таким образом, если вы входите с помощью учетной записи пользователя, у которой нет доступа к документу в библиотеке документов, которую вы хотите индексировать, индексатор не имеет доступа к данному документу.

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

6. Утвердить запрошенные разрешения.

   

7. Начальный запрос создания индексатора (предварительная версия) завершается, если все предоставленные ранее разрешения являются правильными и в течение 10-минутного периода времени.

При настройке разрешений рассмотрите следующие сведения:

Если для приложения Microsoft Entra требуется одобрение администратором и оно не было одобрено до входа в систему, может появиться следующий экран. Для продолжения требуется утверждение администратора.

Шаг 7. Проверка состояния индексатора

После создания индексатора вызовите состояние индексатора:

GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

GET https://[service-name].search.windows.net/indexes/[index-name]/docs?search=*&$count=true&api-version=2026-08-01-preview
api-key: [admin-api-key]

Обновление источника данных

Если вы не обновите объект источника данных, индексатор будет запускаться по расписанию без участия пользователя.

При изменении источника данных во время истечения срока действия кода устройства войдите еще раз, чтобы запустить индексатор. Например, если вы измените запрос источника данных, снова войдите в систему с помощью https://microsoft.com/devicelogin и получите новый код устройства.

Чтобы обновить источник данных, выполните следующие действия, если истек срок действия кода устройства:

1. Запустите Запуск индексатора (предварительная версия), чтобы вручную начать запуск индексатора.

   POST https://[service name].search.windows.net/indexers/sharepoint-indexer/run?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

2. Проверьте состояние индексатора.

   GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

3. Если вы получите сообщение об ошибке с просьбой посетить https://microsoft.com/devicelogin, откройте страницу и скопируйте новый код.

4. Вставьте код в диалоговое окно.

5. Повторно запустите индексатор вручную и проверьте состояние индексатора. На этот раз индексатор должен успешно запуститься.

Метаданные индекса документа

Если индексировать метаданные документа ("dataToExtract": "contentAndMetadata"), можно использовать следующие метаданные для индексирования.

SharePoint в индексаторе Microsoft 365 также поддерживает метаданные, относящиеся к каждому типу документа. Дополнительные сведения см. в разделе Свойства метаданныхContent, используемые в Поиск с использованием ИИ Azure.

При настройке разрешений рассмотрите следующие сведения:

Чтобы индексировать пользовательские метаданные, укажите "additionalColumns" в параметре запроса источника данных.

Индексировать списки SharePoint

списки SharePoint индексируются в предварительной версии, начиная с REST API 2026-05-01-preview. Задайте источнику container.nameallSiteLists данных индексировать все элементы списка с сайта или allSiteContent объединить элементы списка с библиотеками документов и страницами сайта в одном индексаторе. Чтобы включить списки дочерних сайтов, добавьте includeSubsites=true в container.query.

Для индексаторов на основе списка или со смешанным содержимым поле ключа индексации должно быть сопоставлено с metadata_spo_site_asset_item_id. Содержимое элемента списка отображается в content поле в виде значений полей в формате JSON, а стандартные metadata_spo_item_* поля (напримерmetadata_spo_item_namemetadata_spo_item_weburi, и metadata_spo_item_last_modified) заполняются для каждого элемента списка.

Сопоставьте столбцы списка с полями индекса

Каждый столбец, заданный в список SharePoint, отображается в качестве исходного поля с тем же именем, что и столбец SharePoint. Используйте сопоставления полей для сопоставления каждого столбца с полем индекса.

Например, рассмотрим список SharePoint со следующими столбцами.

Добавьте соответствующие поля в определение индекса, а затем сопоставите каждый столбец с целевым полем в индексаторе:

{
  "name": "my-sharepoint-list-indexer",
  "dataSourceName": "my-sharepoint-list-ds",
  "targetIndexName": "products-index",
  "fieldMappings": [
    {
      "sourceFieldName": "metadata_spo_site_asset_item_id",
      "targetFieldName": "id",
      "mappingFunction": { "name": "base64Encode" }
    },
    { "sourceFieldName": "Title", "targetFieldName": "productName" },
    { "sourceFieldName": "Price", "targetFieldName": "price" },
    { "sourceFieldName": "InStock", "targetFieldName": "available" },
    { "sourceFieldName": "Category", "targetFieldName": "category" },
    { "sourceFieldName": "metadata_spo_item_last_modified", "targetFieldName": "lastUpdated" },
    { "sourceFieldName": "metadata_spo_item_weburi", "targetFieldName": "itemUrl" }
  ]
}

Убедитесь, что каждое целевое поле существует в индексе с совместимым типом (например, Edm.String для TitleEdm.Double или Edm.Int64 для Price, Edm.Boolean для InStock).

Индекс страниц сайта ASPX

Вы можете индексировать современные страницы сайта ASPX в предварительной версии, начиная с REST API 2026-05-01-preview. Задайте источнику container.nameallSitePages данных индексировать все страницы с сайта или allSiteContent объединить страницы с библиотеками документов и списками в одном индексаторе. Чтобы включить страницы подсайта, добавьте includeSubsites=true в container.query.

Для индексаторов на основе страниц или со смешанным содержимым поле ключа индекса должно быть сопоставлено с metadata_spo_site_asset_item_id. Текст страницы извлекается в поле content, а для каждой страницы заполняются стандартные поля metadata_spo_item_* (например, metadata_spo_item_name, metadata_spo_item_weburi и metadata_spo_item_last_modified).

Включение или исключение по типу файла

Задайте критерии включения и исключения в разделе "параметры" определения индексатора, чтобы управлять индексированием файлов.

Чтобы включить определённые расширения файлов, установите значение "indexedFileNameExtensions" на список расширений файлов, разделённых запятыми, с точкой в начале. Чтобы исключить определенные расширения файлов, задайте "excludedFileNameExtensions" для расширений, которые требуется пропустить. Если одно и то же расширение отображается в обоих списках, индексатор исключает его из индексирования.

PUT /indexers/[indexer name]?api-version=2026-08-01-preview
{
    "parameters" : { 
        "configuration" : { 
            "indexedFileNameExtensions" : ".pdf, .docx",
            "excludedFileNameExtensions" : ".png, .jpeg" 
        } 
    }
}

Выберите, какие документы индексируются

Индексатор SharePoint в Microsoft 365 может индексировать содержимое из одной или нескольких библиотек документов. Чтобы указать, какие сайты и библиотеки документов необходимо индексировать, используйте параметр container в определении источника данных.

Раздел источника данных "контейнер" имеет два свойства для этой задачи: "имя" и "запрос".

Имя

Свойство name является обязательным и должно быть одним из следующих значений:

Для источников данных, использующих allSiteLists, allSitePages или allSiteContent, сопоставление поля ключа индексатора должно использовать metadata_spo_site_asset_item_id вместо metadata_spo_site_library_item_id. Дополнительные сведения см. в шаге 6. Создание индексатора.

Запрос

Параметр "query" источника данных состоит из пар ключевых слов и значений. Используйте следующие ключевые слова. Значения — URL-адреса сайта или URL-адреса библиотеки документов.

При настройке разрешений рассмотрите следующие сведения:

Чтобы получить значение для определенного ключевого слова, перейдите в библиотеку документов, которую вы хотите включить или исключить, и скопируйте URI из браузера. Этот метод является самым простым способом получения значения для использования с ключевым словом в запросе.

Управление ошибками

Сведения о сообщении Invalid AAD tenant, отсутствии идентификатора клиента Microsoft Entra или несоответствии клиента, которые отображаются в истории выполнения индексатора, см. в разделе Устранение распространенных ошибок и предупреждений индексатора.

По умолчанию SharePoint в Microsoft 365 индексатор останавливается, как только он обнаруживает документ с неподдерживаемым типом контента, например изображением. excludedFileNameExtensions Используйте параметр, чтобы пропустить определенные типы контента. Однако вам может потребоваться индексировать документы, не зная все возможные типы контента заранее. Чтобы продолжить индексирование при обнаружении неподдерживаемого типа контента, задайте failOnUnsupportedContentType для параметра конфигурации значение false:

PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    ... other parts of indexer definition
    "parameters" : { "configuration" : { "failOnUnsupportedContentType" : false } }
}

Для некоторых документов Поиск с использованием ИИ Azure не может определить тип контента или не может обрабатывать документ другого поддерживаемого типа контента. Чтобы игнорировать этот режим сбоя, задайте failOnUnprocessableDocument для параметра конфигурации значение false:

"parameters" : { "configuration" : { "failOnUnprocessableDocument" : false } }

Исходные файлы SharePoint используют общие ограничения на размер исходного файла и число извлечённых символов для индексаторов типа BLOB. По умолчанию документы слишком большого размера считаются ошибками. Однако можно по-прежнему индексировать метаданные хранилища избыточных документов, если для параметра конфигурации задано indexStorageMetadataOnlyForOversizedDocuments значение true:

"parameters" : { "configuration" : { "indexStorageMetadataOnlyForOversizedDocuments" : true } }

Если вы добавляете набор навыков, отдельно проверьте для каждого навыка ограничения на входные данные и ограничения нижестоящих служб. Навык может принимать меньше данных, чем извлекает индексатор SharePoint.

Кроме того, можно продолжить индексирование, если ошибки происходят в любой момент обработки, либо при анализе документов, либо при добавлении документов в индекс. Чтобы игнорировать определенное количество ошибок, задайте параметры конфигурации maxFailedItems и maxFailedItemsPerBatch требуемым значениям. Например:

{
    ... other parts of indexer definition
    "parameters" : { "maxFailedItems" : 10, "maxFailedItemsPerBatch" : 10 }
}

Связанное содержимое

• видео YouTube: SharePoint в индексаторе Microsoft 365
• Индексаторы в Поиск с использованием ИИ Azure
• свойства метаданных Content, используемые в Поиск с использованием ИИ Azure
• Индексируйте содержимое SharePoint и другие источники в Поиске Azure AI с помощью коннекторов Logic Apps от Azure
• Настройка для Ingest SharePoint ACL (предварительный просмотр)
• Синхронизировать списки контроля доступа (ACL) SharePoint с индексом
• Настроить поддержку групп SharePoint
• Сохраняйте и уважайте метки чувствительности Microsoft Purview (предварительная версия)