Часто задаваемые вопросы о Microsoft Web IQ

Ответы на распространенные вопросы об использовании Microsoft Web IQ. Сведения о API и примеры запросов см. в справочнике по API.

Сервис и развертывание

Что такое Microsoft веб-IQ?

Microsoft Web IQ — это набор API веб-поиска и контекстного обоснования, изначально разработанных для ИИ, который предоставляет LLM, агентам ИИ и приложениям доступ к актуальной, релевантной веб-информации. Это позволяет получать более точные и актуальные AI-ответы с источниками, которые пользователи могут проверить. Web IQ обеспечивает работу ведущих передовых ИИ-ассистентов, включая Microsoft Copilot и ChatGPT.

Веб-IQ доступен через REST по адресу https://api.microsoft.ai/v3 и через MCP по адресу https://api.microsoft.ai/v3/mcp. В настоящее время доступны API — это веб-поиск, новости, видео, изображения и просмотр. Авто доступно в бета-версии.

Что такое веб-grounding и когда ИИ-агенту это требуется?

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

Является ли Web IQ LLM? Создает ли он окончательный ответ?

No. Веб-IQ не является моделью ИИ или LLM. Это набор API веб-поиска и обоснования для ИИ, который предоставляет LLM, агентам ИИ и приложениям доступ к текущей, релевантной веб-информации.

Веб-IQ не создает окончательный ответ искусственного интеллекта. Он получает соответствующие сведения из Интернета, а выбранный LLM, агент ИИ или логика приложения использует эти доказательства для создания ответа.

Что отличает Web IQ от других API-интерфейсов веб-поиска и сервисов grounding?

Большинство API веб-поиска заставляют выбирать между скоростью и точностью, экономичностью и полнотой. В опубликованном Microsoft сравнении Web IQ обеспечивает наивысшую удовлетворённость обоснованностью ответов, максимальную скорость и наименьшее количество токенов на запрос. Это та же платформа, на которую ИИ-помощники, такие как Copilot и ChatGPT, ежедневно полагаются, проверенная в глобальном масштабе и готовая стать основой для создания любых ИИ-агентов и приложений.

Web IQ также отличается тем, как он получает доступ к содержимому. В нем реализован ответственный подход к веб-доступу, объединяющий открытый веб и структурированные данные со встроенными средствами корпоративной безопасности и защиты.

Web IQ работает с уже используемым стеком ИИ. Вы можете использовать предпочитаемую вами ИИ-модель и подключиться через REST API или протокол контекста модели (MCP), без привязки к одной модели или платформе.

Источник: Результаты теста веб-IQ (разделы "Качество", "Эффективность" и "Скорость").

Что можно создать в Web IQ?

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

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

Какой API Web IQ соответствует моему варианту использования?

Используйте Web Search API, чтобы найти соответствующие общедоступные страницы и фрагменты для вашей модели, News API для текущих событий, API Images и Videos для визуальных результатов и видео, а также Browse API, когда вы уже знаете URL-адрес. Ознакомьтесь со справочником по API для возможностей и ограничений, доступных вашей учетной записи.

Можно ли использовать Web IQ с существующей моделью ИИ и фреймворком агентов?

Yes. Веб-IQ позволяет добавлять веб-сведения в выбранные вами модель ИИ и рабочий процесс агента. ИНТЕРФЕЙСы REST API и MCP обеспечивают гибкость при подключении к нему. Проверьте SDK и документацию по интеграции MCP для поддерживаемых конфигураций.

Как выглядит интеграция?

Агент ИИ или приложение вызывает Web IQ для веб-данных, а затем передает выбранные результаты в свою модель для создания ответа. Вы управляете тем, как выбраны, используются и цитируются сведения. Следуйте краткому руководству, чтобы подключить первый рабочий процесс, или начать работу с Playground.

Может ли Web IQ получить конфиденциальную информацию о компании?

No. Веб-IQ получает общедоступную веб-информацию. Для корпоративного контекста Microsoft предлагает Work IQ, Fabric IQ и Foundry IQ, каждый из которых выполняет свою роль — от контекста организации до бизнес-данных и корпоративных знаний.

Как веб-IQ связан с Foundry IQ, Work IQ и Fabric IQ?

Microsoft IQ объединяет четыре интегрированных уровня, которые обеспечивают корпоративную аналитику во всей экосистеме Microsoft. Web IQ предоставляет информацию из общедоступного веб-пространства. Work IQ фокусируется на рабочих сигналах, Fabric IQ — на бизнес-данных, а Foundry IQ — на знаниях организации. Эти продукты удовлетворяют различные информационные потребности агентов и приложений ИИ и являются наиболее мощными при совместном использовании.

