Perguntas frequentes do Microsoft Web IQ

Respostas a perguntas comuns sobre o uso do Microsoft Web IQ. Para detalhes da API e exemplos de pedidos, consulte a referência da API.

Serviço e implementação

O que é o Microsoft Web IQ?

O Microsoft Web IQ é um conjunto de APIs nativas de pesquisa e grounding web nativas de IA que dá a LLMs, agentes de IA e aplicações acesso a informação web atual e relevante. Isto permite respostas de IA mais precisas e atualizadas, com fontes que os utilizadores podem verificar. O Web IQ impulsiona assistentes de IA de ponta, incluindo Microsoft Copilot e ChatGPT.

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

O que é o grounding web e quando é que um agente de IA precisa dele?

A ancoragem na Web dá à IA acesso à informação mais recente da Web, para que possa responder usando factos atuais para além dos seus dados de treino, com fontes citadas que os utilizadores podem consultar. Ajuda sobretudo com informações que mudam frequentemente, como desenvolvimentos de mercado, atividade dos concorrentes, notícias e atualizações regulatórias.

Web IQ é um LLM? Gera a resposta final?

No. Web IQ não é um modelo de IA nem um LLM. É um conjunto de APIs de pesquisa e grounding nativas da IA que dá a LLMs, agentes de IA e aplicações acesso a informações web atuais e relevantes.

O Web IQ não gera a resposta final da IA. Recupera informação relevante da web, e o seu LLM, agente de IA ou lógica de aplicação escolhido usa essa evidência para gerar uma resposta.

O que torna o Web IQ diferente de outras APIs de pesquisa web e serviços de grounding?

A maioria das APIs de pesquisa web exige um compromisso: rápido ou preciso, económico em termos de custos ou completo. Na comparação publicada pela Microsoft, o Web IQ oferece a maior satisfação com a fundamentação, a velocidade mais rápida e o menor número de tokens por consulta. É a mesma plataforma em que assistentes de IA como o Copilot e o ChatGPT confiam todos os dias, comprovada à escala global e pronta para que qualquer agente ou aplicação de IA possa desenvolver sobre ela.

O Web IQ também se diferencia pela forma como acede ao conteúdo. Adota uma abordagem responsável ao acesso à web, unindo a web aberta e os dados estruturados com segurança e proteções de nível empresarial incorporadas.

O Web IQ funciona com a stack de IA que já usas. Pode usar o seu modelo de IA preferido e ligar-se através da API REST ou do Model Context Protocol (MCP), sem estar ligado a um único modelo ou plataforma.

Fonte: resultados do benchmark Web IQ (secções de Qualidade, Eficiência e Velocidade).

O que posso construir com Web IQ?

O Web IQ alimenta agentes e aplicações de IA que precisam de informação fresca e externa da web pública. As equipas internas podem utilizá-lo para inteligência competitiva, monitorização, investigação regulatória, inteligência de vendas e otimização de conteúdos. As experiências de contacto com o cliente podem ser usadas para investigação, descoberta, recomendações e agentes especializados.

É mais indicado para cenários onde a informação muda frequentemente, abrange várias fontes externas e precisa de estar fundamentada em conteúdos web atuais e atribuíveis.

Qual API Web IQ se adequa ao meu caso de uso?

Utilize a Web Search API para encontrar páginas públicas e passagens relevantes para o 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 já souber a URL. Verifique a referência da API para as capacidades e limites disponíveis para a sua conta.

Posso usar o Web IQ com o meu modelo de IA e framework de agentes existentes?

Yes. O Web IQ permite-lhe adicionar informação web ao modelo de IA e ao fluxo de trabalho do agente que escolher. As APIs REST e o MCP dão-te flexibilidade na forma como te ligas. Verifique a documentação do SDK e a documentação de integração do MCP para configurações suportadas.

Como funciona a integração?

O seu agente ou aplicação de IA chama o Web IQ para obter evidências na web, depois passa resultados selecionados ao seu modelo para gerar uma resposta. Controlas como a informação é selecionada, usada e citada. Siga o Quickstart para ligar o seu primeiro fluxo de trabalho, ou comece a usar o Playground.

O Web IQ pode recuperar informações sobre empresas privadas?

No. O Web IQ recupera informação da web pública. Para o contexto empresarial, a Microsoft oferece Work IQ, Fabric IQ e Foundry IQ, cada um com funções diferentes, desde o contexto organizacional até aos dados empresariais e ao conhecimento empresarial.

