perguntas frequentes sobre Microsoft Web IQ

Respostas para perguntas comuns sobre como usar Microsoft Web IQ. Para obter detalhes da API e exemplos de solicitação, consulte a referência da API.

Serviço e implementação

O que é Microsoft Web IQ?

Microsoft Web IQ é um conjunto de APIs de pesquisa na Web e grounding nativas de IA que fornece a LLMs, agentes de IA e aplicativos acesso a informações da Web atuais e relevantes. Isso permite respostas de IA mais precisas e atualizadas, com fontes que os usuários podem verificar. O Web IQ capacita os principais assistentes de IA de ponta, incluindo Microsoft Copilot e ChatGPT.

Web IQ está disponível por meio de REST em https://api.microsoft.ai/v3 e por meio de MCP em https://api.microsoft.ai/v3/mcp. As APIs disponíveis atualmente são Pesquisa na Web, Notícias, Vídeos, Imagens e Browse. Auto está disponível na versão beta.

O que é grounding na Web e quando um agente de IA precisa dele?

A fundamentação na Web dá à IA acesso às informações mais recentes da Web para que ela possa responder usando fatos atuais além de seus dados de treinamento, com fontes citadas que os usuários podem verificar. Ele ajuda mais com a alteração frequente de informações, como desenvolvimentos de mercado, atividade dos concorrentes, notícias e atualizações regulatórias.

O Web IQ é um LLM? Isso gera a resposta final?

No. O IQ da Web não é um modelo de IA ou LLM. É um conjunto de APIs de pesquisa na Web e grounding nativas de IA que fornece a LLMs, agentes de IA e aplicativos acesso a informações da Web atuais e relevantes.

O IQ da Web não gera a resposta final de IA. Ele recupera informações relevantes da Web e sua llm, agente de IA ou lógica de aplicativo escolhido usa essa evidência para gerar uma resposta.

O que torna o Web IQ diferente de outras APIs de pesquisa na Web e serviços de fundamentação?

A maioria das APIs de pesquisa na Web força um compromisso: rápida ou precisa, econômica ou completa. Na comparação publicada pela Microsoft, o Web IQ oferece a maior satisfação com o grounding, a velocidade mais rápida e o menor número de tokens por consulta. É a mesma plataforma na qual os assistentes de IA, como Copilot e ChatGPT, contam com todos os dias, comprovada em escala global e pronta para qualquer agente ou aplicativo de IA criar.

O Web IQ também é diferenciado pela forma como acessa o conteúdo. Ele adota uma abordagem responsável para o acesso à Web, reunindo a Web aberta e os dados estruturados com proteções e segurança de nível empresarial integradas.

O IQ da Web funciona com a pilha de IA que você já usa. Você pode usar seu modelo de IA de sua preferência e se conectar por meio da API REST ou do Model Context Protocol (MCP), sem estar vinculado a um único modelo ou plataforma.

Fonte: resultados de benchmark do Web IQ (seções qualidade, eficiência e velocidade).

O que posso criar com o Web IQ?

Web IQ capacita agentes de IA e aplicativos que precisam de informações externas novas da web pública. As equipes internas podem usá-lo para inteligência competitiva, monitoramento, pesquisa regulatória, inteligência de vendas e otimização de conteúdo. As experiências voltadas para o cliente podem usá-la para pesquisa, descoberta, recomendações e agentes especializados.

Ele é mais adequado para cenários em que as informações são alteradas com frequência, abrangem muitas fontes externas e precisam ser fundamentadas no conteúdo da Web atual e atribuível.

Qual Web IQ API se encaixa no meu caso de uso?

Use a Web Search API para encontrar páginas e passagens públicas relevantes para seu modelo, a News API para eventos atuais, as APIs de Imagens e Vídeos para resultados visuais e de vídeo e a Browse API quando você já conhece a URL. Verifique a referência de API para obter os recursos e os limites disponíveis para sua conta.

Posso usar o Web IQ com meu modelo de IA existente e estrutura de agente?

Sim. Web IQ permite adicionar informações da Web ao modelo de IA e ao fluxo de trabalho do agente que você escolher. As APIs REST e o MCP oferecem flexibilidade na forma como se conectar. Verifique o SDK e a documentação de integração do MCP para obter configurações com suporte.

Como é a integração?

Seu agente de IA ou aplicativo consulta o Web IQ para obter evidências da web e, em seguida, passa os resultados selecionados para seu modelo para gerar uma resposta. Você controla como as informações são selecionadas, usadas e citadas. Siga o Início Rápido para conectar seu primeiro fluxo de trabalho ou começar a usar o Playground.

O Web IQ pode recuperar informações privadas da empresa?

No. Web IQ recupera informações da web pública. Para o contexto empresarial, Microsoft oferece Work IQ, Fabric IQ e Foundry IQ, cada um atendendo a uma função diferente, do contexto organizacional aos dados corporativos e ao conhecimento corporativo.

Como o Web IQ se relaciona com o qi do Foundry, Work IQ e Fabric IQ?