Является ли веб-IQ ресурсом Azure?

Вы развертываете ресурс веб-IQ в подписке Azure. Ресурс обрабатывает идентификацию, учет потребления и выставление счетов.

Сама служба размещена Microsoft и является мультитенантной. Веб-извлечение и ранжирование выполняются в инфраструктуре Microsoft, а приложение вызывает api.microsoft.ai по протоколу HTTPS. Ресурс Azure не размещает веб-IQ и не находится в пути запроса.

Где развернут Web IQ?

Web IQ размещается Microsoft и доступен через общедоступную https://api.microsoft.ai/v3 конечную точку. Приложение вызывает API, а Web IQ выполняет получение веб-данных на стороне сервера.

Существуют ли выделенные API для финансов, спорта или погоды?

Не сегодня. Выделенные API — это веб-поиск, новости, видео, изображения и Browse. Для финансов, спорта, погоды и других тем без выделенного API используйте веб-поиск, который возвращает релевантный контент, собранный поисковым роботом. Это содержимое является неструктурированным текстом страницы, а не структурированным фидом.

Доступ и начало работы

Как перейти от оценки к промышленной среде?

1. Завершите оценку и подтвердите, что служба соответствует вашим требованиям.
2. Подписка Azure включена для веб-IQ.
3. Разверните ресурс Web IQ в этой подписке, а затем войдите на сайт клиентов Web IQ и подключите ресурс. При этом создается рабочий идентификатор appID, для которого по умолчанию устанавливается ограничение в 15 запросов в секунду (QPS).
4. Чтобы пройти проверку подлинности с помощью Entra ID, добавьте идентификатор клиента приложения к AppID на сайте Web IQ Customer Site.

Ваше использование Web IQ регулируется условиями использования Web IQ в контексте существующей Клиентское соглашение Майкрософт.

Какие подписки Azure я могу использовать?

Для Web IQ требуется платная подписка Azure. Кредиты Azure не действуют для Web IQ.

Какой адрес следует использовать для входа?

Используйте адрес для входа в Microsoft, который имеет доступ к Web IQ: адрес, который Microsoft предоставила для вас, или учетную запись, используемую для подключения ресурса Web IQ на сайте для клиентов Web IQ. Обычно это адрес, используемый для Azure, Teams или Office, который может отличаться от адреса почтового ящика.

Чтобы убедиться в этом, войдите на портал Azure и проверьте адрес в правом верхнем углу.

Почему при входе говорится, что у меня нет доступа?

Сначала убедитесь, что адрес, показанный в правом верхнем углу портала Azure, точно соответствует адресу электронной почты учетной записи, у которой есть доступ к Web IQ. Организации часто используют один адрес для входа в учетную запись Microsoft и другой для электронной почты.

Если адреса совпадают, ваша организация может заблокировать межарендный гостевой доступ к арендатору Microsoft Corporation. Попросите ИТ-администратора разрешить доступ.

Где я могу получить помощь?

Посетите сайт поддержки Microsoft Web IQ для получения помощи по продуктам. По вопросам допустимого использования, конфиденциальности, хранения или отображения см. текущие условия использования Web IQ и применимое клиентское соглашение.

Проверка подлинности API

Какие методы проверки подлинности поддерживаются?

Веб-IQ поддерживает:

• Bearer-токены Microsoft Entra ID через поток OAuth 2.0 Client Credentials. Это рекомендуется для продуктивных рабочих нагрузок.
• Ключи API, отправленные в заголовке x-apikey запроса.

Весь трафик API использует HTTPS.

Как настроить проверку подлинности между серверами?

Зарегистрируйте приложение в Microsoft Entra ID и используйте поток учетных данных клиента OAuth 2.0. Добавьте ID клиента приложения в Web IQ AppID на сайте Web IQ Customer Site, получите токен доступа и отправьте его как Authorization: Bearer <access_token>.

Ознакомьтесь с Аутентификацией, чтобы ознакомиться с полными шагами по настройке.

Можно ли управлять собственными ключами API?

Yes. Вы можете создать столько ключей API, сколько вам нужно на сайте Web IQ Customer Site. Плата за создание ключей не взимается.

Использует ли веб-IQ Azure RBAC для авторизации API?

No. Web IQ — это служба, размещенная Microsoft, к которой вы обращаетесь через Интернет. Ресурс Web IQ, развернутый в подписке Azure, управляет идентификацией, учетом потребления и выставлением счетов, но не находится на пути запроса, поэтому отсутствует ресурс службы, к которому можно назначить роли Azure RBAC.