Como é que o Web IQ se relaciona com o Foundry IQ, Work IQ e Fabric IQ?

A Microsoft IQ reúne quatro camadas integradas que impulsionam a inteligência empresarial em toda a Microsoft. O Web IQ fornece informação da web pública. O Work IQ foca-se nos sinais de trabalho, o Fabric IQ em dados empresariais e o Foundry IQ no conhecimento organizacional. Estes produtos respondem a diferentes necessidades de informação para agentes e aplicações de IA e são mais poderosos quando usados em conjunto.

O Web IQ é um recurso do Azure?

Implemente um recurso Web IQ na sua subscrição do Azure. O recurso trata da gestão de identidades, medição e faturação.

O serviço em si é alojado pela Microsoft e multitenant. A recuperação web e o ranking decorrem na infraestrutura da Microsoft, e a tua aplicação chama api.microsoft.ai através de HTTPS. O recurso do Azure não aloja o Web IQ e não está no caminho do pedido.

Onde é implementado o Web IQ?

O Web IQ é alojado pela Microsoft e está disponível através do endpoint públicohttps://api.microsoft.ai/v3. A sua aplicação chama a API, e o Web IQ realiza a recuperação web do lado do servidor.

Existem APIs dedicadas para finanças, desporto ou meteorologia?

Hoje não. As APIs dedicadas são Pesquisa Web, Notícias, Vídeos, Imagens e Navegação. Para finanças, desporto, meteorologia e outros temas sem uma API dedicada, use a Web Search, que devolve conteúdos relevantes rastreados. Esse conteúdo é texto de página não estruturado em vez de um feed estruturado.

Acesso e integração inicial

Como é que passo da avaliação para a produção?

1. Complete a sua avaliação e confirme que o serviço cumpre os seus requisitos.
2. A sua subscrição do Azure está ativada para o Web IQ.
3. Implemente o recurso Web IQ nessa subscrição, depois inicie sessão no site do cliente Web IQ e ligue o recurso. Isto cria o seu AppID de produção, que começa no limite padrão de 15 consultas por segundo (QPS).
4. Para autenticar com o Entra ID, adicione o ID do cliente da sua aplicação a esse AppID no Site do Cliente Web IQ.

A sua utilização do Web IQ é regida pelos Termos de Utilização do Web IQ, no contexto do seu Contrato de Cliente da Microsoft existente.

Que subscrições do Azure posso usar?

O Web IQ exige uma subscrição paga do Azure. Créditos do Azure não funcionam para o Web IQ.

Que endereço de e-mail devo usar para iniciar sessão?

Utilize o endereço de início de sessão da Microsoft que tenha acesso ao Web IQ: o endereço que a Microsoft ativou para si, ou a conta que utilizou para ligar o seu recurso Web IQ no site do cliente Web IQ. Normalmente, este é o endereço que usa para o Azure, Teams ou Office, que pode diferir do endereço da sua caixa de correio.

Para confirmar, inicie sessão no portal do Azure e verifique o endereço no canto superior direito.

Porque é que o login diz que não tenho acesso?

Primeiro, confirme se o endereço mostrado no canto superior direito do portal do Azure corresponde exatamente ao endereço que tem acesso ao Web IQ. As organizações costumam usar um endereço para iniciar sessão na Microsoft e outro para email.

Se os endereços coincidirem, a sua organização pode bloquear o acesso de convidados entre tenants ao tenant da Microsoft Corporation. Peça ao seu administrador de TI para permitir esse acesso.

Onde posso obter ajuda?

Visite o site de suporte do Microsoft Web IQ para assistência de produtos. Para questões sobre uso permitido, privacidade, armazenamento ou visualização, consulte os Termos de Utilização atuais da Web IQ e o seu acordo de cliente aplicável.

Autenticação por API

Que métodos de autenticação são suportados?

O Web IQ é compatível com:

• Tokens bearer do Microsoft Entra ID através do fluxo de credenciais do cliente OAuth 2.0. Isso é recomendado para cargas de trabalho de produção.
• Chaves API enviadas no cabeçalho do x-apikey pedido.

Todo o tráfego API utiliza HTTPS.

Como configuro a autenticação servidor para servidor?

Registe uma aplicação no Microsoft Entra ID e utilize o fluxo de credenciais do cliente OAuth 2.0. Adicione o ID de cliente da aplicação ao seu Web IQ AppID no site do cliente Web IQ, adquira um token de acesso e envie-o como Authorization: Bearer <access_token>.

Consulte Autenticação para os passos completos de configuração.