Microsoft IQ reúne quatro camadas integradas que alimentam a inteligência corporativa em toda a Microsoft. Web IQ fornece informações da web pública. Work IQ se concentra em sinais de trabalho, Fabric IQ em dados empresariais e Foundry IQ no conhecimento organizacional. Esses produtos abordam diferentes necessidades de informações para agentes e aplicativos de IA e são mais poderosos quando usados juntos.

O Web IQ é um recurso do Azure?

Você implanta um recurso Web IQ em sua assinatura do Azure. O recurso lida com identidade, medição de uso e cobrança.

O serviço em si é hospedado pela Microsoft e multilocatário. A recuperação da Web e a classificação são executadas na infraestrutura da Microsoft, e seu aplicativo chama api.microsoft.ai por HTTPS. O recurso Azure não hospeda o Web IQ e não está no caminho da solicitação.

Onde o Web IQ é implantado?

O Web IQ é hospedado pela Microsoft e está disponível por meio do ponto de extremidade público https://api.microsoft.ai/v3. Seu aplicativo chama a API, e o Web IQ realiza a recuperação da web no servidor.

Há APIs dedicadas para finanças, esportes ou clima?

Não hoje. As APIs dedicadas são Pesquisa na Web, Notícias, Vídeos, Imagens e Navegar. Para finanças, esportes, clima e outros assuntos sem uma API dedicada, use a Pesquisa na Web, que retorna conteúdo rastreado relevante. Esse conteúdo é um texto de página não estruturado em vez de um feed estruturado.

Acesso e integração inicial

Como fazer para passar da avaliação para a produção?

1. Conclua sua avaliação e confirme se o serviço atende aos seus requisitos.
2. Sua assinatura do Azure está habilitada para Web IQ.
3. Implante o recurso Web IQ nessa assinatura e entre no Web IQ Customer Site e conecte o recurso. Isso cria o AppID de produção, que começa no limite padrão de 15 consultas por segundo (QPS).
4. Para autenticar com Entra ID, adicione o client ID do aplicativo a essa AppID no Site do Cliente do IQ da Web.

O uso do Web IQ é regido pelos Termos de Uso do Web IQ, no contexto de seu Contrato de Cliente da Microsoft existente.

Quais assinaturas de Azure posso usar?

Web IQ requer uma assinatura paga do Azure. Os créditos do Azure não funcionam para o Web IQ.

Qual endereço devo usar para entrar?

Use o endereço de entrada da Microsoft que tem acesso ao Web IQ: o endereço da Microsoft habilitado para você ou a conta que você usou para conectar o recurso do Web IQ no Site do Cliente do Web IQ. Normalmente, esse é o endereço usado para Azure, Teams ou Office, que pode ser diferente do seu endereço de caixa de correio.

Para confirmá-lo, entre no portal Azure e verifique o endereço no canto superior direito.

Por que o login diz que eu não tenho acesso?

Primeiro, confirme se o endereço mostrado no canto superior direito do portal Azure corresponde exatamente ao endereço que tem acesso ao Web IQ. As organizações geralmente usam um endereço para login da Microsoft e outro para email.

Se os endereços corresponderem, sua organização poderá bloquear o acesso de convidado entre locatários ao locatário da Microsoft Corporation. Peça ao administrador de TI para permitir esse acesso.

Onde posso obter ajuda?

Visite o site de suporte do Microsoft Web IQ para obter assistência ao produto. Em caso de dúvidas sobre uso permitido, privacidade, armazenamento ou exibição, consulte os atuais Termos de Uso do Web IQ e seu contrato de cliente aplicável.

Autenticação da API

Quais métodos de autenticação têm suporte?

Web IQ é compatível com:

• Microsoft Entra ID tokens Bearer por meio do fluxo de credenciais do cliente OAuth 2.0. Ele é recomendado para cargas de trabalho de produção.
• Chaves de API enviadas no cabeçalho da solicitação x-apikey .

Todo o tráfego de API usa HTTPS.

Como configurar a autenticação de servidor para servidor?

Registre um aplicativo no Microsoft Entra ID e use o fluxo de credenciais do cliente OAuth 2.0. Adicione a ID do cliente do aplicativo ao seu Web IQ AppID no Web IQ Customer Site, adquira um token de acesso e envie-o como Authorization: Bearer <access_token>.

Consulte a Autenticação para obter as etapas de instalação completas.

Posso gerenciar minhas próprias chaves de API?

Sim. Você pode criar quantas chaves de API forem necessárias no Site do Cliente do Web IQ. Não há nenhum custo para a criação de chaves.

O Web IQ usa Azure RBAC para autorização de API?

No. Web IQ é um serviço hospedado pela Microsoft que você acessa pela internet. O recurso do Web IQ que você implanta em sua assinatura do Azure manipula a identidade, a medição e a cobrança, mas não está no caminho da solicitação, portanto, não há nenhum recurso de serviço ao qual funções RBAC do Azure possam ser anexadas.

Web IQ autoriza requisições por AppID. Cada AppID tem seu próprio perfil de qualificação de conteúdo e cota, e chamadas não autorizadas retornam HTTP 403. Para separar equipes ou cargas de trabalho, por exemplo, com diferentes políticas de acesso ou cotas, use vários AppIDs.