Web IQ разрешает запросы по AppID. У каждого AppID есть собственный профиль допустимости контента и квота, а несанкционированные вызовы возвращают HTTP 403. Для разделения команд или рабочих нагрузок, например с различными политиками доступа или квотами, используйте несколько AppID.

Может ли один Entra ID соответствовать более чем одному AppID?

Yes. Один идентификатор приложения Entra (клиента) может получить разрешение вызывать один или несколько идентификаторов AppID. Чтобы выбрать AppID, передайте его в качестве параметра запроса, например https://api.microsoft.ai/v3/search/web?appid=<AppID>. API определяет AppID следующим образом:

• Ваш Entra ID привязан к одному идентификатору AppID: если вы не укажете идентификатор AppID или укажете этот AppID, запрос завершается успешно (HTTP 200). Если указать другой идентификатор appID, запрос возвращает HTTP 403.
• Ваш Entra ID привязан к нескольким идентификаторам приложений: необходимо указать один. Отсутствующий или пустой идентификатор AppID возвращает HTTP 400; один из ваших привязанных AppID возвращает HTTP 200; любой другой AppID возвращает HTTP 403.
• Ваш Entra ID не привязан к идентификатору AppID: запрос возвращает HTTP 401.

Проверка подлинности с помощью ключа API (x-apikey) не затрагивается. Каждый ключ API привязан к одному идентификатору AppID, поэтому ?appid= никогда не требуется и не принимается для вызовов, прошедших проверку подлинности ключа.

Какую проверку подлинности должен использовать размещенный агент: управляемая идентификация или AgentID?

Подойдет любой вариант. Управляемое удостоверение и AgentID — это удостоверения Entra ID, и Web IQ принимает любое удостоверение Entra, идентификатор приложения (клиента) которого связан с вашим профилем приложения Web IQ на странице «Управление профилями» сайта клиентов Web IQ.

Какой из них вы используете, зависит от того, где размещен агент:

• Управляемый идентификатор подходит для агентов, работающих в инфраструктуре Azure, таких как Foundry, App Service, Container Apps, AKS, Functions или виртуальные машины. И управляемые идентификаторы, назначаемые системой, и управляемые идентификаторы, назначаемые пользователем, работают.
• AgentID подходит для агентов Foundry или агентов, размещенных в Copilot Studio, которые предоставляют идентификатор агента.
• Агенты, размещенные вне Azure, например в собственном кластере Kubernetes или другом облаке, могут использовать стандартную регистрацию приложения Entra с секретом клиента или федеративными учетными данными.

В каждом случае вызов использует поток учетных данных клиента OAuth 2.0 и отправляет токен как Authorization: Bearer <access_token>. См. раздел Проверка подлинности для шагов настройки. Ключ API в заголовке x-apikey остается более простым вариантом для прототипов.

Сеть и безопасность

Поддерживает ли Web IQ Приватный канал, частные конечные точки, интеграцию виртуальной сети или разрешение IP-адресов?

No. Сегодня ни одна из них не поддерживается. Доступ к веб-IQ осуществляется через одну общедоступную конечную точку, https://api.microsoft.ai/v3по протоколу HTTPS с Entra ID или проверкой подлинности ключа API. В конечной точке API нет управления доступом на основе IP-адресов.

Ресурс Web IQ в подписке Azure обрабатывает идентификацию, учет потребления и выставление счетов, но не находится на пути прохождения запроса, поэтому сетевые средства управления Azure, такие как Приватный канал, интеграция с виртуальной сетью, Брандмауэр Azure, группы безопасности сети и топологии «концентратор — периферия», на стороне Web IQ не к чему привязывать. Интеграция удостоверений (Entra ID) согласована с Azure; сетевой уровень — нет.

Со своей стороны разрешите имя хоста api.microsoft.ai в элементах управления исходящим трафиком.

Остается ли трафик из Azure в Web IQ в сети Microsoft или в магистральной сети Azure?

Это не гарантируется. Клиенты подключаются к общедоступной https://api.microsoft.ai конечной точке, а трафик защищается при передаче с помощью HTTPS.

Трафик API веб-IQ завершается на Azure Front Door, который поддерживает TLS 1.2 и TLS 1.3 с этими наборами шифров:

• TLS 1.3: TLS_AES_256_GCM_SHA384, TLS_AES_128_GCM_SHA256
• TLS 1.2: TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

Будет ли Zscaler или другое средство проверки исходящего трафика вмешиваться в веб-IQ?

Он не должен мешать, если он настроен на разрешение подключений к api.microsoft.ai. Это стандартное действие списка разрешённых, а не общий обход. Такой же подход применяется к другим безопасным веб-шлюзам, таким как Netskope.