Posso gerir as minhas próprias chaves de API?

Yes. Pode criar tantas chaves API quanto precisar a partir do Site do Cliente Web IQ. Não há custo para criar chaves.

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

No. O Web IQ é um serviço alojado pela Microsoft ao qual acede através da internet. O recurso Web IQ que implementar na sua subscrição do Azure trata da autenticação e autorização, medição e faturação, mas não está no caminho do pedido, por isso não existe um recurso de serviço ao qual as funções RBAC do Azure se possam anexar.

O Web IQ autoriza solicitações por AppID. Cada AppID tem o seu próprio perfil de elegibilidade de conteúdo e quota, e chamadas não autorizadas devolvem HTTP 403. Para separar equipas ou cargas de trabalho, por exemplo com políticas de acesso ou quotas diferentes, use múltiplos AppIDs.

É possível que um Entra ID chame mais do que um AppID?

Yes. Um único ID de aplicação Entra (cliente) pode ser autorizado a invocar 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 interface API determina o AppID da seguinte forma:

• O seu Entra ID está ligado a um AppID: se não especificar um AppID, ou especificar esse AppID, o pedido tem sucesso (HTTP 200). Se especificar um AppID diferente, o pedido devolve HTTP 403.
• O seu Entra ID está ligado a vários AppIDs: deve especificar um. Um AppID em falta ou em branco devolve HTTP 400; um dos seus AppIDs associados tem sucesso (HTTP 200); qualquer outro AppID devolve HTTP 403.
• O seu Entra ID não está ligado a nenhum AppID: o pedido devolve HTTP 401.

A autenticação por chave API (x-apikey) não é afetada. Cada chave API está ligada a um único AppID, pelo que ?appid= nunca é necessária ou aceite para chamadas autenticadas por chave.

Que autenticação deve um agente hospedado usar: Identidade Gerida ou AgentID?

Qualquer um serve. Identidade Gerida e AgentID são ambas identidades Entra ID, e o Web IQ aceita qualquer identidade Entra cujo ID de aplicação (cliente) esteja ligado ao seu Perfil de Aplicação Web IQ a partir da página de Gestão de Perfis do Site do Cliente Web IQ.

Qual delas utiliza depende de onde o agente está alojado:

• Identidade Gerida é adequada para agentes que são executados na infraestrutura do Azure, como Foundry, App Service, Container Apps, AKS, Functions ou VMs. Identidades atribuídas pelo sistema e atribuídas pelo utilizador funcionam ambas.
• O AgentID adequa-se a agentes alojados no Foundry ou no Copilot Studio que expõem uma identidade de agente.
• Agentes alojados fora do Azure, por exemplo no seu próprio cluster Kubernetes ou noutra nuvem, podem usar um registo padrão de aplicação Entra com um segredo do cliente ou credencial federada.

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

Redes e segurança

O Web IQ suporta Private Link, endpoints privados, integração com VNet ou IP-allowlisting?

No. Nenhuma destas opções é hoje em dia suportada. O Web IQ é acedido através de um único endpoint público, https://api.microsoft.ai/v3, via HTTPS com Entra ID ou autenticação por chave API. Não existe controlo de acesso baseado em IP no endpoint da API.

O recurso Web IQ na tua subscrição Azure trata da identidade, medição e faturação, mas não está no caminho da solicitação, por isso os controlos de rede do Azure como Private Link, integração com VNet, Azure Firewall, NSGs e topologias hub-and-spoke não têm nada do lado do Web IQ a que se ligar. A integração de identidade (Entra ID) é alinhada com o Azure; a camada de rede não é.

Do seu lado, permita o api.microsoft.ai hostname nos seus controlos de saída.

O tráfego do Azure para o Web IQ mantém-se na rede da Microsoft ou no backbone do Azure?

Isto não é garantido. Os clientes ligam-se ao endpoint público https://api.microsoft.ai e o tráfego é protegido durante o trânsito com HTTPS.

O tráfego da API Web IQ termina no Azure Front Door, que suporta TLS 1.2 e TLS 1.3 com estas suites de cifras:

• 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 vai interferir com o Web IQ?

Não deve interferir quando configurado para permitir ligações a api.microsoft.ai. Esta é uma ação padrão de lista de permissões, não um desvio abrangente. A mesma abordagem aplica-se a outros gateways web seguros, como o Netskope.

Posso colocar o Web IQ atrás do API Management do Azure?

