Приземление с помощью пользовательского поиска Bing (предварительная версия) (классическая версия)

Примечание

Этот документ ссылается на агентов Microsoft Foundry (classic).

🔍 Ознакомьтесь с новой документацией по поиску Bing. Агенты (классические) в настоящее время устарели и будут удалены 31 марта 2027 года. Используйте новые агенты в общедоступной службе Microsoft Foundry Agents. Следуйте инструкциям по миграции , чтобы обновить рабочие нагрузки.

Использование средства пользовательского поиска Bing позволяет агентам ИИ Azure выполнять поиск в настраиваемом наборе общедоступных веб-доменов. Он позволяет вам определить части веба, откуда вы хотите извлекать информацию, чтобы пользователи видели только релевантные результаты из доменов и поддоменов по вашему выбору. Сначала необходимо создать ресурс "Заземление" с помощью ресурса пользовательского поиска Bing на портале Azure.

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

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

Важно

• Использование приземления с пользовательским поиском Bing может повлечь за собой затраты. Дополнительные сведения см. на странице цен.
• Создавая и используя ресурс Grounding с пользовательским поиском Bing через программный код, например Azure CLI, или развертывая с помощью шаблона развертывания, вы соглашаетесь соблюдать условия использования, которые могут периодически обновляться.
• При использовании Grounding с пользовательским поиском Bing данные клиента передаются за пределы границы соответствия Azure в службу Grounding с пользовательским поиском Bing. Подключение через пользовательский поиск Bing не подпадает под те же условия обработки данных (включая местоположение обработки) и не имеет таких же стандартов соответствия и сертификатов, что и служба агента Foundry, как это описано в Условиях использования для пользовательского поиска Bing. Вы несете ответственность за оценку того, соответствует ли использование интеграции Grounding с пользовательским поиском Bing в вашем агенте вашим потребностям и требованиям.

Принцип работы приземления с помощью пользовательского поиска Bing

Запрос пользователя — это сообщение, которое конечный пользователь отправляет агенту, например, "какая бутылка воды доступна?" (предполагается создание экземпляра на веб-сайтах продуктов Contoso). Инструкции представляют собой системное сообщение разработчика, которое может предоставить общий доступ к контексту и предоставить инструкции модели ИИ по использованию различных инструментов или поведения.

Когда пользователь отправляет запрос, развертывание модели искусственного интеллекта клиента сначала обрабатывает его (используя предоставленные инструкции), чтобы позже выполнить запрос пользовательского поиска Bing (который отображается разработчикам). Заземление с помощью Bing Custom Search отправляет релевантные результаты поиска в модель развертывания клиента, что затем генерирует окончательные выходные данные.

Примечание

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

Авторизация будет происходить между системой Grounding с использованием службы Bing Custom Search и службой агента Foundry. Любой запрос пользовательского поиска Bing, созданный и отправленный в Bing для целей обоснования, передается вместе с ключом ресурса и экземпляром конфигурации за пределы границы соответствия Azure в службу обоснования с пользовательским поиском Bing. Использование пользовательского поиска Bing регулируется условиями Bing и не обладает теми же стандартами соответствия и сертификациями, что и служба агента, как указано в Условиях использования 'Использование пользовательского поиска Bing.' Вы несете ответственность за то, соответствует ли использование Приземления с пользовательским поиском Bing в агенте в соответствии с вашими потребностями и требованиями.

У разработчиков и конечных пользователей отсутствует доступ к необработанному содержимому, возвращаемому функцией Bing Custom Search. Однако ответ модели содержит ссылки на веб-сайты, используемые для создания ответа, и его можно хранить с помощью механизмов, предоставляемых службой агентов. Ответ модели можно получить, получив доступ к данным в созданном потоке. Эти ссылки должны сохраняться и отображаться в точной форме, предоставленной Microsoft, согласно требованиям использования и отображения, предусмотренным для Bing Custom Search.

Понимание ссылок в ответе агента

При использовании пользовательского поиска Bing для формирования ответа агента, ответ может включать URL-адреса, которые помогают пользователям проверить ответ.

В клиентских SDK ссылки на URL-адреса возвращаются в виде аннотаций в сообщении агента. Каждая ссылка содержит заголовок и URL-адрес, которые можно показывать пользователям в виде списка ссылок.

Полный пример печати ссылок из сообщения потока см. в примерах кода.

Транзакции с использованием ресурса Grounding с Bing рассчитываются по количеству вызовов инструментов на каждое выполнение. Вы можете увидеть, сколько вызовов инструментов происходит на этапе выполнения.

Установка

Примечание

Приземление с помощью средства поиска Bing работает в защищенной сети Foundry, но средство не учитывает VPN или частные конечные точки в Foundry. Она выступает в качестве общедоступной конечной точки. Пожалуйста, учтите это соображение безопасности при использовании защищённой сети Foundry с этим инструментом.

1. Создайте агент ИИ Azure, выполнив действия в quickstart.

2. Создайте приземление с помощью ресурса пользовательского поиска Bing на портале Azure. Чтобы создать ее, необходимо иметь роль владельца или участника в подписке или группе ресурсов. Убедитесь, что вы создаете этот ресурс создания пользовательского поиска Bing в той же группе ресурсов, что и ваш агент ИИ Azure, проект ИИ и другие ресурсы.

3. После создания базы с помощью ресурса настроенного поиска Bing можно создать экземпляр конфигурации.

   1. Перейдите к ресурсу «Grounding with Bing Custom Search», который был создан.

   2. Выберите "Управление ресурсами" на левой панели.

   3. Выберите конфигурации.

   4. Выберите "Создать новую конфигурацию".

При создании или обновлении конфигурации введите следующие сведения:

