Добавьте SharePoint как источник знаний

SharePoint как источник знаний работает, связывая вашего агента с SharePoint URL или списками SharePoint. В этой статье рассматривается полная функциональность интеграции с SharePoint, предоставляемая выбором опции SharePoint в диалоге «Добавление знаний ».

Note

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

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

• Чтобы добавить отдельные файлы или папки SharePoint, смотрите раздел « Добавить файлы и папки SharePoint».

• Ответы агентов, которые используют SharePoint в качестве источника знаний, не включаются в расшифровки разговоров.

• Для агентов, основанных на SharePoint источниках знаний, Turn on Work IQ обеспечивает лучшее качество поиска знаний и реагирования. Эта функция использует передовые внутренние инструменты поиска, которые позволяют агенту получать больший объём контекста с большей точностью. Однако из-за возросшей сложности системы некоторые пользователи и запросы могут испытывать небольшое увеличение задержки.

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

Note

Можно использовать генеративные ответы с данными SharePoint в чатах Microsoft Teams и не требовать ручной аутентификации. Чтобы использовать этот метод для ранее опубликованного агента, перенастройте агент для использования Проверка подлинности в Microsoft, затем снова опубликуйте его в Microsoft Teams. Прежде чем изменение вступит в силу, может пройти несколько часов. Если пользователь находится в середине разговора и кажется, что изменение не вступило в силу, он может ввести в чате «начать сначала», чтобы перезапустить разговор с последней версией агент. Эти изменения теперь доступны для чатов Teams 1:1 между пользователем и агент. Они пока недоступны для групповых чатов и сообщений канала.

Если вам нужна ручная аутентификация для вашего агента, см. раздел Расширенные сценарии аутентификации.

Добавьте SharePoint в качестве источника знаний

Когда пользователь задает вопрос, а у агент нет темы для ответа, агент выполняет поиск по URL-адресу и всем подпутям. Например, такой URL-адрес, как contoso.sharepoint.com/sites, также включает подпути, такие как contoso.sharepoint.com/sites/policies. Генеративные ответы суммируют этот контент в целевой ответ.

Чтобы добавить сайт SharePoint в качестве источника знаний, выполните следующие шаги:

1. Откройте агент.

2. Выберите Add knowledge либо на страницах Обзор , либо Знания , либо в Свойствахузла генеративных ответов.

3. В разделе «Избранное » выберите SharePoint.

   

4. Укажите URL-адрес SharePoint. Разделяйте несколько URL-адресов с помощью переносов строк вручную (используйте Shift + ВВОД). Чтобы использовать переменную вместо статического URL, выберите значок выбора переменной рядом с полем URL и выберите переменную Пользовательская, Системная или Окружающая переменная.

5. Добавьте имя и описание. Описание должно быть как можно более подробным, особенно если включен генеративный ИИ, так как описание помогает генеративной оркестрации.

6. Выберите Add to agent , чтобы завершить добавление источника знаний.

Добавьте списки SharePoint в качестве источника знаний

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

1. Откройте агент.

2. Выберите Add knowledge либо на страницах Обзор , либо Знания , либо в Свойствахузла генеративных ответов.

3. В разделе «Избранное » выберите SharePoint.

4. Выберите «Просмотр элементов », чтобы найти нужный список, или введите URL конкретного сайта SharePoint.

   

5. Когда вы выбираете «Просмотр элементов», диалог автоматически заполняется «Мои списки » и «Недавние списки». Мои списки отображают только списки, созданные в приложении SharePoint Lists. Все остальные списки отображаются в Recent Lists. Если вы не видите нужный список, откройте SharePoint и откройте этот список, и он появится в Recent Lists.

   

   Вы можете выбрать до 15 списков одновременно. Каждый список добавляется в источники знаний агента как отдельные элементы. Чтобы добавить больше списков в агента, повторите эти шаги и выберите новые списки.

   Note

   Если вы хотите использовать список SharePoint с общим доступом, но он не отображается в Recent Lists, вставьте URL списка в выбранный URL.

6. После выбора нужных списков выберите «Подтвердить выбор».

7. Добавьте имя и описание. Описание должно быть как можно более подробным, особенно если включен генеративный ИИ, так как описание помогает генеративной оркестрации.

8. Выберите Add to agent , чтобы завершить добавление источника знаний.

Расширенные сценарии аутентификации

По умолчанию Copilot Studio предварительно настраивает агентов для аутентификации пользователей с использованием аутентификации Microsoft для доступа к источникам SharePoint при подключении к агенту через Microsoft Teams, Power Apps или Microsoft 365 Copilot. Однако если вам необходимо вручную настроить аутентификацию, для работы генеративных ответов с источниками данных SharePoint необходимо выполнить следующие шаги.

Important

Если включен Ограниченный поиск в SharePoint, использование SharePoint заблокировано.

• Генеративные ответы из источников SharePoint недоступны гостям в приложениях с поддержкой SSO.