Yes. Pode colocar o API Management do Azure ou outro gateway à frente do Web IQ na sua própria subscrição Azure para observabilidade e governação, e não existem limitações de bloqueio conhecidas. As chamadas API vão do seu chamador para https://api.microsoft.ai/v3 via TLS com uma chave API ou token Entra ID, por isso tudo o que colocar à frente desse tráfego é a sua própria infraestrutura no seu tenant. A Microsoft não publica uma arquitetura de referência para estas implementações; a sua equipa de arquitetura cloud é responsável por esse design.

Segundo os Termos de Utilização Web IQ, o conteúdo de resposta não pode ser armazenado em cache ou armazenado para construir um conjunto de dados derivados, independentemente do que o gateway faça. Telemetria operacional, como estado, latência, cabeçalhos e IDs de traço, pode ser mantida, por exemplo no Application Insights ou no Log Analytics.

Que controlos de segurança estão disponíveis?

• Autenticação: Entra ID (credenciais do cliente OAuth 2.0) ou uma chave API.
• Autorização: acesso por AppID a APIs. Chamadas não autorizadas retornam HTTP 403.
• Limitação da taxa de pedidos: aplicação de quotas por AppID. Solicitações acima do limite retornam HTTP 429.
• Transporte: apenas por HTTPS.

A política de rede no seu perímetro é da sua responsabilidade. Se tiver requisitos específicos de arquitetura que gostaria que fossem avaliados, contacte o Suporte Web IQ.

Limites de taxa de pedidos e chaves de API

Existe algum limite de pedidos?

Yes. Cada recurso Web IQ tem um limite padrão de 15 consultas por segundo (QPS). O limite aplica-se ao AppID criado quando se liga o recurso, e o Web IQ Customer Site o apresenta.

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

Posso aumentar o meu limite de pedidos?

Yes. Cada recurso Web IQ parte de 15 QPS. Para solicitar um limite superior, contacte o Suporte Web IQ com o seu tráfego e caso de uso esperado.

Quantas chaves de API posso criar?

Pode criar tantas chaves quanto a sua aplicação precisar. A criação de chaves é gratuita, mas todas as chaves de um recurso partilham o seu limite de taxa.

Privacidade e tratamento de dados

O Web IQ regista consultas à API?

Yes. Os pedidos de API são registados para fins operacionais: fiabilidade do serviço, depuração e melhoria da qualidade. Isto é padrão para os serviços Microsoft.

• O acesso é restrito a pessoal autorizado de engenharia e operações da Microsoft e é regulado pelas políticas internas de controlo de acesso da Microsoft. Os dados nos registos não estão acessíveis a outros clientes ou terceiros.
• Os registos são armazenados na infraestrutura de produção da Microsoft e estão sujeitos aos controlos de segurança padrão da Microsoft, incluindo controlo de acesso baseado em funções e registos de auditoria.
• Os registos são encriptados em trânsito (HTTPS) e em repouso, utilizando as práticas padrão de encriptação da Microsoft.

A Microsoft opera como um controlador de dados ao abrigo da Declaração de Privacidade da Microsoft.

Quanto tempo é que as consultas permanecem?

A retenção da telemetria de consulta é regida pela Secção 4 dos Termos de Utilização Web IQ, que sujeitam o processamento da Microsoft à Declaração de Privacidade da Microsoft. Não existe um compromisso de retenção específico do Web IQ para além do que a Declaração de Privacidade descreve.

Posso desativar o registo de consultas para cargas de trabalho reguladas ou sensíveis?

O texto da consulta é capturado como parte da telemetria padrão de pedidos, e o seu processamento é regulado pela Declaração de Privacidade da Microsoft e pela Secção 4 dos Termos de Utilização Web IQ.

Se tiver um requisito regulatório ou de conformidade específico, o Web IQ oferece Zero Query Logging, que suprime o texto da consulta da telemetria. Não é uma funcionalidade de autoatendimento; cada caso de uso é revisto e aprovado individualmente, e pode aplicar-se a todas as suas aplicações ou apenas a específicas. Para solicitá-lo, contacte a sua equipa da conta Microsoft e partilhe:

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

Que compromissos de residência em dados oferece a Web IQ?

Nada hoje. O Web IQ não assume compromissos específicos de residência de dados ou compromissos de processamento na região, e o encaminhamento entre regiões para o ponto final disponível mais próximo é um comportamento esperado. A privacidade está coberta pela Declaração de Privacidade da Microsoft.

O Web IQ está coberto pelo Adendo de Proteção de Dados do Azure ou pelo Limite de Dados da UE?

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

