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

Примечание

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

  • Мы рекомендуем клиентам начать работу с новым средством поиска в Интернете с помощью API агентов. Если вы хотите понять разницу между средством поиска в Интернете и Grounding с помощью инструмента Bing Search, вы можете узнать больше здесь.

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

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

Вы можете задавать такие вопросы, как "что является главными новостями сегодня" или "что такое недавнее обновление в розничной отрасли в США?", которые требуют общедоступных данных в режиме реального времени.

Разработчики и конечные пользователи не имеют доступа к необработанному содержимому, возвращаемому из Grounding при помощи поиска Bing. Однако ответ модели содержит ссылки на веб-сайты, используемые для создания ответа, и ссылку на запрос Bing, используемый для поиска. Ответ модели можно получить, получив доступ к данным в созданном потоке. Эти две ссылки должны храниться и отображаться в точной форме, предоставленной Microsoft, в соответствии с Требования к использованию и отображению Bing Search. Дополнительные сведения см. в разделе "Как отображается заземление в результатах поиска Bing".

Важно

  1. Использование Grounding вместе с Bing Поиском может повлечь расходы. Дополнительные сведения см. на странице цен .
  2. Только платные подписки и подписки с оплатой по мере использования Azure имеют право на заземление с помощью службы поиска Bing. Подписки, спонсируемые или основанные на бесплатных кредитах, не могут использовать Grounding при помощи Поиска Bing.
  3. Создавая и используя ресурс Grounding с Bing Search через код, например, Azure CLI, или развертывая с помощью шаблона развертывания, вы соглашаетесь быть связанными и соблюдать условия, доступные в https://www.microsoft.com/en-us/bing/apis/grounding-legal, которые могут обновляться время от времени.
  4. При использовании функции Grounding с поиском Bing данные клиента передаются за пределы границы соответствия Azure в службу Grounding с поиском Bing. Привязка с использованием поиска Bing не подпадает под те же условия обработки данных (включая расположение обработки) и не соответствует тем же стандартам соответствия и сертификациям, что и служба Foundry Agent, как описано в Условиях использования поиска Bing. Вы несете ответственность за оценку того, удовлетворяет ли использование Grounding с поиском Bing в вашем агенте вашим потребностям и требованиям.

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

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

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

Примечание

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

Авторизация будет осуществляться между установлением соединения со службой поиска Bing и службой агента. Любой поисковый запрос Bing, созданный и отправленный в Bing для целей обоснования, передается вместе с ключом ресурса за пределы границы соответствия Azure в службу "Обоснование с помощью поиска Bing". Использование поиска Bing регулируется условиями Bing и не имеет таких же стандартов соответствия и сертификаций, как служба агента, как описано в условиях использования "Grounding with Bing Search". Вы несете ответственность за оценку того, соответствует ли использование функции согласования с поисковой системой Bing в вашем агенте вашим нуждам и требованиям.

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

Поддерживаемые возможности и известные проблемы

  • Приземление с помощью средства поиска Bing предназначено для получения сведений в режиме реального времени из веб-сайтов, а не конкретных веб-доменов.
  • НЕ рекомендуется суммировать всю веб-страницу.
  • В рамках одного запуска модель ИИ будет оценивать выходные данные средства и может снова вызвать средство для получения дополнительных сведений и контекста. Модель искусственного интеллекта также может решить, какие фрагменты выходных данных инструментов используются для создания ответа.
  • Azure служба агента ИИ вернет ответ, созданный AI-моделью в качестве выходных данных, поэтому сквозная задержка будет влиять на предварительную и пост-обработку LLM.
  • Приземление с помощью средства поиска Bing не возвращает выходные данные средства разработчикам и конечным пользователям.
  • Связь с поисковой системой Bing работает только с агентами, которые не используют VPN или частные конечные точки. Агент должен иметь обычный сетевой доступ.

Поддержка использования

поддержка Azure ИИ пакет SDK Python C# SDK JavaScript SDK пакет SDK Java REST API Базовая настройка агента Настройка стандартного агента
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️

Установка

Примечание

  1. Заземление с помощью поиска Bing работает со всеми моделями Azure OpenAI, которые поддерживает служба агента, за исключением моделей gpt-4o-mini, 2024-07-18 и gpt-5.
  1. Создайте агент ИИ Azure, выполнив действия в quickstart.

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

    1. Его можно создать на портале Azure и выбрать различные поля в форме создания. Убедитесь, что вы создадите эту инициализацию с помощью ресурса Bing Search в той же группе ресурсов, что и ваш агент Azure AI, проект AI и другие ресурсы.

      Снимок экрана выбора ресурсов Bing в портале Azure.

    2. Вы также можете создать его с помощью подхода, основанного на написании кода. В этом случае необходимо вручную зарегистрировать Bing Поиск в качестве поставщика ресурсов Azure. Необходимо иметь разрешение на выполнение /register/action операции для поставщика ресурсов. Разрешение включено в роли участник и владелец.

        az provider register --namespace 'Microsoft.Bing'
    
  3. После создания ресурса Grounding с использованием поиска Bing его можно найти на портале Azure. Перейдите к группе ресурсов, в которой вы создали ресурс, найдите ресурс "Grounding with Bing Search", который вы создали.

    Снимок экрана ресурса Bing в Azure на портале Azure.

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

При добавлении инструмента Grounding with Bing Search в агент можно передать следующие параметры. Эти параметры повлияют на выходные данные инструмента "Grounding with Bing Search," и модель искусственного интеллекта может не полностью использовать все результаты. См. примеры кода для получения информации о поддержке версий 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, если только пользователь не хочет, чтобы строки пользовательского интерфейса отображались на другом языке.
Строка Нет

Как отобразить заземление в результатах поиска Bing

В соответствии с условиями использования bing и требованиями к использованию и отображению необходимо отобразить URL-адреса веб-сайта и URL-адреса запросов поиска Bing в пользовательском интерфейсе. URL-адреса веб-сайтов можно найти, используя annotations параметр в ответе API, а URL-адреса поисковых запросов Bing — через runstep. Чтобы отобразить веб-страницу, мы рекомендуем вам заменить конечную точку URL-адресов запросов поиска Bing на www.bing.com, и тогда ваш URL-адрес поискового запроса Bing будет выглядеть как "https://www.bing.com/search?q={search query}".

run_steps = project_client.agents.runs_steps.list(run_id=run.id, thread_id=thread.id)
run_steps_data = run_steps['data']
print(f"Last run step detail: {run_steps_data}")

Снимок экрана: ссылки на результаты поиска Bing.

Дальнейшие действия

См. примеры кода для программного использования средства «Grounding with Bing».