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

Note

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

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

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

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

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

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

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

   

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

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

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

   

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

   

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

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

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

Note

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

Длина поискового запроса

Когда агент формирует ответ на основе общедоступного веб-сайта, он использует Граундинг с Поиском Bing и отправляет поисковый запрос в Bing в виде веб-запроса. Общая длина этого запроса, включая поисковый запрос, не может превышать 2 048 символов. Если запрос настолько длинный, что общая длина запроса превышает это ограничение, агент пропускает такой поиск и не возвращает результаты с веб-сайта.

Для общедоступных веб-сайтов поисковый запрос формируется на основе полного вопроса пользователя, переформулированного с учетом релевантного контекста разговора. Несколько факторов могут привести к тому, что длина этого запроса достигнет установленного ограничения:

• Длинные вопросы пользователей.
• Долгие или сложные разговоры, поскольку запрос включает релевантный контекст из предыдущих реплик.
• Языки, использующие многобайтовые символы, такие как японский, китайский и корейский, поскольку при кодировании запроса каждый символ преобразуется в несколько символов.

Подсказка

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

Тип и структура 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, поскольку tools не является поддоменом rotary.

• Если вы используете 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-адресу.

Note

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