Можно ли поместить веб-IQ за Azure API Management?

Yes. Вы можете разместить Azure API Management или другой шлюз перед Web IQ в собственной подписке Azure для наблюдаемости и управления, и нет известных блокирующих ограничений. Вызовы API переходят от вызывающего объекта к https://api.microsoft.ai/v3 по TLS с помощью ключа API или маркера Entra ID, поэтому все, что вы помещаете перед этим трафиком, является вашей собственной инфраструктурой в вашем клиенте. Microsoft не публикует эталонную архитектуру для этих развертываний; за эту архитектуру отвечает ваша команда по облачной архитектуре.

В рамках условий использования Web IQ содержимое ответа не может быть кэшировано или сохранено для создания производного набора данных независимо от того, что делает шлюз. Операционные данные телеметрии, такие как состояние, задержка, заголовки и идентификаторы трассировки, могут храниться, например в Application Insights или Log Analytics.

Какие меры контроля безопасности доступны?

• Проверка подлинности: Entra ID (учетные данные клиента OAuth 2.0) или ключ API.
• Разграничение доступа: доступ к API для каждого AppID. Несанкционированные вызовы возвращают HTTP 403.
• Ограничение частоты запросов: принудительное применение квоты AppID. На запросы, превышающие ограничение, сервер отвечает кодом HTTP 429.
• Транспорт: только HTTPS.

Политика сети на вашем периметре является вашей ответственностью. Если у вас есть определенные требования к архитектуре, которые вы хотите оценить, обратитесь в Web IQ Support.

Лимиты скорости и ключи API

Существует ли лимит запросов?

Yes. Каждый ресурс веб-IQ имеет ограничение по умолчанию в 15 запросов в секунду (QPS). Ограничение применяется к AppID, созданному при подключении ресурса, и сайт клиента Web IQ отображает это ограничение.

Ограничение является общим для всех ключей API и клиентов Entra ID для этого AppID. На запросы, превышающие ограничение, сервер отвечает кодом HTTP 429.

Можно ли увеличить лимит запросов?

Yes. Каждый ресурс Web IQ поддерживает от 15 QPS. Чтобы запросить более высокий предел, обратитесь в службу поддержки Web IQ с ожидаемым трафиком и вариантом использования.

Сколько ключей API можно создать?

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

Конфиденциальность и обработка данных

Регистрирует ли Web IQ API-запросы?

Yes. Запросы API регистрируются в целях обеспечения работы сервиса: надежности сервиса, отладки и улучшения качества. Это стандарт для служб Microsoft.

• Доступ ограничен авторизованным инженерным и эксплуатационным персоналом Microsoft и регулируется внутренними политиками Microsoft по управлению доступом. Данные в журналах недоступны другим клиентам или третьим лицам.
• Журналы хранятся в производственной инфраструктуре Microsoft и подпадают под действие стандартных средств контроля безопасности Microsoft, включая управление доступом на основе ролей и следы аудита.
• Журналы шифруются во время передачи (HTTPS) и при хранении с помощью стандартных методов шифрования Microsoft.

Microsoft работает в качестве контроллера данных в соответствии с заявлением о конфиденциальности Microsoft.

Сколько времени хранятся запросы?

Хранение данных телеметрии запросов регулируется разделом 4 Web IQ Terms of Use, согласно которому обработка данных Microsoft регулируется Заявлением о конфиденциальности Microsoft. Не существует отдельных обязательств Web IQ по срокам хранения данных сверх того, что описано в Заявлении о конфиденциальности.

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

Текст запроса записывается в рамках стандартной телеметрии запроса, а его обработка регулируется заявлением о конфиденциальности Microsoft и разделом 4 условий использования веб-IQ.

Если у вас есть конкретное регуляторное требование или требование соответствия, Web IQ предлагает Zero Query Logging, которое скрывает текст запроса из телеметрии. Это не функция самообслуживания; каждый вариант использования рассматривается и утверждается отдельно, и это может применяться ко всем приложениям или только к определенным приложениям. Чтобы запросить его, обратитесь к своей команде по работе с учетной записью Microsoft и сообщите:

• Применимое регулирование или комплаенс-структура (например, GLBA, HIPAA, GDPR или APPI).
• Краткое описание сценария развертывания.

Какие обязательства по размещению данных предоставляет Web IQ?

На сегодня нет. Web IQ не предоставляет обязательств по размещению данных в регионе или обработке в регионе, а маршрутизация между регионами к ближайшей доступной конечной точке — ожидаемое поведение. Вопросы конфиденциальности регулируются Заявлением о конфиденциальности Microsoft.