Em vez disso, a Microsoft e o cliente atuam como controladores de dados independentes para quaisquer Dados Pessoais processados ao abrigo dos Termos de Utilização (Secção 4.4). O processamento da Microsoft é regido pela Declaração de Privacidade da Microsoft (Secção 4.2), e você é responsável por dar o aviso adequado aos seus utilizadores finais.

Para transferências internacionais, os Termos de Utilização incorporam Cláusulas Contratuais Padrão quando necessário (Secção 4.6.1). Esse mecanismo de transferência passa pelos Termos de Utilização, que estão sob o seu Contrato de Cliente Microsoft, e não pelo Adendo de Proteção de Dados.

O Web IQ não assume atualmente compromissos de Fronteira de Dados da UE, residência de dados específicos por região ou processamento dentro da região.

O Web IQ deteta ou mascara dados pessoais nas consultas?

No. O Web IQ não realiza deteção ou mascaramento de dados pessoais no lado do servidor em consultas recebidas. Se uma carga de trabalho puder enviar dados pessoais ou sensíveis, limpe-os antes de invocar o Web IQ, por exemplo, com o Linguagem da IA do Azure PII Detection como passo de pré-processamento. Assim, nada de sensível sai do ambiente e manténs controlo total sobre o que chega à API.

O Web IQ apoia indústrias reguladas?

Yes. O Web IQ suporta uma variedade de casos de uso empresariais e regulados. Se tiver requisitos especializados de conformidade, governação ou da indústria, contacte o Suporte Web IQ.

Segurança do conteúdo e cobertura

Que controlos de segurança de conteúdos são aplicados?

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

O Web IQ protege um LLM de injeção de prompts em conteúdos recuperados?

O Microsoft Web IQ recupera e classifica conteúdos da web; não executa, interpreta nem age segundo instruções embutidas no conteúdo recuperado. O Web IQ complementa este comportamento de recuperação com a triagem de qualidade, confiança, spam e conteúdo malicioso existente do Bing.

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

Como é que o conteúdo web é processado antes de o Web IQ o devolver? Está desinfetado para instruções do tipo prompt?

O Microsoft Web IQ não opera diretamente em HTML bruto da página aquando da obtenção. Durante a indexação, o conteúdo web é normalizado numa representação estruturada do documento concebida para preservar conteúdos significativos e a estrutura do documento. As passagens devolvidas pelo Web IQ são selecionadas dessa representação, o que permite uma extração e recuperação mais consistentes em toda a API. A triagem existente de qualidade, segurança, spam e conteúdo malicioso da Bing também se aplica como parte do pipeline de indexação.

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

O Web IQ retorna conteúdo oculto ou não voltado para o utilizador?

A Microsoft Web IQ tenta devolver conteúdo visível através da interação normal do utilizador, incluindo conteúdo revelado através de controlos normais de página ou renderização do lado do cliente. Isto não é garantido. A estrutura e implementação da página variam, pelo que as aplicações não devem assumir que cada trecho retornado era visível no estado inicial da página ou que todos os elementos ocultos serão sempre excluídos.

Como é que a Microsoft mantém a qualidade do índice?

As páginas são avaliadas quanto à qualidade, autoridade e fiabilidade. Conteúdos maliciosos, spam e de phishing são detetados e excluídos, e o índice é continuamente atualizado. É o mesmo índice de que dependem os próprios produtos de IA da Microsoft.

Como é que a Web IQ respeita as preferências de conteúdo dos editores?

O Web IQ foi concebido para respeitar os controlos suportados pelos editores, incluindo diretivas de robots.txt aplicáveis e outros sinais dos editores reconhecidos por Microsoft.

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

No. Os controlos de exclusão incluem conformidade com o robots.txt, remoções legais e de conformidade (como avisos DMCA e ordens judiciais), filtragem de spam, malware e phishing, e filtragem de conteúdos para adultos. As próprias listas são proprietárias e continuamente atualizadas. Se tiver preocupações sobre categorias específicas de conteúdo que aparecem ou não nos resultados, contacte o Suporte Web IQ para discutir se a configuração do seu Perfil de Aplicação responde a esses requisitos.

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

O Web IQ recupera continuamente informação nova em páginas web, notícias e resultados de imagens e vídeos para ajudar o seu agente ou aplicação de IA a responder a perguntas para além dos dados de treino do seu modelo.

A disponibilidade e a frescura variam consoante a API, o tipo de origem e o caso de uso; não existe uma garantia única de frescura em todo o conteúdo. Considere os requisitos de recência da sua carga de trabalho ao escolher as fontes e as definições de recuperação.