Uma Entra ID pode chamar mais de uma AppID?

Sim. Uma única ID do aplicativo Entra (cliente) pode ser autorizada a chamar um ou mais AppIDs. Para escolher o AppID, passe-o como um parâmetro de consulta, por exemplo https://api.microsoft.ai/v3/search/web?appid=<AppID>. A API resolve o AppID da seguinte forma:

• Seu Entra ID está associado a um AppID: se você não especificar um AppID ou especificar esse AppID, a solicitação será bem-sucedida (HTTP 200). Se você especificar um AppID diferente, a solicitação retornará HTTP 403.
• Seu Entra ID está associado a vários AppIDs: você deve especificar um. Um AppID ausente ou em branco retorna HTTP 400; um de seus AppIDs associados é bem-sucedido (HTTP 200); qualquer outro AppID retorna HTTP 403.
• Seu Entra ID não está associado a nenhuma AppID: a solicitação retorna HTTP 401.

A autenticação de chave de API (x-apikey) não é afetada. Cada chave de API está associada a uma única AppID, portanto ?appid= , nunca é necessária ou aceita para chamadas autenticadas por chave.

Qual autenticação um agente hospedado deve usar: Identidade Gerenciada ou AgentID?

Qualquer uma das opções funciona. A Identidade Gerenciada e o AgentID são identidades Entra ID, e o Web IQ aceita qualquer identidade Entra cuja ID do aplicativo (cliente) esteja vinculada ao seu Perfil de Aplicativo do Web IQ na página Gerenciamento de Perfil do Site do Cliente do Web IQ.

Qual deles você usa depende de onde o agente está hospedado:

• A Identidade Gerenciada atende aos agentes executados na infraestrutura do Azure, como Foundry, App Service, Container Apps, AKS, Funções ou VMs. As identidades atribuídas pelo sistema e atribuídas pelo usuário podem ser usadas.
• O AgentID é adequado para o Foundry ou para agentes hospedados pelo Copilot Studio que expõem uma identidade de agente.
• Agentes hospedados fora Azure, por exemplo, em seu próprio cluster do Kubernetes ou em outra nuvem, podem usar um registro de aplicativo Entra padrão com um segredo do cliente ou credencial federada.

Em todos os casos, a chamada usa o fluxo de credenciais do cliente OAuth 2.0 e envia o token como Authorization: Bearer <access_token>. Consulte a Autenticação para obter as etapas de instalação. Uma chave de API no cabeçalho x-apikey continua sendo a opção mais simples para protótipos.

Rede e segurança

O Web IQ dá suporte a Link Privado, pontos de extremidade privados, integração de VNet ou lista de permissões de IP?

No. Nenhum deles é suportado atualmente. O Web IQ é acessado por meio de um único ponto de extremidade público, https://api.microsoft.ai/v3, por HTTPS com Entra ID ou autenticação de chave de API. Não há controle de acesso baseado em IP no ponto de extremidade da API.

O recurso de IQ da Web em sua assinatura Azure manipula identidade, medição e cobrança, mas não está no caminho da solicitação, portanto, Azure controles de rede como Link Privado, integração de VNet, Firewall do Azure, NSGs e topologias hub-and-spoke não têm nada no lado do IQ da Web para associar. A integração de identidade (Entra ID) está alinhada ao Azure; a camada de rede não está.

No seu ambiente, permita o hostname api.microsoft.ai em seus controles de saída.

O tráfego de Azure para o Web IQ permanece na rede da Microsoft ou no backbone do Azure?

Isso não é garantido. Os clientes se conectam ao ponto de extremidade público https://api.microsoft.ai e o tráfego é protegido em trânsito com HTTPS.

O tráfego da API de IQ da Web termina em Azure Front Door, que dá suporte ao TLS 1.2 e ao TLS 1.3 com estes conjuntos de criptografia:

• 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_SHA384, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

O Zscaler ou outra ferramenta de inspeção de saída interferirá no Web IQ?

Ele não deve interferir quando configurado para permitir conexões para api.microsoft.ai. Esta é uma ação padrão de lista de permissões, não um bypass amplo. A mesma abordagem se aplica a outros gateways da Web seguros, como o Netskope.

Posso colocar o Web IQ por trás do Gerenciamento de API do Azure?

Sim. Você pode colocar o Gerenciamento de API do Azure ou outro gateway na frente do Web IQ em sua própria assinatura do Azure para observabilidade e governança, e não há limitações impeditivas conhecidas. As chamadas à API vão do seu chamador para https://api.microsoft.ai/v3 via TLS com uma chave de API ou token de Entra ID, portanto, qualquer coisa que você colocar na frente desse tráfego é sua própria infraestrutura em seu locatário. Microsoft não publica uma arquitetura de referência para essas implantações; sua equipe de arquitetura de nuvem é responsável por esse design.

Nos Termos de Uso do IQ da Web, o conteúdo da resposta não pode ser armazenado em cache ou armazenado para criar um conjunto de dados derivado, independentemente do que o gateway faz. A telemetria operacional, como status, latência, cabeçalhos e IDs de rastreamento, pode ser mantida, por exemplo, no Application Insights ou Log Analytics.