Подпадает ли Web IQ под дополнение Azure Data Protection или EU Data Boundary?

No. Раздел 4.1 Web IQ Terms of Use исключает службу из дополнения Microsoft Products and Services Data Protection Addendum.

Вместо этого Microsoft и клиент выступают в качестве независимых контроллеров данных для любых персональных данных, обработанных в соответствии с условиями использования (раздел 4.4). обработка Microsoft регулируется заявлением о конфиденциальности Microsoft (раздел 4.2), и вы несете ответственность за предоставление соответствующего уведомления конечным пользователям.

Для международных переводов условия использования включают Стандартные договорные положения, если это требуется (раздел 4.6.1). Этот механизм передачи регулируется Условиями использования, которые входят в состав вашего Соглашения с клиентом Microsoft, а не Дополнением о защите данных.

Web IQ сегодня не предоставляет обязательств в отношении EU Data Boundary, хранения данных в определенных регионах или обработки данных в регионе.

Обнаруживает ли веб-IQ персональные данные в запросах или маскирует их?

No. Веб-IQ не выполняет обнаружение или маскирование персональных данных на стороне сервера в входящих запросах. Если рабочая нагрузка может отправлять личные или конфиденциальные данные, очистите ее перед вызовом Web IQ, например, используя Язык ИИ Azure PII Detection в качестве этапа предварительной обработки. Таким образом, ничто конфиденциальное не покидает вашу среду, и вы сохраняете полный контроль над тем, что достигает API.

Поддерживает ли веб-IQ регулируемые отрасли?

Yes. Web IQ поддерживает ряд корпоративных сценариев использования и сценариев использования в регулируемых отраслях. Если у вас есть специализированные требования к соответствию, корпоративному управлению или отраслевые требования, обратитесь в службу поддержки Web IQ.

Безопасность содержимого и охват

Какие элементы управления безопасностью содержимого применяются?

Веб-IQ применяет классификацию качества и безопасности во время обхода, фильтрацию содержимого для взрослых и правила соответствия содержимого для каждого клиента. По умолчанию SafeSearch применяется на стороне сервера в strict. Результаты поиска в Интернете также включают isAdult поле для дополнительной обработки на стороне клиента.

Защищает ли веб-IQ LLM от инъекции промпта в извлечённом контенте?

Microsoft веб-IQ извлекает и ранжирует содержимое из Интернета; он не выполняет, не интерпретирует и не действует в соответствии с инструкциями, содержащимися в извлеченном содержимом. Web IQ дополняет этот процесс извлечения существующими в Bing механизмами проверки качества, надежности, спама и вредоносного содержимого.

Защита от непрямой инъекции промптов, попыток взлома и атак на следование инструкциям лежит в первую очередь на последующей модели и слое оркестрации. Считайте запросы и извлеченный контент ненадежными входными данными и применяйте многоуровневые меры контроля, такие как Prompt Shields, Безопасность содержимого ИИ Azure, изоляция системных запросов, доступ инструментов с наименьшими привилегиями, проверка обоснованности и проверка выходных данных. Web IQ не следует рассматривать как единственную точку контроля для смягчения prompt injection.

Как веб-содержимое обрабатывается, прежде чем Web IQ вернет его? Выполняется ли очистка от инструкций, похожих на промпт?

Microsoft веб-IQ не работает непосредственно с необработанным HTML-кодом страницы во время получения. Во время индексирования веб-содержимое нормализуется в структурированное представление документа, предназначенное для сохранения значимого содержимого и структуры документов. Фрагменты, возвращаемые Web IQ, выбираются из этого представления, что обеспечивает более согласованное извлечение и поиск во всем API. Существующая проверка качества, безопасности, нежелательной почты и вредоносного содержимого Bing также применяется в рамках конвейера индексирования.

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

Возвращает ли веб-IQ скрытое или не пользовательское содержимое страницы?

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

Как Microsoft поддерживает качество индекса?

Страницы оцениваются по качеству, авторитетности и надежности. Вредоносное, нежелательное и фишинговое содержимое обнаруживается и исключается, а индекс постоянно обновляется. Это тот же индекс, на который опираются собственные ИИ‑продукты Microsoft.

Как веб-IQ учитывает настройки содержимого издателя?

Web IQ предназначен для соблюдения поддерживаемых средств контроля издателя, включая применимые директивы robots.txt и другие сигналы издателя, распознанные Microsoft.

Существует ли опубликованный список исключенных сайтов или заблокированных категорий?