Que línguas e mercados suporta o Web IQ?

O Web IQ baseia-se na web global, mas a cobertura varia consoante a língua, mercado, tema e tipo de fonte. Consulte a página Línguas e regiões suportadas para os códigos que cada API aceita e avalie a cobertura face à informação de que os seus utilizadores necessitam.

Posso configurar listas de permissões ou de bloqueio de domínios?

Para domínios individuais ou listas pequenas, utilize 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 estão atualmente expostas como uma funcionalidade gerida pelo cliente.

Porque é que não vejo resultados no LinkedIn?

Os resultados do LinkedIn estão atualmente excluídos.

O que acontece quando o Browse é chamado para um URL excluído?

O Browse retorna o erro HTTP 403. A lista de exclusão subjacente não é apresentada.

Como posso tornar o meu site detetável pelo Web IQ?

O Web IQ baseia-se no mesmo índice web que a Microsoft utiliza para os seus próprios produtos de IA. Utilize práticas padrão de descoberta web, como sitemaps, IndexNow, Ferramentas do Webmaster do Bing e uma política de robots.txt adequada. Não existe um caminho separado para submissão do Web IQ.

Comportamento das consultas e qualidade dos resultados

Devo usar linguagem natural ou consultas por palavras-chave?

Ambos funcionam. As consultas em linguagem natural funcionam frequentemente bem com contentFormat=passage, enquanto as consultas por palavras-chave são úteis para pesquisas precisas, como nomes de empresas, tickers ou tópicos específicos. Evite consultas demasiado longas ou compostas; divida múltiplas necessidades de informação em chamadas API separadas.

Qual é o comprimento máximo da consulta?

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

Posso filtrar os resultados da pesquisa web por data?

A Web Search não oferece hoje um filtro por intervalo de datas, e recomendamos evitar um filtro rígido de datas, a menos que realmente precise de um. A atualidade já é considerada na classificação com base na pesquisa, e adicionar uma restrição de data fixa quase sempre custa relevância. Para cenários de notícias, utilize a News API em vez de filtrar os resultados da Web Search 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, por isso uma data mais antiga não significa que a página não tenha sido verificada recentemente. É devolvido na resposta, não é um filtro de pedido, e nem todos os resultados o incluem. Podes usá-lo para ordenar ou filtrar resultados na tua aplicação.

Será que a Web Search consegue responder a um prompt que contém várias perguntas?

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

O Web IQ pode suportar fluxos de trabalho de agentes em múltiplos passos?

Yes. Um agente pode contactar a Web IQ sempre que precisar de evidência adicional da Web durante uma tarefa. A latência de recuperação é particularmente importante em fluxos de trabalho que fazem várias chamadas antes de produzirem uma resposta.

Como deve o meu agente ou aplicação de IA lidar com as evidências obtidas?

Utilize evidências relevantes para a questão e acompanhe quais as fontes que apoiam a resposta. Mantenha o conteúdo recuperado separado das instruções que controlam o agente. Quando as fontes entram em conflito ou a evidência está incompleta, deixe essa incerteza clara em vez de preencher lacunas com afirmações não fundamentadas.

Como é que a qualidade da fundamentação se compara?

A Microsoft apresenta o mais alto nível de satisfação de grounding na 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, por isso valida a qualidade nos teus próprios cenários.

Fonte: resultados do benchmark Web IQ. 3K Global, consultas cegas amostradas da produção, Config: 10 resultados, 10K caracteres por resultado (ou equivalente).

Porque é que os resultados diferem do Bing.com?

O Web IQ está otimizado para o consumo de LLMs, densidade factual, qualidade de passagem e baixa latência. Bing.com é uma experiência para o consumidor com sinais adicionais de classificação, personalização, respostas visuais e conteúdos que podem não ser redistribuídos através de uma API. Algumas diferenças de classificação são esperadas.

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

Espera-se alguma variação porque o índice é continuamente atualizado e as atualizações propagam-se entre centros de dados. Os resultados para pedidos idênticos feitos com pouco intervalo entre si devem manter-se estáveis, de forma geral. Se notar uma variação significativa em consultas idênticas com poucos segundos de intervalo, contacte o Suporte da Web IQ.

Porque é 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 a jusante que filtra resultados válidos antes de serem medidos. Verifique também maxResultsa elegibilidade do conteúdo, o comportamento do SafeSearch e quaisquer operadores site: ou -site: na consulta.

Conteúdo da resposta