Quais controles de segurança estão disponíveis?

• Autenticação: Entra ID (credenciais de cliente do OAuth 2.0) ou uma chave de API.
• Autorização: acesso por AppID às APIs. Chamadas não autorizadas retornam HTTP 403.
• Limitação de taxa de requisições: imposição de cota por AppID. Solicitações acima do limite retornam HTTP 429.
• Transporte: somente HTTPS.

A política de rede no perímetro é de sua responsabilidade. Se você tiver requisitos de arquitetura específicos que gostaria de avaliar, entre em contato com o Web IQ Support.

Limites de taxa e chaves de API

Há um limite de requisições?

Sim. Cada recurso do Web IQ tem um limite padrão de 15 consultas por segundo (QPS). O limite se aplica ao AppID criado quando você conecta o recurso, e o Web IQ Customer Site o exibe.

O limite é compartilhado entre todas as chaves de API e clientes do Entra ID para esse AppID. Solicitações acima do limite retornam HTTP 429.

Posso aumentar meu limite de taxa de requisições?

Sim. Cada recurso de IQ da Web começa em 15 QPS. Para solicitar um limite mais alto, entre em contato com o Suporte do Web IQ com seu caso de uso e tráfego esperados.

Quantas chaves de API posso criar?

Você pode criar quantas chaves o aplicativo precisar. A criação de chaves é gratuita, mas todas as chaves de um recurso compartilham seu limite de taxa.

Privacidade e manipulação de dados

O Web IQ registra consultas à API?

Sim. As solicitações de API são registradas para fins operacionais: confiabilidade do serviço, depuração e melhoria de qualidade. Isso é padrão para serviços da Microsoft.

• O acesso é restrito ao pessoal autorizado de engenharia e operações Microsoft e é regido pelas políticas internas de controle de acesso da Microsoft. Os dados nos logs não são acessíveis a outros clientes ou terceiros.
• Os logs são armazenados na infraestrutura de produção do Microsoft e estão sujeitos aos controles de segurança padrão da Microsoft, incluindo controle de acesso baseado em função e trilhas de auditoria.
• Os logs são criptografados em trânsito (HTTPS) e em repouso usando as práticas de criptografia padrão do Microsoft.

Microsoft opera como um controlador de dados de acordo com a Declaração de Privacidade da Microsoft.

Por quanto tempo as consultas são retidas?

A retenção da telemetria de consulta é regida pela Seção 4 dos Termos de Uso do Web IQ, o que sujeita o processamento da Microsoft à Declaração de Privacidade da Microsoft. Não há nenhum compromisso de retenção específico do Web IQ separado além do que a Política de Privacidade descreve.

Posso desativar o registro em log de consultas para cargas de trabalho regulamentadas ou confidenciais?

O texto da consulta é capturado como parte da telemetria de solicitação padrão e seu processamento é regido pela Política de Privacidade Microsoft e pela Seção 4 dos Termos de Uso do IQ da Web.

Se você tiver um driver de conformidade ou regulamentação específico, o Web IQ oferecerá Log de Consulta Zero, o que suprimirá o texto da consulta da telemetria. Não é um recurso de autoatendimento; cada caso de uso é revisado e aprovado individualmente e pode ser aplicado a todos os seus aplicativos ou somente a aplicativos específicos. Para solicitá-lo, entre em contato com sua equipe de conta Microsoft e compartilhe:

• A estrutura regulatória ou de conformidade que se aplica (por exemplo, GLBA, HIPAA, GDPR ou APPI).
• Uma breve descrição do seu cenário de implantação.

Quais compromissos de residência de dados o Web IQ fornece?

Nada hoje. O Web IQ não assume compromissos de residência de dados específica por região nem de processamento na região, e o roteamento entre regiões para o ponto de extremidade disponível mais próximo é o comportamento esperado. A privacidade é coberta pela Política de Privacidade Microsoft.

O Web IQ é coberto pelo Azure Data Protection Addendum ou pelo EU Data Boundary?

No. A seção 4.1 dos Termos de Uso do Web IQ exclui o serviço do Adendo de Proteção de Dados de Produtos e Serviços da Microsoft.

Em vez disso, Microsoft e o cliente atuam como controladores de dados independentes para quaisquer Dados Pessoais processados nos Termos de Uso (Seção 4.4). O processamento da Microsoft é regido pela Política de Privacidade da Microsoft (Seção 4.2), e você é responsável por fornecer a notificação apropriada aos seus usuários finais.

Para transferências internacionais, os Termos de Uso incorporam Cláusulas Contratuais Padrão quando necessário (Seção 4.6.1). Esse mecanismo de transferência ocorre por meio dos Termos de Uso, que ficam sob sua Contrato de Cliente da Microsoft, e não por meio do Adendo de Proteção de Dados.

O Web IQ não assume compromissos com EU Data Boundary, residência de dados específica da região ou processamento na região hoje.

O IQ da Web detecta ou mascara dados pessoais em consultas?