• Для аутентификации агента см. раздел Проверка подлинности.

• Инструкции по созданию необходимой регистрации приложения Microsoft Entra ID см. в разделе Настройка аутентификации пользователей с Microsoft Entra ID. При создании этой регистрации вы или ваш администратор должны указать области Sites.Read.All и Files.Read.All в регистрации приложения Microsoft Entra ID.

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

• При настройке проверки подлинности области управляют доступом пользователей. Укажите Sites.Read.All и Files.Read.All в поле областей рядом с существующими значениями profile и openid в Copilot Studio. Эти области не дают пользователям повышенные разрешения при использовании агента, но разрешают разрешимый контент из сайта SharePoint, настроенного для генеративных ответов.

• SharePoint поддерживает ручную настройку аутентификации со следующими поставщиками сервисов аутентификации:

  • Майкрософт Ентра айди
  • Microsoft Entra ID V2 с федеративными учетными данными
  • Microsoft Entra ID V2 с сертификатами
  • Microsoft Entra ID V2 с клиентскими секретами

• SharePoint не поддерживает ручную аутентификацию с использованием Generic OAuth.

• Эта конфигурация применяются только к генеративным ответам и не применяются к соединителям Power Platform.

Фильтруйте исходный код SharePoint

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

Attribute	Operator	Value
Modified on	on or after	X date

Создание условий фильтра

После добавления источника знаний SharePoint можно задать условия поиска.

1. На странице Knowledge выберите исходный код SharePoint.

2. Выберите три точки (...) для исходного файла SharePoint и выберите Редактировать.

3. Выберите Расширенные параметры.

4. Создайте фильтры так, чтобы включать или исключать информацию из источника знаний SharePoint. Фильтр можно основывать на одном из следующих вариантов:

   • Заголовок
   • Author
   • Кем изменено
   • Когда изменено

5. Вы можете установить значение условия на одно из следующих значений:

   • Статическое значение
   • Ввод переменной, который пользователь вводит во время разговора с агентом, затем сохраняется как пользовательская глобальная переменная
   • Системная переменная

6. Выберите Сохранить , когда закончите настраивать фильтры.

Больше настроек для улучшения поиска

Если вы хотите отфильтровать источник SharePoint, отключите следующие настройки:

• Поиск в Интернете
• На уровне агента настройка «Использовать общие знания » в настройках Generative AI агента
• На уровне темы Позволяет ИИ использовать собственные общие знания (превью) в узле генеративных ответов

Отключение этих настроек гарантирует, что агент ответит «нет ответа», если не может найти результат в отфильтрованном источнике знаний SharePoint.

Используйте переменные в качестве URL

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

Вместо создания нескольких источников знаний для разных сценариев определите один источник знаний и вставьте переменную в URL. Во время выполнения Copilot Studio разрешает переменную и использует полученный URL для заземления.

Поддержка переменных

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

Используйте переменную, чтобы:

• Добавьте путь к базовому URL

  https://www.contoso.com/{variable}

• Заменить весь URL

  {variable}

Во время выполнения переменная разрешается в строковое значение. Источник знаний ограничен по разрешенному URL.

Note

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

Создайте и установите переменную

Чтобы использовать переменную на публичном сайте или источнике знаний SharePoint:

1. Создайте строковую переменную с глобальным масштабом.

2. Задайте значение переменной с помощью одного из следующих вариантов:

   • Входные темы
   • Свойства профиля пользователя, такие как язык
   • переменные среды
   • Потоки агентов или разъёмы

3. Вставьте переменную в поле URL, выбрав {x} (Вставить переменную).

4. Проверьте агент, чтобы убедиться, что переменная разрешается на ожидаемом URL.

Пример: область действия по продукту

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

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

2. Добавьте узел значения переменной Set после узла триггера и создайте новую переменную с именем ProductTable.

3. Используйте формулу Power Fx для определения и сопоставления названий продуктов с путями URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Добавьте ещё один узел значения переменной Set и используйте его для создания новой глобальной переменной типа строки с именем GlobalProductURL.

5. В настройках значения To выберите Формулу и используйте функцию Power Fx для поиска в таблице на основе значения Product входной переменной Topic.Product, следующим образом:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Используйте переменную в URL источника знаний:

   https://www.microsoft.com/en-us/{GlobalProductURL}

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

Распространенные сценарии

Используйте переменные в публичных источниках знаний на сайтах для:

• Маршрутизация на основе продукта: Объем запросов к конкретной документации продукта.

• Региональная или языковая фильтрация: сопоставьте User.Language с локализованными URL (например, en-us, it-it).

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

Рекомендации

• Источники знаний на публичных сайтах используют поиск в Bing и опираются на индексированный контент.
• Ограничения по глубине URL всё равно действуют при использовании переменных.
• Переменные меняют только целевой URL. Они не влияют на то, как контент индексируется или получается.

Important

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