Добавление общедоступного веб-сайта в качестве источника знаний

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

Добавить публичный сайт

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

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

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

3. Выберите общедоступные веб-сайты.

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

5. Добавьте имя (по умолчанию используется URL-адрес веб-сайта).

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

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

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

Особенности URL

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

Тип и структура URL-адреса

• URL может иметь до двух уровней глубины, при этом подпути обозначаются косой чертой /вперёд . Однако допускается слэш вперёд.

  Действительный	Недействительно
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• Если URL-адрес перенаправляет на другой сайт верхнего уровня, контент обоих сайтов не включается в результаты:

  Например, если www.fabrikam.com перенаправляется на www.contoso.fabrikam.com, агент не генерирует ответы на основе содержимого ни по одному из этих URL-адресов.

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

  Например, вики и сайты SharePoint требуют аутентификации, поэтому вы не можете ими пользоваться:

  • fabrikam.visualstudio.com/project/_wiki
  • fabrikam.sharepoint.com

Структура домена URL-адреса

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

Примеры:

• Если вы используете www.fabrikam.com/engines/rotary, агент также использует контент для www.fabrikam.com/engines/rotary/dual-shaft генерации ответов.

  Агент не использует контент на www.fabrikam.com/tools, так как инструменты не являются поддоменом ротационной системы.

• Если вы используете www.fabrikam.com ( www существует), агент не использует контент на news.fabrikam.com ( www не существует), так как news. — это поддомен верхнего уровня доменной fabrikam.com.

• Если вы используете fabrikam.com, агент использует контент на www.fabrikam.com и news.fabrikam.com, так как он находится под верхнеуровневым доменным fabrikam.com.

Социальные сети и URL-адреса форумов

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

Дополнительную информацию см. в часто задаваемых вопросах о генеративных ответах. ИИ обучен избегать вредоносных и оскорбительных ответов.

URL-адреса поисковых систем

Не используйте URL-адреса поисковых систем, такие как bing.com, потому что они не дают полезных ответов.

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