No. O Web IQ não executa a detecção do lado do servidor nem o mascaramento de dados pessoais em consultas de entrada. Se uma carga de trabalho puder enviar dados pessoais ou confidenciais, higienize-os antes de chamar o Web IQ, por exemplo, com Linguagem de IA do Azure PII Detection como uma etapa de pré-processamento. Dessa forma, nada sensível deixa seu ambiente e você mantém controle total sobre o que atinge a API.

O IQ da Web dá suporte a setores regulamentados?

Sim. O Web IQ dá suporte a uma variedade de casos de uso corporativos e regulamentados. Se você tiver requisitos especializados de conformidade, governança ou setor, entre em contato com o Web IQ Support.

Segurança e cobertura de conteúdo

Quais controles de segurança de conteúdo são aplicados?

Web IQ aplica classificação de qualidade e segurança em tempo de rastreamento, filtragem de conteúdo adulto e regras de elegibilidade de conteúdo por cliente. O SafeSearch é imposto no strict lado do servidor por padrão. Os resultados da Pesquisa na Web também incluem um campo isAdult para tratamento adicional do lado do cliente.

O Web IQ protege uma LLM contra injeção de prompt no conteúdo recuperado?

Microsoft Web IQ recupera e classifica o conteúdo da Web; ele não executa, interpreta ou age com base em instruções inseridas no conteúdo recuperado. O IQ da Web complementa esse comportamento de recuperação com a qualidade, a confiança, o spam e a triagem de conteúdo mal-intencionado existentes do Bing.

A proteção contra injeção indireta de prompt, tentativas de jailbreak e ataques de seguimento de instruções é principalmente responsabilidade do modelo downstream e da camada de orquestração. Trate os prompts e o conteúdo recuperado como entradas não confiáveis e aplique controles em camadas, como Prompt Shields, Segurança de Conteúdo de IA do Azure, isolamento de prompt do sistema, acesso a ferramentas de privilégio mínimo, validação de fundamentação e validação de saída. Web IQ não deve ser tratado como o único ponto de controle para mitigação de injeção de prompt.

Como o conteúdo da Web é processado antes que o Web IQ o retorne? Ele é sanitizado para instruções semelhantes a prompts?

Microsoft Web IQ não opera diretamente em HTML de página bruta no momento da recuperação. Durante a indexação, o conteúdo da Web é normalizado em uma representação de documento estruturada projetada para preservar conteúdo significativo e estrutura de documentos. As passagens retornadas pelo Web IQ são selecionadas nessa representação, que é o que permite extração e recuperação mais consistentes em toda a API. Os controles existentes do Bing de qualidade, segurança, spam e triagem de conteúdo mal-intencionado também se aplicam como parte do pipeline de indexação.

Essa normalização não deve ser interpretada como uma garantia de que o texto semelhante ao prompt seja identificado ou removido. Trate o conteúdo recuperado como entrada não confiável e aplique as proteções de camada de modelo e orquestração descritas na resposta anterior.

O Web IQ retorna conteúdo de página oculto ou não voltado para o usuário?

Microsoft Web IQ tenta retornar conteúdo visível por meio da interação normal do usuário, incluindo o conteúdo revelado por meio de controles de página comuns ou renderização do lado do cliente. Isso não é garantido. A estrutura e a implementação da página variam, portanto, os aplicativos não devem assumir que cada trecho retornado estava visível no estado inicial da página ou que cada elemento oculto sempre será excluído.

Como Microsoft mantém a qualidade do índice?

As páginas são avaliadas para qualidade, autoridade e confiabilidade. Conteúdo mal-intencionado, spam e phishing é detectado e excluído e o índice é atualizado continuamente. É do mesmo índice do qual dependem os próprios produtos de IA do Microsoft.

Como o IQ da Web respeita as preferências de conteúdo do editor?

O Web IQ foi projetado para honrar os controles de editor com suporte, incluindo diretivas de robots.txt aplicáveis e outros sinais de editor reconhecidos pela Microsoft.

Há uma lista publicada de sites excluídos ou categorias bloqueadas?

No. Os controles de exclusão incluem conformidade com o robots.txt, remoções legais e de conformidade (como avisos DMCA e ordens judiciais), spam, malware e filtragem de phishing e filtragem de conteúdo adulto. As próprias listas são proprietárias e atualizadas continuamente. Se você tiver preocupações sobre categorias específicas de conteúdo que aparecem ou não aparecerem, em resultados, entre em contato com o Web IQ Support para discutir se a configuração do seu Perfil de Aplicativo atende a esses requisitos.

Que conteúdo o Web IQ cobre e quão recente é?

Web IQ recupera continuamente novas informações em páginas da web, notícias e resultados de imagem e vídeo para ajudar seu agente de IA ou aplicativo a responder perguntas além dos dados de treinamento do modelo.

Disponibilidade e atualização variam de acordo com a API, o tipo de origem e o caso de uso; não há uma única garantia de atualização para todo o conteúdo. Considere os requisitos de recência da carga de trabalho ao escolher as fontes e as configurações de recuperação.

Quais idiomas e mercados o Web IQ dá suporte?

O IQ da Web é extraído da Web global, mas a cobertura varia de acordo com o idioma, o mercado, o tópico e o tipo de origem. Examine a página de idiomas e regiões com suporte para os códigos que cada API aceita e avalie a cobertura em relação às informações de que os usuários pretendidos precisam.

