SharePoint источники знаний не возвращают результаты Copilot Studio

Сводка

В этой статье показано, как устранить неполадки, в которых SharePoint источники знаний не возвращают результаты Microsoft Copilot Studio. При настройке источника данных SharePoint несколько факторов могут запретить агенту предоставлять ответ. К этим факторам относятся отсутствующие результаты поиска, разрешения пользователя, защищенное содержимое, проблемы регистрации приложений, ограничения размера файла, условия фильтрации или фильтрация модерации содержимого. В таких случаях агент может вернуть сообщение, например "Я не уверен, как помочь с этим. Можете ли вы попробовать перефразировку?"

Copilot Studio предоставляет два способа настройки SharePoint в качестве источника знаний, и в этой статье рассматриваются оба метода:

• Источник знаний на уровне агента. Добавьте из диалогового окна "Добавление знаний " на страницах обзора, знаний или свойств агента. Этот путь поддерживает SharePoint сайты (URL-адреса) и списки SharePoint, обрезку меток конфиденциальности и условия фильтрации. Дополнительные сведения см. в разделе "Добавление SharePoint в качестве источника знаний".
• Источник знаний на уровне раздела. Добавьте в узел создания генеривных ответов в разделе. Этот путь связывает узел с URL-адресом SharePoint. Дополнительные сведения см. в разделе "Использование SharePoint содержимого для создания ответов".

Результаты поиска отсутствуют в SharePoint

При Copilot Studio поиске SharePoint используется только три лучших результата поиска для суммирования и создания ответа. Если результаты поиска не возвращаются, агент не предоставляет ответ. Copilot Studio использует индексирование Поиск (Майкрософт) и применяет определенные ограничения в макетах страниц, компонентах и форматах файлов, используемых для создания ответов.

Исправление отсутствующих результатов поиска SharePoint

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

2. Для создания ответов используются только документы в поддерживаемых форматах .

3. Убедитесь, что SharePoint страницы, которые вы ожидаете, что агент будет использовать следующие ограничения:

   • Современные страницы: Поддерживаются только современные страницы SharePoint. Современные страницы, содержащие компоненты SharePoint Framework (SPFx), не поддерживаются.
   • Классические страницы: Содержимое из классических .aspx страниц на SharePoint не используется для создания ответов.
   • Полный список технических границ см. в SharePoint ограничениях веб-приложения.

4. Возможно, что документы недавно были отправлены в SharePoint и еще не индексированы. Некоторые параметры также могут препятствовать отображению некоторых сайтов в результатах поиска. Дополнительные сведения см. в разделе "Результаты поиска, отсутствующие в SharePoint Online".

   Как проверить

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

   Как исправить

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

Отсутствуют разрешения пользователя для SharePoint

Copilot Studio учитывает Безопасность Microsoft 365 обрезку. Как минимум, у пользователя должны быть разрешения на чтение на соответствующих сайтах и файлах или не возвращаются результаты поиска.

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

Проверка разрешений SharePoint пользователей

1. Чтобы убедиться, что затронутый пользователь перейдет непосредственно к точному SharePoint пути к документу, чтобы убедиться, что он может открыть файл.
2. Протестируйте запрос с помощью той же учетной записи пользователя в Microsoft 365 Copilot Chat. Если Microsoft 365 Copilot Chat не удается получить ответ, он подтверждает разрешение или барьер индексирования поиска.

Исправление отсутствующих разрешений SharePoint пользователей

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

Содержимое защищено метками конфиденциальности, DKE или паролем

SharePoint источник знаний уровня агента учитывает метки конфиденциальности для обрезки разрешений и только содержимое, разрешенное метками для вошедшего пользователя. Однако агент не может извлечь или заземлить контент, защита которого шифрует файл. Это ограничение включает метки чувствительности, применяющие шифрование, шифрование с двойным ключом (DKE) и файлы с паролем.

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

Проверка защищенного содержимого SharePoint

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

Исправление защищенного содержимого SharePoint

• Удалите метку конфиденциальности шифрования, защиту DKE или пароль из файла, если это разрешено политикам вашей организации.
• Опубликуйте незащищенную копию требуемого содержимого в SharePoint расположении, к которому агент может получить доступ.
• Укажите источник знаний в расположение SharePoint, которое не содержит зашифрованное содержимое.

Ссылка на источник SharePoint разбита после переименования

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

Исправлена сломанная ссылка на источник SharePoint

1. Попросите администратора SharePoint предоставить соответствующие права на переименованное расположение и сгенерировать новую ссылку на источник.
2. Откройте агент и обновите источник знаний SharePoint по вновь созданной ссылке.

Регистрация приложения или агент неправильно настроены для SharePoint

Когда администраторы настраивают SharePoint источники знаний, они должны настроить проверку подлинности с помощью регистрации приложения Microsoft Entra ID и настроить дополнительные области. Как минимум, регистрация приложения должна указывать Sites.Read.All и Files.Read.All области, а также добавлять эти области в параметры проверки подлинности агента вместе profile с другими openid. Если области отсутствуют из регистрации приложения или из параметров проверки подлинности агента или если согласие не предоставлено требуемым областям, агент не возвращает результаты, ни ошибки или исключения. Для пользователя он отображается так, как если бы документы не были найдены.

