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

Примечание.

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

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

Important

Источники знаний, определенные в узлах генеративных ответов, имеют приоритет над источниками знаний на уровне агента. Источники уровня агент функционируют как запасной вариант. Инструкции по добавлению SharePoint в качестве источника знаний на уровне агента см. в разделе Добавление SharePoint в качестве источника знаний. Когда SharePoint используется как источник знаний, расшифровки разговоров включают вопрос и содержимое исходных документов, использованных для генерации ответа (поле search_results). Однако ответ не включен (отмечено как REDACTED).

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

Примечание.

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

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

Примечание.

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

Important

При использовании узла генеративных ответов в теме может возникнуть ошибка на холсте разработки и в средстве проверки тем, если выбрана интегрированная безопасность. Эта ошибка не представляет опасности и не мешает работе функции.

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

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

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

      Снимок экрана, показывающий, где выбрать панель «Свойства».

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

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

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

    Снимок экрана диалога

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

    Примечание.

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

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

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

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

    Примечание.

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

Использование переменных в качестве URL-адресов

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

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

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

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

Используйте переменную для следующих целей:

  • Добавить путь к базовому URL-адресу

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

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

    {variable}

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

Примечание.

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

Создание и задание переменной

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

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

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

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

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

Пример: ограничение области по продукту

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

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

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

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

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

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

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

Considerations

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

Important

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

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

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

Important

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

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

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

  • Подробные инструкции по созданию необходимой регистрации приложения 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.

  • Last updated on