Posso configurar listas de permissão ou negação de domínio?

Para domínios individuais ou listas pequenas, use operadores de consulta padrão, como site:example.com para incluir um domínio e -site:example.com para excluir um. Listas configuráveis maiores não são expostas atualmente como um recurso gerenciado pelo cliente.

Por que não vejo resultados do LinkedIn?

Os resultados do LinkedIn estão excluídos no momento.

O que acontece quando Browse é chamado para uma URL excluída?

Navegar retorna HTTP 403. A lista de exclusão base não é exibida.

Como posso tornar meu site detectável para o Web IQ?

Web IQ é criado no mesmo índice da Web que a Microsoft usa para seus próprios produtos de IA. Use práticas padrão de descoberta da Web, como sitemaps, IndexNow, Ferramentas para webmaster do Bing e uma política de robots.txt apropriada. Não há nenhum caminho de envio de Web IQ separado.

Comportamento de consulta e qualidade do resultado

Devo usar consultas de palavra-chave ou linguagem natural?

Ambos funcionam. As consultas em linguagem natural geralmente funcionam bem com contentFormat=passage, enquanto as consultas por palavra-chave são úteis para pesquisas precisas, como nomes de empresas, códigos de negociação ou tópicos específicos. Evite consultas excessivamente longas ou compostas; divida várias necessidades de informações em chamadas de API separadas.

Qual é o tamanho máximo da consulta?

O máximo é de 1.000 caracteres e as consultas mais longas são rejeitadas. Consultas mais curtas e focadas geralmente produzem melhores resultados: se uma consulta contiver muito contexto, a recuperação poderá não se concentrar no sinal certo.

Posso filtrar os resultados da Pesquisa na Web por data?

A Pesquisa na Web não oferece um filtro de intervalo de datas hoje e recomendamos evitar um filtro de data rígido, a menos que você realmente precise de um. A atualidade já é considerada na classificação com base na consulta, e a adição de uma restrição rígida de data quase sempre custa relevância. Para cenários de notícias, use a API de Notícias em vez de filtrar os resultados da Pesquisa na Web por data.

lastUpdatedAt é a data em que o editor atualizou o conteúdo pela última vez, não a data em que o Web IQ verificou a página pela última vez, portanto, uma data mais antiga não significa que a página não foi verificada recentemente. Ele é retornado na resposta, não é um filtro de solicitação e nem todos os resultados o incluem. Você pode usá-lo para classificar ou filtrar resultados em seu aplicativo.

A Pesquisa na Web pode lidar com um prompt que contém várias perguntas?

Cada solicitação de Pesquisa na Web manipula uma consulta. Se um prompt contiver várias perguntas ou intenções, divida-o em consultas separadas em seu aplicativo, chame a Pesquisa na Web para cada uma e combine os resultados antes de gerar a resposta.

O Web IQ pode dar suporte a fluxos de trabalho de agente de várias etapas?

Sim. Um agente pode chamar o Web IQ sempre que precisar de evidências adicionais da web durante uma tarefa. A latência de recuperação é particularmente importante em fluxos de trabalho que fazem várias chamadas antes de produzir uma resposta.

Como meu agente de IA ou aplicativo deve lidar com evidências recuperadas?

Use evidências relevantes para a pergunta e acompanhe quais fontes dão suporte à resposta. Mantenha o conteúdo recuperado separado das instruções que controlam o agente. Quando as fontes entram em conflito ou as evidências estão incompletas, deixe essa incerteza clara em vez de preencher lacunas com afirmações sem fundamento.

Como a qualidade de aterramento se compara?

A Microsoft relata a maior satisfação de fundamentação em sua comparação publicada, com uma pontuação de 79,05. Os resultados dependem do conjunto de consultas, modelo e método de avaliação, portanto, valide a qualidade em seus próprios cenários.

Fonte: resultados de benchmark do Web IQ. 3K Global, Blind Queries amostradas de prod, Config: 10 resultados, 10 mil caracteres por resultado (ou equivalente).

Por que os resultados diferem de Bing.com?

Web IQ é otimizado para consumo de LLM, densidade factual, qualidade de passagem e baixa latência. Bing.com é uma experiência do consumidor com sinais de classificação adicionais, personalização adicional, respostas visuais adicionais e conteúdo adicional que podem não ser redistribuíveis por meio de uma API. Algumas diferenças de classificação são esperadas.

Solicitações idênticas podem retornar resultados diferentes?

Alguma variação é esperada porque o índice é atualizado continuamente e as atualizações se propagam entre data centers. Os resultados de solicitações idênticas feitas em sequência próxima devem permanecer amplamente estáveis. Se você vir uma variação significativa em consultas idênticas em segundos, entre em contato com o Web IQ Support.

Por que uma consulta retorna menos resultados do que o esperado?

Verifique a resposta bruta do Web IQ antes de contar os resultados. A causa mais comum é uma configuração do lado do cliente ou uma etapa de pipeline downstream que filtra os resultados válidos antes de serem medidos. maxResultsVerifique também a qualificação de conteúdo, o comportamento do SafeSearch e quaisquer site: operadores ou -site: operadores na consulta.