1. Имя конфигурации. Это имя можно изменить в любое время.

2. Включите URL-адреса, чтобы определить срезы поиска по крайней мере в одном из следующих полей:

   Примечание

   Использование поисковой системы Bing Custom возвращает результаты только для доменов и веб-страниц, которые являются общедоступными и индексированы в Bing.

   • Домен (например, https://www.microsoft.com)
   • Домен и путь (например, https://www.microsoft.com/surface)
   • Веб-страница (например, https://www.microsoft.com/en-us/p/surface-earbuds/8r9cpq146064)

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

   2. Заблокированные домены для исключения из пространства поиска.

3. Определите, нужно ли включать вложенные страницы. Часть страницы указывает путь домена. Bing выполняет поиск всего содержимого, расположенного по пути и ниже его. В пути к файлу можно указать не более двух подкаталогов. Например, www.microsoft.com/windows/.

4. При необходимости измените ранжирование.

5. Перейдите на экран «Агенты» для вашего агента в портале Foundry, прокрутите вниз панель настройки справа до раздела «знания». Затем нажмите кнопку "Добавить".

   

6. Выберите средство "Подготовка с пользовательским поиском Bing".

7. Выберите, чтобы создать новое подключение или использовать существующее подключение

   1. Для нового подключения выберите свой ресурс "Заземление" с помощью ресурса пользовательского поиска Bing.

8. После подключения к ресурсу выберите имя конфигурации.

9. Сохраните средство и начните чат с агентом.

Возможности настройки пользовательского поиска

Ограничение с помощью Bing Custom Search — это мощное средство, позволяющее выбрать подпространство веб, чтобы ограничить знания агента. Здесь можно найти несколько советов по использованию максимальной возможности.

1. Если вы владеете общедоступным сайтом, который вы хотите включить в поиск, но который еще не был проиндексирован Bing, см. документацию для веб-мастеров Bing для получения информации о том, как включить сайт в индекс. Документация для веб-мастеров также содержит сведения о том, как настроить обход сайта с помощью Bing, если индекс устарел.

2. Вы можете заблокировать только определенные домены и выполнить поиск по остальной части Интернета (например, сайт конкурента).

Необязательные параметры

При добавлении инструмента "Grounding with Bing Custom Search" в агент, можно передавать следующие параметры. Эти параметры повлияют на результаты работы средства пользовательского поиска Bing для Grounding, и модель искусственного интеллекта может не полностью использовать все эти результаты. См. примеры кода для получения информации о поддержке версий API и способах передачи этих параметров.

Имя	Значение	Тип	Обязательно
count	Количество результатов поиска, возвращаемых в ответе. Значение по умолчанию равно 5, а максимальное значение — 50. Фактическое число, доставленное, может быть меньше запрошенного. Для нескольких страниц можно включить некоторые перекрывающиеся результаты. Этот параметр влияет только на результаты веб-страницы. Возможно, модель ИИ может не использовать все результаты поиска, возвращаемые Bing.	UnsignedShort	Нет
freshness	Отфильтруйте результаты поиска по следующим значениям возраста без учета регистра: День: возврат веб-страниц, обнаруженных Bing за последние 24 часа. Неделя: возврат веб-страниц, обнаруженных Bing за последние 7 дней. Месяц: возврат веб-страниц, обнаруженных Bing за последние 30 дней. Чтобы получить статьи, обнаруженные Bing во время определенного интервала времени, укажите диапазон дат в форме: YYYY-MM-DD..YYYY-MM-DD Например, freshness=2019-02-01..2019-05-30. Чтобы ограничить результаты одной датой, установите этот параметр на определенную дату. Например, freshness=2019-02-04.	Строка	Нет
market	Рынок, из которого приходят результаты. Как правило, это страна или регион, mkt из которого пользователь выполняет запрос. Однако это может быть другая страна или регион, если пользователь не находится в стране или регионе, где Bing предоставляет результаты. Рынок должен находиться в форме: <language>-<country/region> Например, en-US. Строка не учитывает регистр. Список возможных рыночных значений см. в разделе "Коды рынка". Если известно, рекомендуется всегда указывать рынок. Указание рынка помогает Bing маршрутизировать запрос и возвращать соответствующий и оптимальный ответ. Если указать рынок, который не указан в кодах рынка, Bing использует лучший код рынка на основе внутреннего сопоставления, которое подлежит изменению.	Строка	Нет
set_lang	Язык, используемый для строк пользовательского интерфейса. Укажите язык с помощью 2-буквы или 4-буквного кода. Использование 4-буквовых кодов предпочтительнее. Список поддерживаемых языковых кодов см. в разделе "Поддерживаемые языки Bing". Bing загружает локализованные строки, если setlang содержит допустимый 2-буквенный нейтральный код языка и региональных параметров (fr) или допустимый 4-буквенный код языка и региональных параметров (fr-ca). Например, Bing fr-ca загружает строки с нейтральным fr кодом культуры. Если setlang недействителен (например, zh) или Bing не поддерживает язык (например, af, af-na), Bing по умолчанию использует en (английский). Чтобы указать 2-буквенный код, задайте для этого параметра код языка ISO 639-1. Чтобы указать 4-буквенный код, используйте форму <language>-<country/region> , в которой <language> используется код языка ISO 639-1 (нейтральный язык и региональные параметры) и <country/region> является кодом ISO 3166 страны или региона (конкретного языка и региональных параметров). Например, используйте en-US для американского английского языка. Хотя необязательно, всегда укажите язык. Как правило, задайте setLang тот же язык, указанный mkt пользователем, если пользователь не хочет, чтобы строки пользовательского интерфейса отображались на другом языке.	Строка	Нет