No. Средства управления исключениями включают соблюдение требований robots.txt, удаление по юридическим причинам и требованиям соответствия (например, уведомления DMCA и судебные приказы), фильтрацию спама, вредоносного ПО и фишинга, а также фильтрацию содержимого для взрослых. Сами списки являются проприетарными и постоянно обновляются. Если у вас есть вопросы по поводу определенных категорий содержимого, которые отображаются или не отображаются в результатах, обратитесь в службу поддержки Веб-IQ, чтобы обсудить, соответствует ли конфигурация профиля приложения этим требованиям.

Какое содержимое охватывает Web IQ и насколько это актуально?

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

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

Какие языки и рынки поддерживает Web IQ?

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

Можно ли настроить списки разрешений или запретов домена?

Для отдельных доменов или небольших списков используйте стандартные операторы запросов, такие как site:example.com для включения домена и -site:example.com для исключения домена. Более крупные настраиваемые списки в настоящее время не предоставляются в качестве управляемой клиентом функции.

Почему я не вижу результаты LinkedIn?

LinkedIn результаты в настоящее время исключены.

Что происходит при вызове Browse для исключенного URL-адреса?

Browse возвращает HTTP 403. Исходный список исключений недоступен.

Как сделать веб-сайт доступным для Web IQ?

Веб-IQ основан на том же веб-индексе, который Microsoft использует для собственных продуктов ИИ. Используйте стандартные методики веб-обнаружения, такие как карты сайта, IndexNow, Bing Webmaster Tools и соответствующую политику robots.txt. Отдельный путь отправки веб-IQ отсутствует.

Поведение запросов и качество результатов

Следует ли использовать запросы на естественном языке или запросы по ключевым словам?

Оба работают. Запросы естественного языка часто хорошо работают с contentFormat=passage, а запросы по ключевым словам полезны для точного поиска, например по названиям компаний, тикерам или конкретным темам. Избегайте слишком длинных или составных запросов; разделяйте несколько информационных потребностей на отдельные вызовы API.

Какова максимальная длина запроса?

Максимальная длина — 1000 символов, а более длинные запросы отклоняются. Более короткие, сфокусированные запросы обычно дают лучшие результаты: если запрос содержит много контекста, извлечение может не выделить нужный сигнал.

Можно ли фильтровать результаты веб-поиска по дате?

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

lastUpdatedAt — дата последнего обновления содержимого издателя, а не дата, когда Web IQ в последний раз проверил страницу, поэтому старая дата не означает, что страница не была проверена недавно. Он возвращается в ответе, он не является фильтром запросов, и не каждый результат включает его. Его можно использовать для сортировки или фильтрации результатов в приложении.

Может ли поиск в Интернете обрабатывать запрос, содержащий несколько вопросов?

Каждый запрос поиска в Интернете обрабатывает один поисковый запрос. Если запрос содержит несколько вопросов или намерений, разделите его на отдельные запросы в приложении, вызовите поиск в Интернете для каждого и объедините результаты перед созданием ответа.

Может ли Web IQ поддерживать многошаговые рабочие процессы агента?

Yes. Агент может обращаться к Web IQ всякий раз, когда ему нужны дополнительные данные из интернета при выполнении задачи. Задержка извлечения особенно важна в рабочих процессах, выполняющих несколько вызовов перед созданием ответа.

Как мой агент ИИ или приложение должен обрабатывать извлечённые доказательства?

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

Как сравнивается качество заземления?

Microsoft сообщает о наивысшей удовлетворенности обоснованностью в своем опубликованном сравнении с оценкой 79,05. Результаты зависят от набора запросов, модели и метода оценки, поэтому проверьте качество в собственных сценариях.

Источник: результаты теста веб-IQ. Глобальные запросы 3K, слепые запросы, выбранные из prod, Config: 10 результатов, 10 тысяч символов на результат (или эквивалент).

Почему результаты отличаются от Bing.com?

Веб-IQ оптимизирован для использования LLM, фактической плотности, качества текстовых фрагментов и низкой задержки. Bing.com — это пользовательский сервис с дополнительными сигналами ранжирования, персонализацией, визуальными ответами и контентом, который может быть недоступен для распространения через API. Ожидаются некоторые различия в рейтинге.

Могут ли идентичные запросы возвращать разные результаты?

Возможны некоторые различия, так как индекс постоянно обновляется, а обновления распространяются между центрами обработки данных. Результаты идентичных запросов, сделанных близко друг к другу, должны оставаться в целом стабильными. Если вы видите значительное расхождение в идентичных запросах в течение нескольких секунд, обратитесь в службу поддержки Web IQ.

Почему запрос возвращает меньше результатов, чем ожидалось?

