Настройка SharePoint Embedded в качестве источника знаний Foundry

Применяется к: Для разработчиков

Используйте службу агента Microsoft Foundry с источником знаний SharePoint, если приложению требуется работа агента Grounded с файлами, хранящимися в контейнерах SharePoint Embedded. Содержимое остается в клиенте Microsoft 365 клиента, поэтому применяются требования Microsoft Purview и вы не копируете содержимое во внешнюю векторную базу данных. Для контекста решения см. Наземный ИИ без внешней векторной базы данных.

Для типов контейнеров SharePoint Embedded источник знаний дает ответы с помощью общедоступного API получения Microsoft 365 Copilot. Foundry выполняет вызовы извлечения как часть агента, поэтому применяются те же предварительные требования, поведение индексирования и выставление счетов. Источник sharePointEmbedded данных, который использует Foundry, является ознакомительным. Чтобы вместо этого запустить собственный шаг граундинга, вызовите API Retrieval напрямую, как описано в разделе Использование API Retrieval.

Примечание.

Источники знаний SharePoint для SharePoint Embedded доступны в предварительной версии.

Предварительные условия

Прежде чем начать, убедитесь, что:

  • Приложение SharePoint Embedded по крайней мере с одним контейнером.
  • Идентификатор типа контейнера для приложения SharePoint Embedded.
  • Проект службы агента Microsoft Foundry.
  • Оплата по мере использования настроена для типа контейнера.
  • По крайней мере один пользователь в клиенте с лицензией на Microsoft 365 Copilot, поэтому семантический индекс инициализируется. Дополнительные сведения см. в разделе Семантический индекс для Microsoft 365 Copilot.
  • Разрешение на обновление регистрации типа контейнера в каждом клиенте-потребителе, где агент должен получить доступ к содержимому.

Пользователям, запрашивающим агент, не требуется лицензия Microsoft 365 Copilot. Счета за использование на счетчике сообщений Copilot Studio и платежи соответствуют модели выставления счетов, настроенной для типа контейнера. Дополнительные сведения см. в разделе Счетчики выставления счетов.

Настройка источника знаний SharePoint

Настройте источник знаний Foundry SharePoint с помощью remoteSharePointParameters.containerTypeId идентификатора типа контейнера SharePoint Embedded.

Сведения о конфигурации для конкретного источника см. в статье Свойства источника знаний SharePoint.

Предоставление foundry доступа к типу контейнера

Предоставьте Microsoft Foundry доступ на чтение к типу контейнера в каждом клиенте-потребителе. Идентификатор приложения Foundry: 880da380-985e-4198-81b9-e05b1cc53158.

Приложение-владелец типа контейнера должно вызывать API регистрации в клиенте-потребителе.

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}/applicationPermissionGrants/880da380-985e-4198-81b9-e05b1cc53158
Content-Type: application/json
{
  "delegatedPermissions": ["readContent"],
  "applicationPermissions": ["none"]
}

Замените {fileStorageContainerTypeId} на свой ИД типа контейнера.

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

Проверка извлечения

  1. Отправка поддерживаемых файлов в контейнер SharePoint Embedded.
  2. Дождитесь завершения индексирования.
  3. Войдите в качестве пользователя, который имеет доступ к содержимому контейнера.
  4. Задайте агенту вопрос, на который могут ответить загруженные файлы.
  5. Убедитесь, что ответ основан на ожидаемом контенте SharePoint Embedded.

Если в ответе отсутствуют ожидаемые файлы, выполните проверку:

  • Регистрация типа контейнера в клиенте-потребителе.
  • Разрешение на подачу заявки на литейное производство.
  • Инициализация семантического индекса в клиенте.
  • Доступ пользователя к контейнеру и файлам.
  • Поддерживаемые форматы файлов.
  • Параметры обнаружения контента.
  • Задержка индексирования.

Дальнейшие действия