Porque é que a Pesquisa Web e a Pesquisa de Notícias não devolvem um campo snippet?

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

Que formatos de conteúdo suporta a Web Search?

Com passage, cada resultado devolve as partes do documento mais relevantes para a consulta, até maxLength caracteres (sem acesso total ao documento, no máximo 3.000). É o formato recomendado para ligação à terra. Aplicações com acesso total a documentos também podem usar text, html, e markdown. Ver Passagens e formatos de conteúdo.

O que é passage, e porquê usá-lo?

Defina contentFormat=passage e a API devolve, 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 excerto direcionado à consulta, para que o seu LLM não tenha de passar rapidamente por parágrafos não relacionados para encontrar a frase relevante.

• Poupança de tokens: o LLM recebe uma fração do documento em vez do documento inteiro.
• Melhor factualidade: com menos conteúdo fora do tema no contexto, é menos provável que o modelo se fixe num parágrafo tangencial.

Defina contentFormat=passage em todas as pesquisas na Web e pedidos de notícias. O Browse não suporta passage, porque obtém um URL específico que já escolheste e não existe nenhuma consulta com base na qual extrair.

Qual é o valor máximo maxResults da Web Search?

A Pesquisa Web suporta até 50 resultados por pedido.

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

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

Qual é a diferença entre lastUpdatedAt e crawledAt?

lastUpdatedAt é a data de atualização de conteúdo reportada pelo publicador, devolvida por Pesquisa Web, Notícias, Vídeos, Imagens, Navegar e Auto quando disponível. crawledAt é a hora em que o Web IQ foi buscar a página pela última vez, fornecido por Web Search, Browse, News e Auto. A cobertura de ambas as áreas varia consoante o resultado.

Como devo ajustar maxResults e maxLength para gerir os custos das janelas de contexto e dos tokens?

O Web IQ pode priorizar passagens relevantes para uma consulta em vez de fornecer contexto de página desnecessário. Isto pode reduzir a quantidade de texto passada para o seu modelo e diminuir os custos dos tokens de entrada. Os benefícios dependem do seu modelo, prompts, mistura de consultas e definições de recuperação.

Para a maioria dos cenários de grounding, mais resultados com passagens mais curtas dão melhor resultado 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 formato passage. Compare o desempenho com as tuas próprias consultas e o modelo.

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

A navegação devolve conteúdo do índice web do Bing, que é continuamente atualizado à medida que os nossos rastreadores observam mudanças na web. É assim que a pesquisa web funciona em geral: os resultados da pesquisa são servidos a partir de um índice em vez de aceder a cada URL em tempo real em cada pedido, e é isso que dá ao Browse a sua velocidade e consistência.

Para cenários que necessitam especificamente de uma busca just-in-time do URL no momento do pedido, como monitorização em tempo real, verificações competitivas ou fluxos de trabalho que são acionados por uma alteração que sabe ter acabado de ocorrer, o Browse suporta o Live Crawl. Defina liveCrawl: "fallback" no pedido para optar por um fetch em tempo real quando a cópia indexada estiver em falta ou obsoleta. A omissão do parâmetro (ou defini-lo como liveCrawl: "none") retorna apenas conteúdo indexado. Consulte a referência Browse API para detalhes completos dos parâmetros.

O Live Crawl está disponível por predefinição no Web IQ Browse e é aprovisionado com um limite de capacidade por segundo modesto, separado do seu QPS geral do Browse. Este limite é partilhado entre todas as chaves API sob o AppID. A maioria das cargas de trabalho Browse não necessita de Live Crawl e é melhor servida pelo caminho indexado padrão; use o Live Crawl para o conjunto restrito de cenários acima.

O Browse pode recuperar páginas renderizadas em JavaScript?

Yes. Utilize renderDynamicPages: true juntamente com liveCrawl: "fallback". Consulte a referência Browse API para o conjunto completo de parâmetros e detalhes de resposta. Teste URLs exemplificativos antes de depender deste comportamento em produção.

O Browse pode extrair ficheiros PDF da Internet?

Os PDFs alojados online não são atualmente um cenário documentado de navegação. Se tiver um caso de uso específico em PDF, contacte o Suporte Web IQ com um URL representativo e o comportamento que espera, e obterá uma resposta definitiva.

Faturação e aspetos legais

Quanto custa o Web IQ?

O Web IQ utiliza preços por chamada baseados no consumo. O preço depende das APIs ativadas para a sua conta, do seu uso e dos seus termos comerciais. Consulte Preços para as taxas atuais.

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

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