Перед подсчетом результатов проверьте необработанный ответ веб-IQ. Наиболее распространенная причина заключается в настройке на стороне клиента или последующем этапе конвейера, который фильтрует допустимые результаты до их измерения. Кроме того, проверьте maxResults, соответствие содержимого, поведение SafeSearch и любые операторы site: или -site: в запросе.

Содержимое ответа

Почему поиск в Интернете и поиск новостей не возвращают поле snippet?

Это сделано намеренно. Оба возвращают content в качестве зависящего от запроса извлечения (passage) вместо отдельного, не зависящего от запроса snippet.

Какие форматы содержимого поддерживает Web Search?

С passage каждый результат возвращает части документа, наиболее релевантные запросу, объёмом до maxLength символов (без доступа к полному тексту документа — не более 3000). Это рекомендуемый формат для заземления. Приложения с полным доступом к документам также могут использовать textи htmlmarkdown. См. фрагменты и форматы содержимого.

Что такое passage, и зачем его использовать?

Установите contentFormat=passage, и API возвращает для каждого результата только те сегменты документа, которые наиболее релевантны запросу, а не полный документ. Полный документ обрабатывается на стороне Web IQ, и в ответ возвращается фрагмент, подобранный под запрос, поэтому LLM не приходится просматривать нерелевантные абзацы, чтобы найти соответствующее предложение.

• Экономия токенов: LLM получает часть документа вместо всего.
• Более эффективная фактуальность: с меньшим содержанием вне темы в контексте меньше вероятность, что модель будет привязываться к тангенциальному абзацу.

Задайте contentFormat=passage во всех запросах Web Search и News. Browse не поддерживает passage, так как он запрашивает определенный URL-адрес, который вы уже выбрали, и нет запроса, по которому можно извлекать данные.

Каково максимальное maxResults значение для поиска в Интернете?

Поиск в Интернете поддерживает до 50 результатов на запрос.

Какие параметры запроса можно настроить?

Веб-поиск предоставляет maxResults, language и region, contentFormat (passage, html, text или markdown), maxLength и safeSearch. См. справочник по API для полного списка параметров.

Что такое разница между lastUpdatedAt и crawledAt?

lastUpdatedAt — дата обновления контента, указанная издателем, возвращаемая веб-поиском, новостями, видео, изображениями, Browse и Auto при наличии. crawledAt — это время, когда Web IQ в последний раз получил страницу из результатов Web Search, Browse, News и Auto. Наличие обоих полей зависит от результата.

Как настроить maxResults и maxLength, чтобы управлять затратами на контекстное окно и токены?

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

Для большинства сценариев grounding больше результатов с более короткими фрагментами дают лучшие выходные данные, чем меньше результатов с более длинными фрагментами при примерно том же общем бюджете токенов. Хорошая отправная точка — это maxResults=10 с maxLength около 3000 символов в passage формате. Сравнивайте производительность с вашими собственными запросами и моделью.

Что такое Browse Live Crawl и когда его следует использовать?

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

Для сценариев, которые нуждаются в получении URL-адреса точно в момент запроса, таких как мониторинг в режиме реального времени, конкурентные проверки или рабочие процессы, которые срабатывают при изменении, которое, как вы знаете, только что произошло, Browse поддерживает Live Crawl. Установите liveCrawl: "fallback" для запроса, чтобы включить live fetch, когда индексируемая копия отсутствует или устарела. Опущение параметра (или при установке значения liveCrawl: "none") возвращает только индексированное содержимое. Дополнительные сведения о параметрах см. в справочнике по Browse API.

Live Crawl доступен по умолчанию в Web IQ Browse и предоставляется с небольшим лимитом пропускной способности в секунду, отдельно от общего QPS Browse. Этот потолок является общим для всех ключей API в AppID. Для большинства сценариев Browse не требуется Live Crawl, и для них лучше использовать стандартный индексированный путь; используйте Live Crawl для узкого набора сценариев, указанных выше.

Может ли Browse получать страницы, отрисованные на JavaScript?

Yes. Используйте renderDynamicPages: true вместе с liveCrawl: "fallback". Дополнительные сведения о наборе параметров и ответе см. в справочнике по Browse API. Проверьте репрезентативные URL-адреса, прежде чем полагаться на такое поведение в рабочей среде.

Может ли Browse извлекать PDF-файлы из Интернета?

PDF-файлы, размещенные в Интернете, сегодня не являются документированным сценарием просмотра. Если у вас есть конкретный вариант использования PDF, обратитесь в службу поддержки Web IQ с репрезентативным URL-адресом и ожидаемым поведением, и вы получите окончательный ответ.

Выставление счетов и юридическая информация

Сколько стоит Web IQ?