Исправлена неправильно настроенная регистрация приложения или проверка подлинности агента

Добавьте необходимые области в регистрацию приложения и параметры проверки подлинности агента и предоставьте согласие.

В следующем примере приведена ссылка на хорошо настроенную регистрацию приложения:

В следующем примере показаны необходимые параметры проверки подлинности в Copilot Studio:

Ограничения размера файла для SharePoint генеривных ответов

Для источников SharePoint, если у вас нет лицензии Microsoft 365 Copilot в том же клиенте, что и ваш агент, генерируемые ответы могут обрабатывать только файлы размером до 7 МБ. Кроме того, необходимо отключить заземление графа клиента с параметром семантического поиска .

Если у вас есть лицензия Microsoft 365 Copilot в том же клиенте, что и агент, максимальный размер файла составляет 200 МБ. Кроме того, необходимо включить заземление графа клиента с помощью семантического параметра поиска .

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

Список ограничений и поддерживаемых функций SharePoint см. в разделе Ограничения веб-приложения SharePoint.

Устранение проблем с размером файлов для генеративных ответов SharePoint

Если файлы, относящиеся к опыту общения, превышают ограничение размера, вам может потребоваться изучить альтернативные архитектуры, например использование семантического индексирования Microsoft 365 или подключение данных к Azure OpenAI для создания ответов.

список SharePoint источник не возвращает результаты

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

• Требуется поиск по данным. Copilot Studio агентам требуется поиск Dataverse для использования список SharePoint в качестве источника знаний. Если поиск dataverse отключен в среде, список не может запрашиваться, и результаты не возвращаются. Дополнительные сведения о включении поиска Dataverse см. в разделе "Настройка поиска Dataverse" для вашей среды.
• Размер списка влияет на качество и задержку. Списки, содержащие более 35 000 строк, могут снизить качество результатов и увеличить задержку, которая может представлять собой отсутствие ответа на иначе допустимые запросы.
• Слишком много списков на одном агенте. Вы можете выбрать до 10 списков за раз и, чтобы получить наилучшие результаты, использовать не более 10 списков на агент. Добавление дополнительных списков повышает вероятность того, что соответствующее содержимое не отображается.
• Список не отображается в последних списках. Если список SharePoint с общим доступом в браузере не отображаются в моих спискахили последних списках, откройте список в SharePoint один раз, чтобы он отображался в последних списках, или вставьте URL-адрес списка непосредственно в выбор URL-адреса при добавлении источника.

Устранение проблем с источником список SharePoint

1. Попросите администратора включить поиск Dataverse в среде, в которой выполняется агент.
2. Уменьшите количество строк в списке или разбиите большие списки на небольшие ориентированные списки.
3. Уменьшите количество списков, подключенных к агенту, до 10 или меньше, сохраняя только списки, относящиеся к разделам, поддерживаемым агентом.
4. Повторно добавьте списки, вставив URL-адрес, если они не отображаются автоматически в последних списках.

Условия фильтрации исключают ожидаемое содержимое

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

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

Проверка условий фильтра

1. На странице "Знания" выберите источник SharePoint, а затем выберите "Изменить>дополнительные параметры", чтобы просмотреть все условия активного фильтра и значения, которые они разрешают.
2. В разделе, на котором размещен узел создания ответов, откройтеисточник данных> узла и убедитесь, что выбран параметр поиска только выбранных источников и выбранные определенные источники.

Исправление условий фильтра

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

Содержимое, заблокированное модерированием содержимого в Copilot Studio

Когда они создают ответы, агенты Copilot Studio модерируют содержимое, которое попадает под категории вреда. Когда содержимое проходит модерацию, генеративные ответы не предоставляют ответ и не указывают на то, что содержимое было модерировано. Однако события модерации регистрируются при настройке агента для отправки данных телеметрии в Azure Application Insights.

После подключения агента к приложение Azure Insights можно использовать следующий запрос языка запросов Kusto (KQL), чтобы узнать, было ли отфильтровано содержимое:

customEvents
| extend cd = todynamic(customDimensions)
| extend conversationId = tostring(cd.conversationId)
| extend topic = tostring(cd.TopicName)
| extend message = tostring(cd.Message)
| extend result = tostring(cd.Result)
| extend SerializedData = tostring(cd.SerializedData)
| extend Summary = tostring(cd.Summary)
| extend feedback = tostring(todynamic(replace_string(SerializedData,"$","")).value)
| where name == "GenerativeAnswers" and result contains "Filtered"
| where cloud_RoleInstance == "myCopilot"
| project cloud_RoleInstance, name, timestamp, conversationId, topic, message, result, feedback, Summary
| order by timestamp desc

В следующем примере запрос KQL подчеркивает попытку использования генеративных ответов, отфильтрованных по модерации контента.

Исправлена проблема, из-за которой модерация контента блокировала генеративные ответы

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

• Если вы считаете, что содержимое не должно быть модерировано, обратитесь в службу поддержки Microsoft клиентов.

Связанные материалы

• Добавление SharePoint в качестве источника знаний
• Использование содержимого SharePoint для создания ответов
• Настройка генеративных ответов в SharePoint
• ограничения веб-приложения SharePoint
• Общий доступ и разрешения в современном интерфейсе SharePoint
• Устранение ошибок фильтра содержимого ИИ