Preciso de mostrar as citações?

Yes. O Anexo A, Secção 1 (Uso de LLM) dos Termos de Uso do Web IQ exige atribuição de fonte e um link de volta para cada fonte usada no conteúdo do LLM apresentado, próximo desse conteúdo.

• Cite apenas as fontes realmente usadas para gerar a resposta. Se o Web IQ devolveu 10 resultados e o seu modelo usou 3, mostre esses 3.
• As citações devem permanecer visíveis com a resposta e serem acessíveis com uma única ação. Não os mostre apenas brevemente, não os esconda atrás de vários ecrãs, nem exija que os utilizadores peçam fontes de informação separadamente.
• Para interfaces limitadas como carros, dispositivos vestíveis, dispositivos voice-first ou quiosques, use um código QR persistente que resolva para uma página listando todas as citações usadas para a resposta atual, uma aplicação complementar que mostre a resposta com citações clicáveis, ou uma lista no ecrã que o utilizador possa abrir diretamente.

Pode armazenar as citações como parte do histórico de chat de um utilizador final individual durante até 30 dias. Veja a pergunta sobre cache abaixo.

Quanto conteúdo fonte pode o meu agente ou aplicação de IA mostrar?

O Anexo A dos Termos de Utilização do Web IQ limita conteúdos de grounding exibidos de qualquer fonte única até ao menor de 200 caracteres ou ao 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 apresentação. Consulte os Termos de Utilização antes de criar excertos; este limite não é permissão para reproduzir páginas fonte inteiras.

Podem ser usados resultados de imagem e vídeo para fundamentar um LLM?

Metadados de imagem e vídeo e texto alternativo estão incluídos na definição de Conteúdo de Fundamentação. No entanto, os Termos de Utilização Web IQ proíbem a utilização de imagens ou vídeos reais dos resultados para fundamentação, incluindo-os em saídas de LLM, ou a criação de imagens ou vídeos derivados a partir deles. Reveja os termos da implementação prevista.

Posso armazenar em cache ou guardar conteúdos do Web IQ?

Regra geral, não. Os Termos de Utilização do Web IQ proíbem a cópia, armazenamento, armazenamento em cache, arquivamento ou criação de uma base de dados de Conteúdo, exceto sob exceções restritas (Secção 3.2.15 e Secção 4 dos Anexos A e B):

• Histórico de conversas do utilizador final (até 30 dias): O conteúdo pode ser armazenado de forma não agregada, por utilizador final, para o histórico de conversas de um utilizador final individual durante até 30 dias. Para Utilização em LLM (Anexo A) isto cobre o Conteúdo em geral; para Utilização em Pesquisa (Anexo B) abrange URLs de imagem e vídeo.
• Processamento transitório de Ação Atómica: O conteúdo pode ser mantido num estado de processamento transitório apenas quando estritamente necessário para completar um único pedido lógico ou fluxo de trabalho iniciado por um LLM (uma "Ação Atómica", que pode envolver múltiplos passos internos ou interações agentais). O conteúdo deve ser eliminado prontamente assim que a Atomic Action terminar.
• O seu próprio produto de trabalho: na medida permitida pela lei de direitos de autor, o Conteúdo pode ser copiado ou armazenado como parte integrada do seu próprio produto de trabalho, desde que o produto de trabalho não seja criado para substituir os Serviços (por exemplo, construir uma base de dados de Conteúdo, indexar links para rastreamento ou oferecer uma pesquisa separada).

Fora destas exceções, os Termos de Utilização não permitem bases de dados derivadas, cache persistente ou arquivamento a longo prazo do Conteúdo.

Onde posso ler os Termos de Utilização do Web IQ?

Os termos atuais são publicados nos Termos de Utilização da Microsoft Web IQ. Aplicam-se juntamente com o seu Contrato de Cliente Microsoft existente.

Acesso completo ao documento

Porque é que recebo HTTP 403 quando defino contentFormat para html?

Na Pesquisa Web e Pesquisa de Notícias, text, html, e markdown retornam o documento completo e estão disponíveis para aplicações com acesso completo ao documento. Outras aplicações recebem HTTP 403 com o código AuthContentFormatForbiddende erro . Funciona com qualquer aplicação passage. Ver Passages e formatos de conteúdo.

Como posso pedir acesso completo ao documento?

Abra um pedido de Suporte Web IQ através do Azure Support e escolha a categoria Full-page content. Aplicações que já usam html ou text continuam a funcionar atualmente.