Использование контента SharePoint для генеративных ответов

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

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

Использование SharePoint узле генеративных ответов

1. В теме добавьте узел генеративных ответов.

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

   1. В узле Создать генеративные ответы выберите Изменить в разделе Источники данных.

      

   2. Альтернативно, в узле «Создать генеративные ответы » выберите три точки (...), затем «Свойства » и « Источник данных».

3. В разделе «Источники знаний» выберите « Добавить знания». Убедитесь, что включён поиск только выбранных источников .

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

   

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

   Note

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

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

7. Выберите Сохранить вверху, чтобы сохранить изменения темы.

8. Протестируйте свой агент с фразами, которые, как вы ожидаете, вернут контент.

   Note

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

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

По умолчанию 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.