Web IQ использует тарификацию на основе потребления за каждый вызов. Цены зависят от API, включенных для вашей учетной записи, использования и коммерческих условий. См. цены для ознакомления с текущими тарифами.

Включает ли Web IQ обязательства по SLA, RTO или RPO?

No. Microsoft Web IQ не включает соглашение об уровне обслуживания. Условия использования Web IQ не предусматривают обязательств по времени бесперебойной работы, задержке, целевому времени восстановления (RTO) или целевой точке восстановления данных (RPO), а условия SLA не включаются для отдельных клиентов.

Нужно ли отображать цитаты?

Yes. Приложение A, раздел 1 (ИСПОЛЬЗОВАНИЕ LLM) условий использования Web IQ требует указания источника и ссылки на каждый источник, используемый для отображаемого содержимого LLM, рядом с этим содержимым.

• Указывайте только те источники, которые действительно использовались для подготовки ответа. Если веб-IQ вернул 10 результатов, а ваша модель использовала 3 из них, отобразите эти 3.
• Цитаты должны оставаться видимыми в ответе и быть доступными с помощью одного действия. Не показывайте их лишь кратко, не скрывайте их за несколькими экранами и не требуйте от пользователей запрашивать источники отдельно.
• Для ограниченных интерфейсов, таких как автомобили, носимые устройства, устройства с голосовым управлением или киоски, используйте постоянный QR-код, который ведет на страницу со списком всех ссылок, используемых для текущего ответа, приложение-компаньон, показывающее ответ с кликабельными ссылками, или список на экране, который пользователь может открыть напрямую.

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

Сколько исходного содержимого может отображать агент ИИ или приложение?

Приложение A к Условиям использования Web IQ ограничивает отображаемый Grounding Content из любого одного источника до меньшего из двух значений: 200 символов или максимума, указанного владельцем веб-сайта или веб-мастером. Для голосовых или звуковых сценариев применяется то же ограничение к речевому выводу. Дополнительные ограничения применяются к сводкам и отображению. Просмотрите условия использования перед созданием фрагментов; это ограничение не является разрешением на воспроизведение всех исходных страниц.

Можно ли использовать результаты по изображениям и видео для обоснования LLM?

Метаданные изображения и видео и замещающий текст включены в определение Grounding Content. Однако Условия использования Web IQ запрещают использовать фактические изображения или видео из результатов для обоснования, включая их в выходные данные LLM или создавая на их основе производные изображения или видео. Просмотрите условия предполагаемого внедрения.

Можно ли кэшировать или хранить содержимое Web IQ?

Как правило, нет. Web IQ Terms of Use запрещают копирование, хранение, кэширование, архивирование или создание базы данных содержимого, за исключением узких исключений (раздел 3.2.15 и раздел 4 Приложений A и B):

• Журнал чата конечных пользователей (до 30 дней): содержимое может храниться в неагрегированном виде, отдельно для каждого конечного пользователя, для истории чата отдельного конечного пользователя до 30 дней. Для использования LLM (Приложение A) это охватывает содержимое в целом; для использования поиска (Приложение B) он охватывает URL-адреса изображений и видео.
• Временная обработка атомарного действия: содержимое может храниться во временном состоянии обработки только в той мере, в какой это строго необходимо для выполнения одного логического запроса или рабочего процесса, инициированного LLM («Атомарное действие», которое может включать несколько внутренних шагов или агентических взаимодействий). Содержимое должно быть немедленно удалено при завершении Atomic Action.
• Ваш собственный рабочий продукт: в той мере, в какой это разрешено законодательством об авторском праве, Контент может копироваться или храниться как неотъемлемая часть вашего собственного рабочего продукта при условии, что этот рабочий продукт не создан для замены Сервисов (например, для создания базы данных Контента, индексирования ссылок для обхода или предложения отдельного поиска).

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

Где можно прочитать условия использования веб-IQ?

Текущие условия опубликованы в документе Microsoft Web IQ Terms of Use. Они применяются вместе с вашим существующим Клиентское соглашение Майкрософт.

Полный доступ к документу

Почему я получаю ошибку HTTP 403, когда устанавливаю contentFormat в html?

В веб-поиске и поиске новостей text, html и markdown возвращают полный документ и доступны приложениям с полным доступом к документам. Другие приложения получают HTTP 403 с кодом ошибки AuthContentFormatForbidden. passage работает для каждого приложения. См. Отрывки и форматы контента.

Как запросить полный доступ к документу?

Откройте запрос в службу поддержки Web IQ через службу поддержки Azure и выберите категорию Полностраничное содержимое. Приложения, которые уже используют html или text, будут продолжать работать, как и сегодня.