Conteúdo da resposta

Por que a Pesquisa na Web e a Pesquisa de Notícias não retornam um campo snippet?

Isso é intencional. Ambos retornam content como um trecho dependente de consulta (passage) em vez de um snippet separado e independente de consulta.

Quais formatos de conteúdo a Pesquisa na Web dá suporte?

Com passage, cada resultado retorna as partes do documento mais relevantes para a consulta, até maxLength caracteres (sem acesso completo ao documento, no máximo 3.000). É o formato recomendado para aterramento. Aplicativos com acesso completo a documentos também podem usar text, htmle markdown. Consulte Passagens e formatos de conteúdo.

O que é passagee por que usá-lo?

Defina contentFormat=passage e a API retorna, para cada resultado, apenas os segmentos do documento mais relevantes para a consulta, não o documento completo. O documento completo é processado do lado do Web IQ, e o que retorna é um trecho direcionado à consulta, para que sua LLM não precise passar por parágrafos não relacionados para encontrar a sentença relevante.

• Economia de token: a LLM recebe uma fração do documento em vez de tudo isso.
• Melhor factualidade: com menos conteúdo fora do tópico no contexto, o modelo tem menos probabilidade de ancorar em um parágrafo tangencial.

Defina contentFormat=passage em cada solicitação de Web Search and News. O Browse não dá suporte a passage, pois ele busca uma URL específica que você já escolheu e não há nenhuma consulta na qual extrair.

Qual é o valor máximo maxResults para a Pesquisa na Web?

A Pesquisa na Web dá suporte a até 50 resultados por solicitação.

Quais parâmetros de solicitação posso configurar?

A Pesquisa na Web expõe maxResults, language e region, contentFormat (passage, text, htmlou markdown), maxLengthe safeSearch. Consulte a referência de API para a lista de parâmetros completa.

Qual é a diferença entre lastUpdatedAt e crawledAt?

lastUpdatedAt é a data de atualização de conteúdo relatada pelo editor, retornada por Pesquisa na Web, Notícias, Vídeos, Imagens, Browse e Auto quando disponível. crawledAt é a hora em que o Web IQ buscou a página pela última vez, retornada por Pesquisa na Web, Procurar, Notícias e Auto. A cobertura de ambos os campos varia de acordo com o resultado.

Como ajustar maxResults e maxLength para gerenciar os custos de janela de contexto e token?

O IQ da Web pode priorizar passagens relevantes para uma consulta em vez de fornecer contexto de página desnecessário. Isso pode reduzir a quantidade de texto passado para seu modelo e reduzir os custos de token de entrada. Os benefícios dependem do seu modelo, dos prompts, da combinação de consultas e das configurações de recuperação.

Para a maioria dos cenários de grounding, mais resultados com passagens mais curtas produzem resultados melhores do que menos resultados com passagens mais longas para aproximadamente o mesmo orçamento total de tokens. Um bom ponto de partida é maxResults=10 com maxLength cerca de 3.000 caracteres em passage formato. Faça testes comparativos com suas próprias consultas e seu modelo.

O que é Browse Live Crawl e quando devo usá-lo?

O Browse retorna conteúdo do índice Da Web do Bing, que é atualizado continuamente conforme nossos rastreadores observam alterações na Web. É assim que a pesquisa na Web funciona em geral: os resultados da pesquisa são fornecidos a partir de um índice, em vez de buscar cada URL em tempo real em cada solicitação, e é isso que dá ao Browse sua velocidade e consistência.

Para cenários que precisam especificamente de uma busca just-in-time da URL no momento da solicitação, como monitoramento em tempo real, verificações competitivas ou fluxos de trabalho que disparam em uma alteração que você sabe que acabou de acontecer, o Browse dá suporte ao Live Crawl. Defina liveCrawl: "fallback" na solicitação para ativar uma busca dinâmica quando a cópia indexada estiver ausente ou obsoleta. Omitir o parâmetro (ou definir liveCrawl: "none") retorna apenas o conteúdo indexado. Consulte a referência da API Browse para obter detalhes completos do parâmetro.

O Live Crawl está disponível por padrão no Web IQ Browse e é provisionado com um teto de capacidade modesto por segundo, separado do QPS geral do Browse. Esse teto é compartilhado entre todas as chaves de API sob o AppID. A maioria das cargas de trabalho do Browse não precisa do Live Crawl e são melhor atendidas pelo caminho indexado padrão; use o Live Crawl para o conjunto estreito de cenários acima.

O Browse pode recuperar páginas renderizadas em JavaScript?

Sim. Use renderDynamicPages: true em conjunto com liveCrawl: "fallback". Consulte a referência da Browse API para obter os detalhes completos do conjunto de parâmetros e da resposta. Teste URLs representativas antes de depender desse comportamento na produção.

O Browse pode extrair arquivos PDF online?

PDFs hospedados online não são um cenário de Navegação documentado hoje. Se você tiver um caso específico de uso de PDF, entre em contato com o Web IQ Support com uma URL representativa e o comportamento esperado e obterá uma resposta definitiva.

Cobrança e jurídico

