Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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. Cada AppID do Web IQ pode chamar Pesquisa Web, Notícias, Imagens, Vídeos, Browse, Places e Auto.
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. Nos benchmarks publicados pela Microsoft, a latência P95 do Web IQ foi cerca de duas vezes mais rápida do que o serviço seguinte mais rápido testado; o Auto e a Web Search alcançaram maior satisfação de grounding com contagens de tokens mais baixas do que os serviços comparados, com o Auto a obter o valor mais alto no geral; e o Auto obteve a pontuação mais alta no benchmark de atualidade do FreshSearch. É 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 latência P95, Qualidade e eficiência de tokens, e Atualização do Grounding).
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?
Use 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 Images e Videos para resultados visuais e de vídeo, a Places API para informações estruturadas sobre locais e a Browse API quando já souber o 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 medição e da faturação. A identidade da sua aplicação no Web IQ é o seu AppID Web IQ, criado quando liga o recurso no Portal de Desenvolvedores Web IQ.
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.
Qual é a diferença entre um recurso Web IQ e um Web IQ AppID?
Um recurso Web IQ é o recurso do Azure que cria na sua subscrição do Azure, no portal do Azure ou com a CLI do Azure. O uso do Web IQ é medido e faturado à sua subscrição através da mesma. O recurso não está no caminho do pedido: a tua aplicação chama api.microsoft.ai diretamente.
Um AppID Web IQ é a identidade da sua aplicação no Web IQ. É criado quando se liga um recurso Web IQ no Portal de Desenvolvedores Web IQ. Tudo sobre a forma como a sua aplicação usa o Web IQ está definido no AppID: que APIs pode chamar, o seu limite de taxa (15 QPS por defeito), as suas chaves API e os IDs da aplicação Entra (clientes) associados a ele. Não confunda com o ID da aplicação Entra (cliente) do registo da sua aplicação: esse ID identifica a sua aplicação junto do Microsoft Entra ID quando recebe um token, e associa-a a um AppID Web IQ.
Ligar um recurso cria um AppID, por isso a maioria dos clientes começa com um de cada. Se precisar de mais do que um AppID, por exemplo um por ambiente ou carga de trabalho, o seu contacto da Microsoft pode indicar-lhe as opções.
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?
Não existe uma API dedicada a finanças, desporto ou meteorologia. Para o tempo, o Auto devolve resultados meteorológicos estruturados (condições atuais, previsões diárias e alertas meteorológicos ativos com um link para a autoridade emissora) quando a consulta é sobre o tempo. Para finanças, desporto e outras áreas, use a Web Search, que devolve conteúdo relevante rastreado como 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?
- Complete a sua avaliação e confirme que o serviço cumpre os seus requisitos.
- Crie um recurso Web IQ numa subscrição paga do Azure, depois inicie sessão no Portal Web IQ para Desenvolvedores e ligue o recurso. Isto cria o seu AppID de produção, que pode copiar a partir da Gestão de Perfis. Começa no limite padrão de 15 consultas por segundo (QPS).
- Para autenticar com o Microsoft Entra ID, associe o ID da aplicação (cliente) do registo da sua aplicação a esse AppID no Portal do Desenvolvedor.
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, incluindo subscrições adquiridas através de um parceiro do Fornecedor de Soluções em Nuvem (CSP). Visual Studio, avaliações gratuitas, subscrições de estudantes e créditos do Azure não funcionam para o Web IQ. Se a criação do recurso Web IQ for bloqueada devido ao estado da sua conta do Azure, a mensagem de erro pede-lhe para contactar a equipa do seu conta Microsoft, que pode solicitar uma revisão.
Que APIs pode a minha aplicação chamar?
Cada AppID Web IQ pode chamar Pesquisa Web, Notícias, Imagens, Vídeos, Navegar, Locais e Auto. Se o Auto não estiver listado em Serviços Permitidos, abra um pedido de Suporte Web IQ com o seu AppID. Para ver que APIs o seu AppID pode chamar, inicie sessão no Portal Web IQ para Desenvolvedores, vá à Gestão de Perfis, selecione o seu AppID pelo nome no menu suspenso no canto superior esquerdo e selecione Serviços Permitidos.
Como posso aceder às APIs de Comércio?
As APIs de Comércio (Pesquisa, Ofertas e Detalhes do Produto) estão em pré-visualização privada e estão incluídas com AppIDs que têm acesso completo aos documentos. Se o seu AppID não os tiver, abra um pedido de Suporte Web IQ, escolha Autenticação e Acesso como tipo de problema e inclua o seu AppID, ou o nome da sua empresa e o nome do seu recurso Web IQ, caso ainda não tenha um. A utilização do Commerce é faturada por chamada; ver Preços. Para a referência da API, veja Commerce.
O que podem fazer as APIs de Commerce? Eles suportam o checkout?
Existem três APIs de Comércio. A pesquisa transforma uma consulta de produto em produtos classificados, cada um com ofertas do vendedor (preço, vendedor, um link para a oferta, imagens, informações de envio e estado). Offers devolve as ofertas elegíveis do vendedor para um produto de um resultado de pesquisa. Detalhes do Produto devolve o título, descrição e classificação média do produto. As APIs de Comércio não suportam checkout, pagamento ou outras transações: devolvem informações sobre produtos e ofertas com links para cada oferta do comerciante.
Como deve a minha aplicação estar ligada às ofertas do Commerce?
Use cada clickUrl oferta exatamente conforme devolvida nessa resposta para cada link ou navegação para a oferta, seja por um utilizador ou por um agente a atuar em nome do utilizador. Não remova, reescreva, encurte ou reutilize-o, e não crie uma ligação para displayUrl, que apenas identifica o comerciante ou vendedor. Só podes envolver o clickUrl original no teu próprio link de rastreio se passar o original sem alterações. Constrói cada ligação no código da aplicação a partir da resposta em vez de fazer com que um modelo a reproduza. Para mais detalhes, consulte Links e atribuição da Oferta e o Anexo B dos Termos de Utilização do Web IQ.
Que endereço de e-mail devo usar para iniciar sessão?
Use o endereço de login da Microsoft que tenha acesso ao Web IQ: o endereço que a Microsoft ativou para si, ou a conta que usou para ligar o seu recurso Web IQ no Portal para Desenvolvedores 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-apikeypedido.
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. Vincule o ID da aplicação Entra (cliente) do registo da aplicação ao seu AppID Web IQ no Portal Web IQ para Desenvolvedores, 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 quantas chaves de API precisar no Web IQ Developer Portal. 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 implementas na tua subscrição Azure trata da medição e faturação, mas não está no caminho de pedido, por isso não existe um recurso de serviço para funções RBAC do Azure a que se possa associar.
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.
Pode um ID de aplicação Entra (cliente) chamar mais do que um Web IQ 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=<your-web-iq-appid>. A interface API determina o AppID da seguinte forma:
- O ID da sua aplicação Entra (cliente) está associado 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 ID da aplicação Entra (cliente) está associado 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 ID da sua aplicação Entra (cliente) não está associado 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 Entra (cliente) esteja associado ao seu AppID Web IQ a partir da página de Gestão de Perfis do Portal de Desenvolvedores 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 sua subscrição Azure trata da medição e faturação, mas não está no caminho do pedido, 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 nenhum recurso do lado do Web IQ ao qual se associar. 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 AppID Web IQ tem um limite padrão de 15 consultas por segundo (QPS). Um recurso Web IQ normalmente tem um AppID, criado quando liga o recurso. O Web IQ Developer Portal mostra o limite.
O limite é partilhado entre todas as chaves API e os IDs de aplicação (cliente) do Entra vinculados para esse AppID. Solicitações acima do limite retornam HTTP 429.
Posso aumentar o meu limite de pedidos?
Yes. Cada AppID Web IQ tem um limite inicial de 15 QPS. Para pedir um limite superior, abra um pedido de Suporte Web IQ com o tráfego e caso de uso esperados.
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 AppID 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. A consulta continua a ser enviada para a Microsoft para servir o pedido; O Registo de Consulta Zero mantém o texto da consulta fora dos nossos registos. Não é self-service: a nossa equipa de produto ativa-o para si, para todas as suas aplicações ou apenas para as 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.
Com o registo zero de consultas, o texto da consulta, os títulos dos resultados e URLs, o endereço IP e o ID da aplicação Entra não são mantidos. Os campos do AppID, trace ID, temporização, estado e faturação são mantidos para que possamos executar e faturar o serviço. Não há nada para configurar do teu lado.
Posso verificar se o Registo de Consultas Zero está ativado?
Nem no Web IQ Developer Portal nem na API atualmente. Se precisar de confirmação, por exemplo para uma auditoria, abra um pedido de Suporte Web IQ com o seu AppID, e o Suporte Web IQ confirma a definição por escrito.
Posso ativar ou aplicar o Zero Query Logging através de uma API, Terraform ou Azure Policy?
Hoje não. A nossa equipa de produto ativa o Zero Query Logging mediante pedido, para todas as suas aplicações ou para aplicações específicas. Quando está ativado para todas as suas aplicações, as novas aplicações criadas sob o tenant Microsoft Entra da sua organização são cobertas automaticamente, sem outro pedido. Não existe API, configuração Terraform ou definição do Azure Policy para a ativar, exigir ou auditar. Pode controlar quem cria recursos Web IQ nas suas subscrições com as permissões Azure existentes. Para confirmar a configuração de uma auditoria, abra um pedido de Suporte Web IQ com o seu AppID.
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. A Microsoft não oferece compromissos quanto à localização ou nacionalidade do pessoal que pode aceder aos dados.
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.
Fornecem uma DPA ou declaração de conformidade para uma lei específica de privacidade, como a APPI do Japão?
No. O Web IQ está excluído do Adendum de Proteção de Dados de Produtos e Serviços da Microsoft (Secção 4.1 dos Termos de Utilização do Web IQ), e não emitimos declarações relativas a leis específicas de privacidade. A posição escrita da Microsoft é que a Secção 4 dos Termos de Utilização, juntamente com a Declaração de Privacidade da Microsoft, estabelece que a Secção 4.2 se aplica ao Web IQ. A Secção 4 abrange:
- O que a Microsoft pode recolher em conexão com pedidos, incluindo a consulta, o endereço IP do utilizador final, a hora do pedido e os resultados retornados (Secção 4.2).
- Microsoft e o cliente como responsáveis do tratamento independentes (Secção 4.4).
- Pedidos do titular dos dados (Secção 4.5).
- Não é permitida transferência de dados pessoais para terceiros, exceto subcontratantes e terceiros vinculados por termos pelo menos tão protetores quanto os dos Termos de Utilização (Secção 4.7.2).
- Cooperação em matéria de reclamações regulamentares (Secção 4.8).
O Web IQ não deteta nem mascara dados pessoais nas consultas e não assume compromissos de residência de dados. A sua equipa jurídica está em melhor posição para avaliar como isto se enquadra nas suas obrigações ao abrigo da lei aplicável a si; teremos todo o gosto em responder a perguntas de seguimento.
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.
A Web IQ não pode garantir que o conteúdo devolvido esteja livre de scripts ou malware, e esta normalização não garante que texto semelhante a prompts seja 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 AppID Web IQ 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.
Os clientes na China devem ligar para https://api.microsoftol.com/v3; A Pesquisa de Notícias não está disponível lá (URL base).
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. Para reutilizar um conjunto nomeado de regras de inclusão e exclusão na Web Search ou News Search, crie um âmbito Web IQ para uma conta de faturação com gestão de âmbito disponível. Os âmbitos nomeados suportam até 10.000 seletores únicos normalizados por lista, sujeitos ao limite combinado de tamanho da definição.
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.
Escopos de pesquisa nomeados
Como posso controlar e filtrar os resultados do Web IQ?
Use Scopes para filtrar resultados de Pesquisa Web e Pesquisa de Notícias com listas reutilizáveis de URLs, sites, domínios ou caminhos a incluir ou excluir. Criar um escopo nomeado e, em seguida, selecioná-lo com o parâmetro do pedido scopeName. As exclusões têm precedência sobre as inclusões.
Veja Filtrar resultados com Scopes.
Como é que uma conta de faturação Web IQ difere de um AppID ou de um ID de cliente Entra?
Uma conta de faturação Web IQ agrupa os AppIDs Web IQ, o acesso à conta e uma coleção de âmbito atribuída. Um AppID Web IQ seleciona a configuração de pesquisa em tempo de execução da sua aplicação. Um ID de aplicação Entra (cliente) identifica o registo da aplicação que adquire tokens Entra; não corresponde a nenhum dos dois IDs do Web IQ. Veja conceitos-chave e descoberta de recursos autorizados.
Posso usar as minhas credenciais de pesquisa para criar âmbitos?
O acesso à pesquisa não concede automaticamente acesso à gestão. Uma aplicação que chama a API de gestão do Web IQ necessita de um token Entra exclusivo da aplicação e CustomerApiAccess permissões na conta de faturação pretendida. Um administrador humano da conta concede isto separadamente. Consulte o acesso à API de gestão de permissões da aplicação.
Porque é que a página Scopes diz que não há contas de faturação disponíveis?
A página Scopes lista apenas as contas de faturação às quais o seu utilizador pode aceder. Verifique duas coisas:
- Ligou o seu recurso Web IQ no Portal de Programadores Web IQ. Se o fez, o seu AppID aparece em Profile Management. Se isso não acontecer, siga Criar um recurso Web IQ no portal Azure.
- Tem sessão iniciada com o mesmo endereço que usou para ligar o recurso.
Se ambas forem verdadeiras e a página ainda estiver vazia, abra um pedido de Suporte Web IQ, escolha Autenticação e Acesso como tipo de problema e inclua o seu AppID e o endereço com que iniciou sessão.
Os âmbitos são específicos de um único Web IQ AppID?
No. Os AppIDs Web IQ numa conta de faturação utilizam a sua coleção de âmbito atribuída. Os nomes são únicos nessa coleção, independentemente de maiúsculas/minúsculas. As contas atribuídas à mesma coleção partilham as suas definições, pelo que as edições ou eliminações afetam todos os consumidores dessas definições. Saber um nome não dá acesso aos âmbitos de outra conta.
Uma lista incluída vazia desativa um âmbito?
No. Uma inclusão vazia permite qualquer origem não excluída. Se ambas as listas estiverem vazias, o próprio âmbito não impõe qualquer restrição de site. A exclusão tem sempre prioridade sobre a inclusão.
E se a pesquisa não conseguir encontrar o meu âmbito?
failOnMissingScope tem como predefinição true: uma falha comunicada na aplicação do âmbito devolve um erro em vez de um resultado sem âmbito. Um nome incorreto ou uma propagação incompleta podem causar a ausência do escopo. Se definir false explicitamente, a pesquisa pode ser efetuada em todo o índice sem o âmbito e apresentar scopeApplied: false. Utilize essa definição apenas se os resultados sem âmbito forem aceitáveis. Consulte erros de âmbito com nome.
O scopeApplied true significa que a pesquisa usou a minha definição de âmbito mais recente?
No.
scopeApplied: true significa que foi aplicado um âmbito para esse pedido. Não identifica a versão utilizada nem garante a propagação global. O campo é opcional quando não é reportado o resultado da aplicação; não assuma que está sempre presente ou false em pedidos sem scopeName.
Se não for aceitável usar uma definição anterior durante a implementação, crie e verifique um âmbito sob um novo nome antes de mudar os chamadores. Ainda não existe endpoint de prontidão nem versionamento de scopes. A propagação global completa normalmente demora cerca de 10 minutos, mas pode demorar até 30 minutos em alguns casos. Atualmente não existe SLA de propagação, e estes tempos não são garantidos. Mudar de chamador não é globalmente atómico.
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?
Na comparação publicada pela Microsoft, o Auto e a Web Search alcançaram maior satisfação de grounding com contagem de tokens mais baixas do que os serviços comparados, e o Auto atingiu a maior satisfação de grounding no geral. 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. 2.850 consultas globais amostradas aleatoriamente, avaliadas entre 8 e 9 de novembro de 2026.
O Web IQ trata as fontes de saúde de forma diferente?
Os modelos de classificação do Web IQ usam sinais para a credibilidade da fonte. Para questões relacionadas com a saúde, estes sinais são orientados por princípios desenvolvidos de forma independente pela Academia Nacional de Medicina. Isto aplica-se à Web Search e aos resultados Auto que vêm da Web Search; não se aplica às Notícias. É automático: não há nada para ativar. Não publicamos a lista nem o número de fontes. Para limitar os resultados aos sites que escolher, use Scopes.
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.
Como é que a língua, a região e a localização afetam os resultados?
A linguagem da própria consulta é o que mais importa; os parâmetros language e region desempenham um papel secundário, e o seu efeito pode variar consoante a API. Qualquer linguagem suportada funciona com qualquer região suportada, por exemplo en com IN, AU, ou NZ. A região afeta a classificação, a mistura de fontes e unidades (por exemplo, °C ou °F), mas não o formato da data. Uma consulta sobre um tema global continua a devolver resultados globais. Para consultas locais como "tempo perto de mim", a localização importa mais do que a região.
Ambos os parâmetros recebem códigos de duas letras; qualquer outro valor devolve HTTP 400. Se uma região de duas letras não for suportada, o Web IQ utiliza US. Se uma língua de duas letras não for suportada, usa-se a língua predefinida dessa região. Nenhum dos casos devolve erro. Isto funciona da mesma forma na Web Search, News Search e Auto. Ver Línguas e regiões suportadas.
Qual é a diferença entre Auto e Auto Advanced?
São dois modos da mesma API. O Auto, o padrão, escolhe as fontes para uma pergunta e devolve a evidência citada numa só chamada. O Auto Advanced executa passagens adicionais de recuperação para perguntas complexas; para o usar, defina "mode": "advanced". É cobrado separadamente; ver Preços.
Preciso de responseFilter com o Auto?
No. O Auto determina de que evidência uma consulta precisa (web, notícias, meteorologia e mais) e devolve-a numa só chamada, por isso não precisa de invocar cada API separadamente.
responseFilter lista os tipos de provas que o Auto pode incluir; quando o omitir, todos os tipos são elegíveis. Para deixar de fora tipos que nunca quer, como imagens ou vídeos, liste apenas os que deseja (por exemplo, ["web", "news"]). Define uma vez para a tua aplicação em vez de o fazer para cada pedido. O Auto suporta as mesmas línguas e regiões que a Web Search, e responseFilter funciona da mesma forma em todas as regiões. Veja a referência Auto API.
Formatos de conteúdo
O que devolve cada resultado: passagens ou o documento completo?
A Pesquisa Web e a Pesquisa de Notícias devolvem o conteúdo de cada resultado no content campo. Com contentFormat definido como passage, obtém-se as partes do documento mais relevantes para a sua consulta. Com html, markdown ou text, obtém-se o documento completo: a versão estruturada da página que o Web IQ constrói durante a indexação. Passages funcionam para todas as aplicações; os formatos completos de documentos precisam de acesso total ao documento. Imagens e Vídeos devolvem detalhes dos resultados, como títulos, URLs e miniaturas, não o conteúdo da página. O site devolve detalhes estruturados do local, como moradas, horários de funcionamento, avaliações e fotografias, além de passagens relacionadas com a consulta.
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 também suporta passage: envie um query e o Browse devolve as partes da página mais relevantes para a sua consulta.
Que formato devo usar?
Usa passage para ligação à terra. É o formato recomendado e funciona para todas as aplicações. Utilize text, html ou markdown quando precisar do documento todo, por exemplo, para resumir ou extrair de uma página completa. Estes formatos requerem acesso completo ao documento.
Devo definir contentFormat e maxLength em cada pedido?
Yes. Defina ambos em todas as pesquisas na Web e pedidos de notícias para obter sempre o formato e o comprimento que espera.
Qual pode ser o comprimento do content campo?
Até maxLength caracteres. Sem acesso total ao documento, as passagens têm no máximo 3.000 caracteres por resultado, mesmo que o limite definido em maxLength seja superior. Com acesso total a documentos, content pode ter até maxLength, até 500.000 caracteres. Documentos completos mais longos do que maxLength são cortados.
Porque é que recebo HTTP 403 (AuthContentFormatForbidden) quando defino contentFormat para text, html, ou markdown?
Na Web Search e na Pesquisa de Notícias, text, html, e markdown retornam o documento completo e precisam de acesso total ao documento. Sem ele, esses formatos devolvem HTTP 403 com o código AuthContentFormatForbiddende erro . Funciona com qualquer aplicação passage.
Como é que obtenho o documento completo em formato text, html ou markdown?
Abra um pedido de Suporte Web IQ. Aplicações que já usam html ou text continuam a funcionar atualmente.
O que devolve Browse?
A navegação devolve conteúdo para um URL que escolher, até maxLength caracteres. Com definido contentFormat para passage e com um query, devolve as partes da página mais relevantes para a consulta. Este é o formato padrão, a menos que a sua aplicação tenha acesso total ao documento. Com acesso total ao documento, pode também devolver o documento completo como text, html, ou markdown. Consulte a referência Browse API.
Porque é que recebo HTTP 400 do Browse quando não envio um query?
Um pedido de passagem exige um query que não esteja em branco.
passage é o formato predefinido, a menos que a sua aplicação tenha acesso total aos documentos, por isso inclua query em cada pedido Browse, até 1000 caracteres.
Ver Passagens e formatos de conteúdo.
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.
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.
Conteúdo da resposta
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, devolvida por Web Search, Browse, Notícias e Auto. Não é a hora do seu pedido. A cobertura de ambos os campos varia consoante o resultado, e nem todos os resultados os incluem.
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.
O Browse suporta o Live Crawl para URLs que não estão disponíveis no índice. Defina liveCrawl: "fallback" no pedido para pedir um fetch ao vivo quando a cópia indexada estiver em falta. O rastreamento ao vivo está sujeito a restrições de acesso impostas pelo publicador e à disponibilidade; fallback não garante um rastreamento real. Se houver conteúdo indexado disponível, o Procurar devolve-o. Omitir o parâmetro (ou ao definir liveCrawl: "none") retorna apenas conteúdo indexado, sem rastreamento em direto. 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 quando uma URL não está disponível no índice.
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 é faturado através do Azure, pelo que a sua utilização conta para o seu Compromisso de Consumo do Microsoft Azure (MACC), e o seu Desconto de Consumo do Azure (ACD) e outros descontos negociados do Azure aplicam-se a estas tarifas. Commerce, em pré-visualização privada, também é cobrado por chamada: Pesquisa, Ofertas e Detalhes do Produto partilham um contador e a mesma tarifa.
Como é que a faturação vai aparecer no Azure?
A utilização do Web IQ é medida e faturada para a sua subscrição do Azure através do recurso Web IQ. O serviço em si é alojado pela Microsoft, não está provisionado no seu tenant.
Para ver os custos do seu Web IQ, abra a análise de custos da sua subscrição no portal Azure, use a vista Custo por recurso e filtre pelo tipo microsoft.webiq/accountsde recurso . Cada API que invoca (por exemplo, Web Search, Imagens ou Notícias) aparece como um medidor próprio. O auto tem dois contadores, um para /auto e outro para /auto com mode: advanced. As APIs de Comércio partilham um contador.
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 os links de origem apresentados com um Resumo do LLM juntamente com ele, no histórico de conversas de um utilizador final ou como parte do seu produto interno de trabalho. 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 quando os termos o permitam (Secção 3.2.15 e Anexo A, Secção 4):
- Histórico de chat de utilizadores finais: pode armazenar os Resumos LLM (os resumos que a sua aplicação cria a partir do Grounding Content para utilizadores finais, Secção 2.5) numa base não agregada, por utilizador final, para o histórico de chat de cada utilizador final, enquanto a legislação aplicável o permitir.
- Produto de trabalho interno: pode armazenar Resumos de LLM e os links de origem apresentados com eles como parte integrada do seu produto de trabalho interno, como memorandos, relatórios, apresentações ou registos de segurança e auditoria, na medida permitida pela lei de direitos de autor. Não podem ser usados como substitutos dos Serviços ou Conteúdos, por exemplo, para construir uma base de dados de Conteúdo, indexar links, rastrear ou extrair, ou oferecer uma pesquisa separada.
- 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.
Fora destas exceções, não armazene os resultados da pesquisa em si: 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.