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

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

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

Добавьте 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, которую использует источник знаний, существующая ссылка может сломаться и привести к разрыву прав. В такой ситуации агент может не получить доступ к базе знаний.

Чтобы восстановить доступ:

1. Попросите вашего администратор SharePoint предоставить соответствующие права на переименованное место и создать новую исходную ссылку.

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

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

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

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

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

3. В разделе «Избранные» или «Загрузка файла» выберите SharePoint.

   

4. Выберите Browse items чтобы найти нужный список, или введите URL конкретного список SharePoint.

   

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

   

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

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

   Note

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

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

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

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

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

По умолчанию Copilot Studio предварительно настраивает агентов для аутентификации пользователей с использованием аутентификации Microsoft для доступа к источникам SharePoint при подключении к агенту через Microsoft Teams, Power Apps или Microsoft 365 Copilot. Однако если вам необходимо вручную настроить аутентификацию, для работы генеративных ответов с источниками данных 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, укажите параметры поискового запроса. Эти параметры запроса определяют, что будет искано в источнике знаний. Например, вы можете указать, что хотите искать только элементы, изменённые за последние шесть месяцев. Построим такой тип фильтра следующим образом:

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

После добавления источника знаний 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.

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

Чтобы использовать переменную на публичном сайте или источнике знаний 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. Они не влияют на то, как контент индексируется или получается.