Quanto custa o Web IQ?

O Web IQ usa preços baseados em consumo por chamada. O preço depende das APIs habilitadas para sua conta, seu uso e seus termos comerciais. Consulte Preços para ver as taxas atuais.

O IQ da Web inclui um compromisso SLA, RTO ou RPO?

No. Microsoft Web IQ não inclui um contrato de nível de serviço. Os Termos de Uso do Web IQ não se comprometem com metas de disponibilidade, latência, RTO (Objetivo de Tempo de Recuperação) ou RPO (Objetivo de Ponto de Recuperação), e os termos do SLA não são adicionados para clientes individuais.

Preciso exibir citações?

Sim. A Exibição A, Seção 1 (Uso de LLM) dos Termos de Uso do Web IQ requer a atribuição de origem e um link de volta para cada fonte usada para o conteúdo de LLM exibido, próximo a esse conteúdo.

• Cite apenas as fontes realmente usadas para gerar a resposta. Se o IQ da Web retornou 10 resultados e seu modelo usou 3, exiba esses 3.
• As citações devem permanecer visíveis com a resposta e ser acessíveis com uma única ação. Não os mostre apenas brevemente, oculte-os atrás de várias telas ou exija que os usuários solicitem referências separadamente.
• Para interfaces restritas, como carros, wearables, dispositivos de voz ou quiosques, use um código QR persistente que leva a uma página listando cada citação usada na resposta atual, um aplicativo complementar que mostra a resposta com citações clicáveis ou uma lista na tela que o usuário pode abrir diretamente.

Você pode armazenar citações como parte do histórico de chat de um usuário final individual por até 30 dias. Veja a pergunta de cache abaixo.

Quanto conteúdo de origem meu agente de IA ou aplicativo pode exibir?

O Anexo A dos Web IQ Terms of Use limita o Conteúdo de Grounding exibido de qualquer fonte única ao menor entre 200 caracteres e o máximo especificado pelo proprietário do site ou webmaster. Para experiências de voz ou áudio, aplique o mesmo limite à saída falada. Aplicam-se restrições adicionais a resumos e visualização. Examine os Termos de Uso antes de criar trechos; esse limite não é permissão para reproduzir páginas de origem inteiras.

Os resultados de imagem e vídeo podem ser usados para fundamentar uma LLM?

Metadados de imagem e vídeo e texto alt são incluídos na definição de Grounding Content. No entanto, os Termos de Uso do Web IQ proíbem o uso de imagens ou vídeos reais de resultados para fundamentação, incluindo-os na saída de LLM ou na criação de imagens ou vídeos derivados deles. Examine os termos da implementação pretendida.

Posso armazenar em cache ou armazenar o conteúdo do Web IQ?

Como regra geral, não. Os Termos de Uso do Web IQ proíbem copiar, armazenar, armazenar em cache, arquivar ou criar um banco de dados de conteúdo, exceto em exceções limitadas (Seção 3.2.15 e Seção 4 dos Anexos A e B):

• Histórico de chat do usuário final (até 30 dias): o conteúdo pode ser armazenado de forma não agregada, por usuário final, para o histórico de chat de um usuário final individual por até 30 dias. Para uso de LLM (Anexo A), isso aborda o conteúdo em geral; para uso para pesquisa (Anexo B), isso abrange URLs de imagem e vídeo.
• Processamento transitório de Ação Atômica: o conteúdo pode ser mantido em um estado de processamento transitório apenas conforme estritamente necessário para concluir uma única solicitação lógica ou fluxo de trabalho iniciado por uma LLM (uma "Ação Atômica", que pode envolver várias etapas internas ou interações de agente). O conteúdo deve ser excluído imediatamente quando a Ação Atômica for concluída.
• Seu próprio produto de trabalho: na medida permitida pela lei de direitos autorais, o conteúdo pode ser copiado ou armazenado como parte integrada de seu próprio produto de trabalho, desde que o produto de trabalho não seja criado para substituir os Serviços (por exemplo, criar um banco de dados de Conteúdo, indexar links para rastreamento ou oferecer uma pesquisa separada).

Fora dessas exceções, os Termos de Uso não permitem bancos de dados derivados, cache persistente ou arquivamento de longo prazo de Conteúdo.

Onde posso ler os Termos de Uso do Web IQ?

Os termos atuais são publicados em Microsoft Termos de Uso do Web IQ. Elas se aplicam junto com o seu Contrato de Cliente da Microsoft existente.

Acesso completo ao documento

Por que eu recebo HTTP 403 quando eu configuro contentFormat para html?

Na Pesquisa na Web e na Pesquisa de Notícias, text, html e markdown retornam o documento completo e estão disponíveis para aplicativos com acesso completo ao documento. Outros aplicativos obtêm HTTP 403 com o código AuthContentFormatForbiddende erro. passage funciona em qualquer aplicativo. Consulte Trechos e formatos de conteúdo.

Como fazer para solicitar acesso completo ao documento?

Abra uma solicitação de suporte do Web IQ por meio do Suporte do Azure e escolha a categoria Conteúdo de página inteira. Aplicativos que já usam html ou text continuam funcionando como hoje.