Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Respostas para perguntas comuns sobre como usar Microsoft Web IQ. Para obter detalhes da API e exemplos de solicitação, consulte a referência da API.
Serviço e implementação
O que é Microsoft Web IQ?
Microsoft Web IQ é um conjunto de APIs de pesquisa na Web e grounding nativas de IA que fornece a LLMs, agentes de IA e aplicativos acesso a informações da Web atuais e relevantes. Isso permite respostas de IA mais precisas e atualizadas, com fontes que os usuários podem verificar. O Web IQ capacita os principais assistentes de IA de ponta, incluindo Microsoft Copilot e ChatGPT.
Web IQ está disponível por meio de REST em https://api.microsoft.ai/v3 e por meio de MCP em https://api.microsoft.ai/v3/mcp. Cada AppID do Web IQ pode usar Pesquisa na Web, Notícias, Imagens, Vídeos, Procurar, Places e Auto.
O que é grounding na Web e quando um agente de IA precisa dele?
A fundamentação na Web dá à IA acesso às informações mais recentes da Web para que ela possa responder usando fatos atuais além de seus dados de treinamento, com fontes citadas que os usuários podem verificar. Ele ajuda mais com a alteração frequente de informações, como desenvolvimentos de mercado, atividade dos concorrentes, notícias e atualizações regulatórias.
O Web IQ é um LLM? Isso gera a resposta final?
No. O IQ da Web não é um modelo de IA ou LLM. É um conjunto de APIs de pesquisa na Web e grounding nativas de IA que fornece a LLMs, agentes de IA e aplicativos acesso a informações da Web atuais e relevantes.
O IQ da Web não gera a resposta final de IA. Ele recupera informações relevantes da Web e sua llm, agente de IA ou lógica de aplicativo escolhido usa essa evidência para gerar uma resposta.
O que torna o Web IQ diferente de outras APIs de pesquisa na Web e serviços de fundamentação?
A maioria das APIs de pesquisa na Web força um compromisso: rápida ou precisa, econômica ou completa. Nos benchmarks publicados pela Microsoft, a latência P95 do Web IQ foi cerca de 2 vezes mais rápida do que a do serviço seguinte mais rápido testado; Auto e Web Search atingiram maior satisfação de grounding com contagens de tokens menores do que os serviços comparados, com o Auto apresentando o maior resultado geral; e o Auto obteve a maior pontuação no benchmark de atualização FreshSearch. É a mesma plataforma na qual os assistentes de IA, como Copilot e ChatGPT, contam com todos os dias, comprovada em escala global e pronta para qualquer agente ou aplicativo de IA criar.
O Web IQ também é diferenciado pela forma como acessa o conteúdo. Ele adota uma abordagem responsável para o acesso à Web, reunindo a Web aberta e os dados estruturados com proteções e segurança de nível empresarial integradas.
O IQ da Web funciona com a pilha de IA que você já usa. Você pode usar seu modelo de IA de sua preferência e se conectar por meio da API REST ou do Model Context Protocol (MCP), sem estar vinculado a um único modelo ou plataforma.
Fonte: resultados de benchmark do Web IQ (latência P95, eficiência de qualidade e token e seções de atualização do grounding).
O que posso criar com o Web IQ?
Web IQ capacita agentes de IA e aplicativos que precisam de informações externas novas da web pública. As equipes internas podem usá-lo para inteligência competitiva, monitoramento, pesquisa regulatória, inteligência de vendas e otimização de conteúdo. As experiências voltadas para o cliente podem usá-la para pesquisa, descoberta, recomendações e agentes especializados.
Ele é mais adequado para cenários em que as informações são alteradas com frequência, abrangem muitas fontes externas e precisam ser fundamentadas no conteúdo da Web atual e atribuível.
Qual Web IQ API se encaixa no meu caso de uso?
Use a Web Search API para encontrar páginas e passagens públicas relevantes para seu modelo, a News API para eventos atuais, as APIs Images e Videos para resultados visuais e de vídeo, a Places API para informações estruturadas sobre locais e a Browse API quando você já conhece a URL. Verifique a referência de API para obter os recursos e os limites disponíveis para sua conta.
Posso usar o Web IQ com meu modelo de IA existente e estrutura de agente?
Sim. Web IQ permite adicionar informações da Web ao modelo de IA e ao fluxo de trabalho do agente que você escolher. As APIs REST e o MCP oferecem flexibilidade na forma como se conectar. Verifique o SDK e a documentação de integração do MCP para obter configurações com suporte.
Como é a integração?
Seu agente de IA ou aplicativo consulta o Web IQ para obter evidências da web e, em seguida, passa os resultados selecionados para seu modelo para gerar uma resposta. Você controla como as informações são selecionadas, usadas e citadas. Siga o Início Rápido para conectar seu primeiro fluxo de trabalho ou começar a usar o Playground.
O Web IQ pode recuperar informações privadas da empresa?
No. Web IQ recupera informações da web pública. Para o contexto empresarial, Microsoft oferece Work IQ, Fabric IQ e Foundry IQ, cada um atendendo a uma função diferente, do contexto organizacional aos dados corporativos e ao conhecimento corporativo.
Como o Web IQ se relaciona com o qi do Foundry, Work IQ e Fabric IQ?
Microsoft IQ reúne quatro camadas integradas que alimentam a inteligência corporativa em toda a Microsoft. Web IQ fornece informações da web pública. Work IQ se concentra em sinais de trabalho, Fabric IQ em dados empresariais e Foundry IQ no conhecimento organizacional. Esses produtos abordam diferentes necessidades de informações para agentes e aplicativos de IA e são mais poderosos quando usados juntos.
O Web IQ é um recurso do Azure?
Você implanta um recurso Web IQ em sua assinatura do Azure. O recurso gerencia a medição e a cobrança. A identidade do aplicativo no IQ da Web é a AppID do IQ Da Web, criada quando você conecta o recurso no Portal do Desenvolvedor do IQ Da Web.
O serviço em si é hospedado pela Microsoft e multilocatário. A recuperação da Web e a classificação são executadas na infraestrutura da Microsoft, e seu aplicativo chama api.microsoft.ai por HTTPS. O recurso Azure não hospeda o Web IQ e não está no caminho da solicitação.
Qual é a diferença entre um recurso do Web IQ e uma AppID do Web IQ?
Um recurso Web IQ é o recurso do Azure que você cria em sua assinatura do Azure, no portal do Azure ou com a CLI do Azure. O uso do Web IQ é medido e cobrado para sua assinatura por meio dele. O recurso não está no caminho da solicitação: seu aplicativo chama api.microsoft.ai diretamente.
Um AppID do Web IQ é a identidade do aplicativo no Web IQ. Ele é criado quando você conecta um recurso do Web IQ no Portal do Desenvolvedor do Web IQ. Tudo sobre como seu aplicativo usa o IQ da Web é definido no AppID: quais APIs ele pode chamar, seu limite de taxa (15 QPS por padrão), suas chaves de API e as IDs do aplicativo Entra (cliente) associadas a ele. Não confunda isso com a ID do aplicativo Entra (cliente) do registro do aplicativo: essa ID identifica seu aplicativo para Microsoft Entra ID quando ele obtém um token e você o associa a um IQ AppID da Web.
Conectar um recurso cria um AppID, portanto a maioria dos clientes começa com um de cada. Se você precisar de mais de um AppID, por exemplo, um por ambiente ou carga de trabalho, seu contato Microsoft poderá informar as opções.
Onde o Web IQ é implantado?
O Web IQ é hospedado pela Microsoft e está disponível por meio do ponto de extremidade público https://api.microsoft.ai/v3. Seu aplicativo chama a API, e o Web IQ realiza a recuperação da web no servidor.
Há APIs dedicadas para finanças, esportes ou clima?
Não há nenhuma API de finanças, esportes ou clima dedicada. Para o clima, Auto retorna resultados meteorológicos estruturados (condições atuais, previsões diárias e alertas meteorológicos ativos com uma ligação com a autoridade emissora) quando uma consulta é sobre o clima. Para finanças, esportes e outros assuntos, use a Pesquisa na Web, que retorna conteúdo rastreado relevante como texto de página não estruturado em vez de um feed estruturado.
Acesso e integração inicial
Como fazer para passar da avaliação para a produção?
- Conclua sua avaliação e confirme se o serviço atende aos seus requisitos.
- Crie um recurso de Perguntas Frequentes da Web em uma assinatura de Azure paga, entre no Portal do Desenvolvedor de Perguntas Frequentes da Web e conecte o recurso. Isso cria o AppID de produção, que você pode copiar do Gerenciamento de Perfil. Ele começa no limite padrão de 15 consultas por segundo (QPS).
- Para autenticar com Microsoft Entra ID, associe o ID do aplicativo Entra (cliente) do registro do aplicativo a essa AppID no Portal do Desenvolvedor.
O uso do Web IQ é regido pelos Termos de Uso do Web IQ, no contexto de seu Contrato de Cliente da Microsoft existente.
Quais assinaturas de Azure posso usar?
O IQ da Web requer uma assinatura de Azure paga, incluindo assinaturas compradas por meio de um parceiro Provedor de Soluções na Nuvem (CSP). Visual Studio, avaliação gratuita e assinaturas de alunos e créditos do Azure não funcionam para o Web IQ. Se a criação do recurso do Web IQ for bloqueada devido ao status da sua conta do Azure, a mensagem de erro solicitará que você entre em contato com a equipe da sua conta Microsoft, que pode solicitar uma revisão.
Quais APIs meu aplicativo pode chamar?
Cada AppID do Web IQ pode acessar Web Search, News, Images, Videos, Browse, Places e Auto. Se o Auto não estiver listado em Serviços Permitidos, abra uma solicitação de suporte do Web IQ com seu AppID. Para ver quais APIs seu AppID pode chamar, entre no Portal do Desenvolvedor do IQ da Web, acesse o Gerenciamento de Perfil, selecione sua AppID pelo nome na lista suspensa no canto superior esquerdo e verifique Os Serviços Permitidos.
Como obter acesso às APIs de Comércio?
As APIs de Comércio (Pesquisa, Ofertas e Detalhes do Produto) estão em versão prévia privada e estão incluídas com AppIDs que têm acesso completo a documentos. Se o AppID não os tiver, abra uma solicitação de Suporte ao IQ da Web, escolha Autenticação & Acesso como o tipo de problema e inclua o AppID ou o nome da empresa e o nome do recurso de IQ da Web se você ainda não tiver um. O uso do Commerce é cobrado por chamada; consulte Pricing. Para obter a referência de API, consulte Commerce.
O que as APIs de Commerce podem fazer? Eles oferecem suporte a checkout?
Há três APIs de Comércio. A pesquisa transforma uma consulta de produto em produtos classificados, cada um com ofertas de vendedor (preço, vendedor, um link para a oferta, imagens, informações de envio e condição). As ofertas retornam as ofertas elegíveis de vendedores para um produto de um resultado de pesquisa. Os Detalhes do Produto retornam o título, a descrição e a classificação média de um produto. As APIs de Comércio não dão suporte a check-out, pagamento ou outras transações: retornam informações sobre produtos e ofertas com links para cada oferta no comerciante.
Como meu aplicativo deve criar links para as ofertas do Commerce?
Use o clickUrl de cada oferta exatamente como retornado nessa resposta para cada link ou navegação para a oferta, por um usuário ou por um agente que atua para o usuário. Não remova, reescreva, encurte ou reutilize-o e não o vincule a displayUrl, que identifica apenas o comerciante ou o vendedor. Você pode encapsular o clickUrl no seu próprio link de rastreamento somente se ele passar o original sem alterações. Crie cada link no código do aplicativo a partir da resposta em vez de ter um modelo reproduzi-lo. Para obter detalhes, consulte Links de oferta e atribuição e o Anexo B dos Termos de Uso do Web IQ.
Qual endereço devo usar para entrar?
Use o endereço de entrada da Microsoft que tem acesso ao Web IQ: o endereço Microsoft habilitado para você ou a conta que você usou para conectar o recurso do Web IQ no Portal do Desenvolvedor do Web IQ. Normalmente, esse é o endereço usado para Azure, Teams ou Office, que pode ser diferente do seu endereço de caixa de correio.
Para confirmá-lo, entre no portal Azure e verifique o endereço no canto superior direito.
Por que o login diz que eu não tenho acesso?
Primeiro, confirme se o endereço mostrado no canto superior direito do portal Azure corresponde exatamente ao endereço que tem acesso ao Web IQ. As organizações geralmente usam um endereço para login da Microsoft e outro para email.
Se os endereços corresponderem, sua organização poderá bloquear o acesso de convidado entre locatários ao locatário da Microsoft Corporation. Peça ao administrador de TI para permitir esse acesso.
Onde posso obter ajuda?
Visite o site de suporte do Microsoft Web IQ para obter assistência ao produto. Em caso de dúvidas sobre uso permitido, privacidade, armazenamento ou exibição, consulte os atuais Termos de Uso do Web IQ e seu contrato de cliente aplicável.
Autenticação da API
Quais métodos de autenticação têm suporte?
Web IQ é compatível com:
- Microsoft Entra ID tokens Bearer por meio do fluxo de credenciais do cliente OAuth 2.0. Ele é recomendado para cargas de trabalho de produção.
- Chaves de API enviadas no cabeçalho da solicitação
x-apikey.
Todo o tráfego de API usa HTTPS.
Como configurar a autenticação de servidor para servidor?
Registre um aplicativo no Microsoft Entra ID e use o fluxo de credenciais do cliente OAuth 2.0. Associe a ID do aplicativo Entra (cliente) do registro do aplicativo à sua AppID do Web IQ no Portal do Desenvolvedor do Web IQ, adquira um token de acesso e envie-o como Authorization: Bearer <access_token>.
Consulte a Autenticação para obter as etapas de instalação completas.
Posso gerenciar minhas próprias chaves de API?
Sim. Você pode criar quantas chaves de API forem necessárias no Web IQ Developer Portal. Não há nenhum custo para a criação de chaves.
O Web IQ usa Azure RBAC para autorização de API?
No. Web IQ é um serviço hospedado pela Microsoft que você acessa pela internet. O recurso Web IQ que você implanta em sua assinatura do Azure lida com a medição e o faturamento, mas não está no caminho da solicitação, portanto, não há nenhum recurso de serviço ao qual as funções RBAC do Azure possam ser anexadas.
Web IQ autoriza requisições por AppID. Cada AppID tem seu próprio perfil de qualificação de conteúdo e cota, e chamadas não autorizadas retornam HTTP 403. Para separar equipes ou cargas de trabalho, por exemplo, com diferentes políticas de acesso ou cotas, use vários AppIDs.
Uma ID do aplicativo Entra (cliente) pode chamar mais de uma AppID do Web IQ?
Sim. Uma única ID do aplicativo Entra (cliente) pode ser autorizada a chamar um ou mais AppIDs. Para escolher o AppID, passe-o como um parâmetro de consulta, por exemplo https://api.microsoft.ai/v3/search/web?APPID=<your-web-iq-appid>. A API resolve o AppID da seguinte forma:
- Sua ID do aplicativo Entra (cliente) está associada a um AppID: se você não especificar um AppID ou especificar esse AppID, a solicitação será bem-sucedida (HTTP 200). Se você especificar um AppID diferente, a solicitação retornará HTTP 403.
- Sua ID do aplicativo Entra (cliente) está associada a vários AppIDs: você deve especificar um. Um AppID ausente ou em branco retorna HTTP 400; um de seus AppIDs associados é bem-sucedido (HTTP 200); qualquer outro AppID retorna HTTP 403.
- Sua ID do aplicativo Entra (cliente) não está associada a nenhuma AppID: a solicitação retorna HTTP 401.
A autenticação de chave de API (x-apikey) não é afetada. Cada chave de API está associada a uma única AppID, portanto APPID , nunca é necessária ou aceita para chamadas autenticadas por chave.
Qual autenticação um agente hospedado deve usar: Identidade Gerenciada ou AgentID?
Qualquer uma das opções funciona. A Identidade Gerenciada e o AgentID são identidades Entra ID, e o Web IQ aceita qualquer identidade Entra cuja ID do aplicativo Entra (cliente) esteja associada ao AppID do Web IQ na página Gerenciamento de Perfil do Web IQ Developer Portal.
Qual deles você usa depende de onde o agente está hospedado:
- A Identidade Gerenciada atende aos agentes executados na infraestrutura do Azure, como Foundry, App Service, Container Apps, AKS, Funções ou VMs. As identidades atribuídas pelo sistema e atribuídas pelo usuário podem ser usadas.
- O AgentID é adequado para o Foundry ou para agentes hospedados pelo Copilot Studio que expõem uma identidade de agente.
- Agentes hospedados fora Azure, por exemplo, em seu próprio cluster do Kubernetes ou em outra nuvem, podem usar um registro de aplicativo Entra padrão com um segredo do cliente ou credencial federada.
Em todos os casos, a chamada usa o fluxo de credenciais do cliente OAuth 2.0 e envia o token como Authorization: Bearer <access_token>. Consulte a Autenticação para obter as etapas de instalação. Uma chave de API no cabeçalho x-apikey continua sendo a opção mais simples para protótipos.
Rede e segurança
O Web IQ dá suporte a Link Privado, pontos de extremidade privados, integração de VNet ou lista de permissões de IP?
No. Nenhum deles é suportado atualmente. O Web IQ é acessado por meio de um único ponto de extremidade público, https://api.microsoft.ai/v3, por HTTPS com Entra ID ou autenticação de chave de API. Não há controle de acesso baseado em IP no ponto de extremidade da API.
O recurso de IQ da Web em sua assinatura Azure manipula a medição e a cobrança, mas não está no caminho da solicitação, portanto, Azure controles de rede como Link Privado, integração de VNet, Firewall do Azure, NSGs e topologias hub-and-spoke não têm nada no lado do IQ da Web para anexar. A integração de identidade (Entra ID) está alinhada ao Azure; a camada de rede não está.
No seu ambiente, permita o hostname api.microsoft.ai em seus controles de saída.
O tráfego de Azure para o Web IQ permanece na rede da Microsoft ou no backbone do Azure?
Isso não é garantido. Os clientes se conectam ao ponto de extremidade público https://api.microsoft.ai e o tráfego é protegido em trânsito com HTTPS.
O tráfego da API de IQ da Web termina em Azure Front Door, que dá suporte ao TLS 1.2 e ao TLS 1.3 com estes conjuntos de criptografia:
-
TLS 1.3:
TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256 -
TLS 1.2:
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
O Zscaler ou outra ferramenta de inspeção de saída interferirá no Web IQ?
Ele não deve interferir quando configurado para permitir conexões para api.microsoft.ai. Esta é uma ação padrão de lista de permissões, não um bypass amplo. A mesma abordagem se aplica a outros gateways da Web seguros, como o Netskope.
Posso colocar o Web IQ por trás do Gerenciamento de API do Azure?
Sim. Você pode colocar o Gerenciamento de API do Azure ou outro gateway na frente do Web IQ em sua própria assinatura do Azure para observabilidade e governança, e não há limitações impeditivas conhecidas. As chamadas à API vão do seu chamador para https://api.microsoft.ai/v3 via TLS com uma chave de API ou token de Entra ID, portanto, qualquer coisa que você colocar na frente desse tráfego é sua própria infraestrutura em seu locatário. Microsoft não publica uma arquitetura de referência para essas implantações; sua equipe de arquitetura de nuvem é responsável por esse design.
Nos Termos de Uso do IQ da Web, o conteúdo da resposta não pode ser armazenado em cache ou armazenado para criar um conjunto de dados derivado, independentemente do que o gateway faz. A telemetria operacional, como status, latência, cabeçalhos e IDs de rastreamento, pode ser mantida, por exemplo, no Application Insights ou Log Analytics.
Quais controles de segurança estão disponíveis?
- Autenticação: Entra ID (credenciais de cliente do OAuth 2.0) ou uma chave de API.
- Autorização: acesso por AppID às APIs. Chamadas não autorizadas retornam HTTP 403.
- Limitação de taxa de requisições: imposição de cota por AppID. Solicitações acima do limite retornam HTTP 429.
- Transporte: somente HTTPS.
A política de rede no perímetro é de sua responsabilidade. Se você tiver requisitos de arquitetura específicos que gostaria de avaliar, entre em contato com o Web IQ Support.
Limites de taxa e chaves de API
Há um limite de requisições?
Sim. Cada IQ AppID da Web tem um limite padrão de 15 consultas por segundo (QPS). Um recurso de IQ da Web geralmente tem um AppID, criado quando você conecta o recurso. O Portal do Desenvolvedor do Web IQ exibe o limite.
O limite é compartilhado entre todas as chaves de API e os IDs de aplicativo (cliente) do Entra vinculados para essa AppID. Solicitações acima do limite retornam HTTP 429.
Posso aumentar meu limite de taxa de requisições?
Sim. Cada AppID do Web IQ tem 15 QPS. Para solicitar um limite mais alto, abra uma Web IQ Support request com seu caso de uso e tráfego esperados.
Quantas chaves de API posso criar?
Você pode criar quantas chaves o aplicativo precisar. A criação de chaves é gratuita, mas todas as chaves de um AppID compartilham seu limite de taxa.
Privacidade e manipulação de dados
O Web IQ registra consultas à API?
Sim. As solicitações de API são registradas para fins operacionais: confiabilidade do serviço, depuração e melhoria de qualidade. Isso é padrão para serviços da Microsoft.
- O acesso é restrito ao pessoal autorizado de engenharia e operações Microsoft e é regido pelas políticas internas de controle de acesso da Microsoft. Os dados nos logs não são acessíveis a outros clientes ou terceiros.
- Os logs são armazenados na infraestrutura de produção do Microsoft e estão sujeitos aos controles de segurança padrão da Microsoft, incluindo controle de acesso baseado em função e trilhas de auditoria.
- Os logs são criptografados em trânsito (HTTPS) e em repouso usando as práticas de criptografia padrão do Microsoft.
Microsoft opera como um controlador de dados de acordo com a Declaração de Privacidade da Microsoft.
Por quanto tempo as consultas são retidas?
A retenção da telemetria de consulta é regida pela Seção 4 dos Termos de Uso do Web IQ, o que sujeita o processamento da Microsoft à Declaração de Privacidade da Microsoft. Não há nenhum compromisso de retenção específico do Web IQ separado além do que a Política de Privacidade descreve.
Posso desativar o registro em log de consultas para cargas de trabalho regulamentadas ou confidenciais?
O texto da consulta é capturado como parte da telemetria de solicitação padrão e seu processamento é regido pela Política de Privacidade Microsoft e pela Seção 4 dos Termos de Uso do IQ da Web.
Se você tiver um driver de conformidade ou regulamentação específico, o Web IQ oferecerá Log de Consulta Zero, o que suprimirá o texto da consulta da telemetria. A consulta ainda é enviada para Microsoft para atender à solicitação; O Log de Consultas Zero mantém o texto da consulta fora de nossos logs. Não é autoatendimento: nossa equipe de produtos ativa isso para você, para todos os seus aplicativos ou apenas para os específicos. Para solicitá-lo, entre em contato com sua equipe de conta Microsoft e compartilhe:
- A estrutura regulatória ou de conformidade que se aplica (por exemplo, GLBA, HIPAA, GDPR ou APPI).
- Uma breve descrição do seu cenário de implantação.
Com o Log de Consulta Zero, o texto da consulta, os títulos de resultados e as URLs, o endereço IP e a ID do aplicativo Entra não são mantidos. Os campos AppID, ID de rastreamento, tempo, status e cobrança são mantidos para que possamos executar e cobrar o serviço. Não há nada para configurar ao seu lado.
Posso verificar se o Log de Consulta Zero está ativado?
Não está no Portal do Desenvolvedor Web IQ ou na API hoje. Se você precisar de confirmação, por exemplo, para uma auditoria, abra uma solicitação de suporte do Web IQ com seu AppID, e o Suporte do Web IQ confirmará a configuração por escrito.
Posso ativar ou impor o Log de Consulta Zero por meio de uma API, Terraform ou Azure Policy?
Não hoje. Nossa equipe de produtos ativa o Zero Query Logging por solicitação, para todos os seus aplicativos ou para os específicos. Quando estiver ativado para todos os aplicativos, os novos aplicativos criados no locatário Microsoft Entra da sua organização serão cobertos automaticamente, sem outra solicitação. Não há API, configuração do Terraform nem definição de Azure Policy para ativá-la, exigi-la ou auditá-la. Você pode controlar quem cria recursos do Web IQ em suas assinaturas com suas permissões existentes do Azure. Para confirmar a configuração de uma auditoria, abra uma solicitação de Suporte do Web IQ com sua AppID.
Quais compromissos de residência de dados o Web IQ fornece?
Nada hoje. O Web IQ não assume compromissos de residência de dados específica por região nem de processamento na região, e o roteamento entre regiões para o ponto de extremidade disponível mais próximo é o comportamento esperado. A privacidade é coberta pela Política de Privacidade Microsoft. Microsoft não oferece compromissos sobre o local ou a nacionalidade do pessoal que pode acessar os dados.
O Web IQ é coberto pelo Azure Data Protection Addendum ou pelo EU Data Boundary?
No. A seção 4.1 dos Termos de Uso do Web IQ exclui o serviço do Adendo de Proteção de Dados de Produtos e Serviços da Microsoft.
Em vez disso, Microsoft e o cliente atuam como controladores de dados independentes para quaisquer Dados Pessoais processados nos Termos de Uso (Seção 4.4). O processamento da Microsoft é regido pela Política de Privacidade da Microsoft (Seção 4.2), e você é responsável por fornecer a notificação apropriada aos seus usuários finais.
Para transferências internacionais, os Termos de Uso incorporam Cláusulas Contratuais Padrão quando necessário (Seção 4.6.1). Esse mecanismo de transferência ocorre por meio dos Termos de Uso, que ficam sob sua Contrato de Cliente da Microsoft, e não por meio do Adendo de Proteção de Dados.
O Web IQ não assume compromissos com EU Data Boundary, residência de dados específica da região ou processamento na região hoje.
Você fornece uma DPA ou uma declaração de conformidade para uma lei de privacidade específica, como a APPI do Japão?
No. O Web IQ está excluído do Adendo de Proteção de Dados de Produtos e Serviços da Microsoft (Seção 4.1 dos Termos de Uso do Web IQ) e não emitimos declarações para leis de privacidade específicas. A posição por escrito da Microsoft é a Seção 4 dos Termos de Uso, juntamente com a Microsoft Privacy Statement, à qual a Seção 4.2 se aplica ao Web IQ. A seção 4 aborda:
- O que Microsoft pode coletar em conexão com solicitações, incluindo a consulta, o endereço IP do usuário final, a hora da solicitação e os resultados retornados (Seção 4.2).
- Microsoft e o cliente como controladores de dados independentes (Seção 4.4).
- Solicitações de titular de dados (Seção 4.5).
- Não há transferência de dados pessoais para terceiros, exceto subcontratados e terceiros associados por termos pelo menos tão protetores quanto os Termos de Uso (Seção 4.7.2).
- Cooperação em reclamações regulatórias (Seção 4.8).
O IQ da Web não detecta nem mascara dados pessoais em consultas e não faz compromissos de residência de dados. Sua equipe jurídica é melhor posicionada para avaliar como isso se ajusta às suas obrigações de acordo com a lei que se aplica a você; Estamos felizes em responder perguntas de acompanhamento.
O IQ da Web detecta ou mascara dados pessoais em consultas?
No. O Web IQ não executa a detecção do lado do servidor nem o mascaramento de dados pessoais em consultas de entrada. Se uma carga de trabalho puder enviar dados pessoais ou confidenciais, higienize-os antes de chamar o Web IQ, por exemplo, com Linguagem de IA do Azure PII Detection como uma etapa de pré-processamento. Dessa forma, nada sensível deixa seu ambiente e você mantém controle total sobre o que atinge a API.
O IQ da Web dá suporte a setores regulamentados?
Sim. O Web IQ dá suporte a uma variedade de casos de uso corporativos e regulamentados. Se você tiver requisitos especializados de conformidade, governança ou setor, entre em contato com o Web IQ Support.
Segurança e cobertura de conteúdo
Quais controles de segurança de conteúdo são aplicados?
Web IQ aplica classificação de qualidade e segurança em tempo de rastreamento, filtragem de conteúdo adulto e regras de elegibilidade de conteúdo por cliente. O SafeSearch é imposto no strict lado do servidor por padrão. Os resultados da Pesquisa na Web também incluem um campo isAdult para tratamento adicional do lado do cliente.
O Web IQ protege uma LLM contra injeção de prompt no conteúdo recuperado?
Microsoft Web IQ recupera e classifica o conteúdo da Web; ele não executa, interpreta ou age com base em instruções inseridas no conteúdo recuperado. O IQ da Web complementa esse comportamento de recuperação com a qualidade, a confiança, o spam e a triagem de conteúdo mal-intencionado existentes do Bing.
A proteção contra injeção indireta de prompt, tentativas de jailbreak e ataques de seguimento de instruções é principalmente responsabilidade do modelo downstream e da camada de orquestração. Trate os prompts e o conteúdo recuperado como entradas não confiáveis e aplique controles em camadas, como Prompt Shields, Segurança de Conteúdo de IA do Azure, isolamento de prompt do sistema, acesso a ferramentas de privilégio mínimo, validação de fundamentação e validação de saída. Web IQ não deve ser tratado como o único ponto de controle para mitigação de injeção de prompt.
Como o conteúdo da Web é processado antes que o Web IQ o retorne? Ele é sanitizado para instruções semelhantes a prompts?
Microsoft Web IQ não opera diretamente em HTML de página bruta no momento da recuperação. Durante a indexação, o conteúdo da Web é normalizado em uma representação de documento estruturada projetada para preservar conteúdo significativo e estrutura de documentos. As passagens retornadas pelo Web IQ são selecionadas nessa representação, que é o que permite extração e recuperação mais consistentes em toda a API. Os controles existentes do Bing de qualidade, segurança, spam e triagem de conteúdo mal-intencionado também se aplicam como parte do pipeline de indexação.
Web IQ não pode garantir que o conteúdo retornado esteja livre de scripts ou malware, e essa normalização não é uma garantia de que o texto semelhante ao prompt seja identificado ou removido. Trate o conteúdo recuperado como entrada não confiável e aplique as proteções de camada de modelo e orquestração descritas na resposta anterior.
O Web IQ retorna conteúdo de página oculto ou não voltado para o usuário?
Microsoft Web IQ tenta retornar conteúdo visível por meio da interação normal do usuário, incluindo o conteúdo revelado por meio de controles de página comuns ou renderização do lado do cliente. Isso não é garantido. A estrutura e a implementação da página variam, portanto, os aplicativos não devem assumir que cada trecho retornado estava visível no estado inicial da página ou que cada elemento oculto sempre será excluído.
Como Microsoft mantém a qualidade do índice?
As páginas são avaliadas para qualidade, autoridade e confiabilidade. Conteúdo mal-intencionado, spam e phishing é detectado e excluído e o índice é atualizado continuamente. É do mesmo índice do qual dependem os próprios produtos de IA do Microsoft.
Como o IQ da Web respeita as preferências de conteúdo do editor?
O Web IQ foi projetado para honrar os controles de editor com suporte, incluindo diretivas de robots.txt aplicáveis e outros sinais de editor reconhecidos pela Microsoft.
Há uma lista publicada de sites excluídos ou categorias bloqueadas?
No. Os controles de exclusão incluem conformidade com o robots.txt, remoções legais e de conformidade (como avisos DMCA e ordens judiciais), spam, malware e filtragem de phishing e filtragem de conteúdo adulto. As próprias listas são proprietárias e atualizadas continuamente. Se você tiver preocupações sobre categorias específicas de conteúdo que aparecerem, ou não, nos resultados, entre em contato com o Web IQ Support para discutir se a configuração do seu Web IQ AppID atende a esses requisitos.
Que conteúdo o Web IQ cobre e quão recente é?
Web IQ recupera continuamente novas informações em páginas da web, notícias e resultados de imagem e vídeo para ajudar seu agente de IA ou aplicativo a responder perguntas além dos dados de treinamento do modelo.
Disponibilidade e atualização variam de acordo com a API, o tipo de origem e o caso de uso; não há uma única garantia de atualização para todo o conteúdo. Considere os requisitos de recência da carga de trabalho ao escolher as fontes e as configurações de recuperação.
Quais idiomas e mercados o Web IQ dá suporte?
O IQ da Web é extraído da Web global, mas a cobertura varia de acordo com o idioma, o mercado, o tópico e o tipo de origem. Examine a página de idiomas e regiões com suporte para os códigos que cada API aceita e avalie a cobertura em relação às informações de que os usuários pretendidos precisam.
Os clientes na China devem ligar https://api.microsoftol.com/v3; A Pesquisa de Notícias não está disponível lá (URL base).
Posso configurar listas de permissão ou negação de domínio?
Para domínios individuais ou listas pequenas, use operadores de consulta padrão, como site:example.com para incluir um domínio e -site:example.com para excluir um. Para reutilizar um conjunto nomeado de regras de inclusão e exclusão na Pesquisa na Web ou pesquisa de notícias, crie um escopo de Qi da Web para uma conta de cobrança com o gerenciamento de escopo disponível. Os escopos nomeados dão suporte a até 10.000 seletores exclusivos normalizados por lista, sujeitos ao limite combinado de tamanho de definição.
Por que não vejo resultados do LinkedIn?
Os resultados do LinkedIn estão excluídos no momento.
O que acontece quando Browse é chamado para uma URL excluída?
Navegar retorna HTTP 403. A lista de exclusão base não é exibida.
Como posso tornar meu site detectável para o Web IQ?
Web IQ é criado no mesmo índice da Web que a Microsoft usa para seus próprios produtos de IA. Use práticas padrão de descoberta da Web, como sitemaps, IndexNow, Ferramentas para webmaster do Bing e uma política de robots.txt apropriada. Não há nenhum caminho de envio de Web IQ separado.
Escopos de pesquisa nomeados
Como posso controlar e filtrar os resultados do Web IQ?
Use escopos para filtrar os resultados da Pesquisa na Web e pesquisa de notícias com listas reutilizáveis de URLs, sites, domínios ou caminhos para incluir ou excluir. Crie um escopo nomeado e selecione-o com o parâmetro de solicitação scopeName . As exclusões têm precedência sobre inclusões. Veja como filtrar resultados com Scopes.
Como uma conta de cobrança do Web IQ é diferente de um AppID ou ID do cliente Entra?
Uma conta de cobrança do Web IQ agrupa AppIDs do Web IQ, acesso à conta e uma coleção de escopo atribuída. Um Web IQ AppID seleciona a configuração de pesquisa de runtime do aplicativo. Uma ID do aplicativo Entra (cliente) identifica o registro do aplicativo que adquire tokens do Entra; não é nenhuma das duas IDs do Web IQ. Veja os principais conceitos e a descoberta de recursos autorizados.
Posso usar minhas credenciais de pesquisa para criar escopos?
O acesso à pesquisa não concede automaticamente acesso de gerenciamento. Um aplicativo que chama a API de gerenciamento do Web IQ precisa de um token Entra somente de aplicativo e acesso de gerenciamento CustomerApiAccess na conta de cobrança pretendida. Um administrador de conta humana concede isso separadamente. Confira o acesso da API de gerenciamento concedido ao aplicativo.
Por que a página Escopos diz que nenhuma conta de cobrança está disponível?
A página Escopos lista apenas as contas de cobrança que seu login pode acessar. Verifique duas coisas:
- Você conectou seu recurso Web IQ no Portal do Desenvolvedor do Web IQ. Se você fez isso, seu AppID será exibido em Gerenciamento de Perfil. Se isso não acontecer, siga Criar um recurso Web IQ no portal do Azure.
- Você está conectado com o mesmo endereço de email usado para conectar o recurso.
Se ambos forem verdadeiros e a página ainda estiver vazia, abra uma solicitação de suporte do Web IQ, escolha Authentication & Access como o tipo de problema e inclua seu AppID e o endereço com o qual você entra.
Os escopos são específicos para um AppID do Web IQ?
No. Os AppIDs de IQ da Web em uma conta de cobrança usam sua coleção de escopo atribuída. Os nomes são únicos sem diferenciar maiúsculas de minúsculas nessa coleção. As contas atribuídas à mesma coleção compartilham suas definições, portanto, edições ou exclusões afetam todos os consumidores dessas definições. Saber um nome não concede acesso aos escopos de outra conta.
Uma lista incluída vazia desabilita um escopo?
No. A inclusão vazia permite todas as fontes não excluídas. Se ambas as listas estiverem vazias, o próprio escopo não imporá nenhuma restrição de site. A exclusão sempre tem precedência sobre a inclusão.
E se a pesquisa não conseguir encontrar meu escopo?
failOnMissingScope o padrão é true: uma falha relatada na aplicação do escopo retorna um erro em vez de um resultado sem escopo. Um nome incorreto ou propagação incompleta pode fazer com que o escopo esteja ausente. Se você definir explicitamente false, a pesquisa poderá prosseguir em todo o índice sem o escopo e retornar scopeApplied: false. Use essa configuração somente se os resultados sem escopo forem aceitáveis. Consulte erros de escopo nomeado.
ScopeApplied true significa que a pesquisa usou minha definição de escopo mais recente?
No.
scopeApplied: true significa que um escopo foi aplicado para essa solicitação. Ele não identifica a versão usada nem garante a propagação global. O campo é opcional quando nenhum resultado do aplicativo é relatado; não suponha que esteja sempre presente ou nulo false para solicitações sem resultado do aplicativo scopeName.
Se usar uma definição anterior durante a implantação for inaceitável, crie e verifique um escopo com um novo nome antes de alternar os chamadores. Ainda não há nenhum endpoint de readiness nem controle de versão de escopo. A propagação global completa geralmente leva cerca de 10 minutos, mas pode levar até 30 minutos em alguns casos. No momento, não há nenhum SLA de propagação e esses intervalos não são garantidos. A troca de chamadores não é globalmente atômica.
Comportamento de consulta e qualidade do resultado
Devo usar consultas de palavra-chave ou linguagem natural?
Ambos funcionam. As consultas em linguagem natural geralmente funcionam bem com contentFormat=passage, enquanto as consultas por palavra-chave são úteis para pesquisas precisas, como nomes de empresas, códigos de negociação ou tópicos específicos. Evite consultas excessivamente longas ou compostas; divida várias necessidades de informações em chamadas de API separadas.
Qual é o tamanho máximo da consulta?
O máximo é de 1.000 caracteres e as consultas mais longas são rejeitadas. Consultas mais curtas e focadas geralmente produzem melhores resultados: se uma consulta contiver muito contexto, a recuperação poderá não se concentrar no sinal certo.
Posso filtrar os resultados da Pesquisa na Web por data?
A Pesquisa na Web não oferece um filtro de intervalo de datas hoje e recomendamos evitar um filtro de data rígido, a menos que você realmente precise de um. A atualidade já é considerada na classificação com base na consulta, e a adição de uma restrição rígida de data quase sempre custa relevância. Para cenários de notícias, use a API de Notícias em vez de filtrar os resultados da Pesquisa na Web por data.
lastUpdatedAt é a data em que o editor atualizou o conteúdo pela última vez, não a data em que o Web IQ verificou a página pela última vez, portanto, uma data mais antiga não significa que a página não foi verificada recentemente. Ele é retornado na resposta, não é um filtro de solicitação e nem todos os resultados o incluem. Você pode usá-lo para classificar ou filtrar resultados em seu aplicativo.
A Pesquisa na Web pode lidar com um prompt que contém várias perguntas?
Cada solicitação de Pesquisa na Web manipula uma consulta. Se um prompt contiver várias perguntas ou intenções, divida-o em consultas separadas em seu aplicativo, chame a Pesquisa na Web para cada uma e combine os resultados antes de gerar a resposta.
O Web IQ pode dar suporte a fluxos de trabalho de agente de várias etapas?
Sim. Um agente pode chamar o Web IQ sempre que precisar de evidências adicionais da web durante uma tarefa. A latência de recuperação é particularmente importante em fluxos de trabalho que fazem várias chamadas antes de produzir uma resposta.
Como meu agente de IA ou aplicativo deve lidar com evidências recuperadas?
Use evidências relevantes para a pergunta e acompanhe quais fontes dão suporte à resposta. Mantenha o conteúdo recuperado separado das instruções que controlam o agente. Quando as fontes entram em conflito ou as evidências estão incompletas, deixe essa incerteza clara em vez de preencher lacunas com afirmações sem fundamento.
Como a qualidade de aterramento se compara?
Na comparação publicada da Microsoft, Auto e Web Search atingiram maior satisfação de grounding com contagens de tokens menores do que os serviços comparados, e o Auto atingiu a maior satisfação de grounding geral. Os resultados dependem do conjunto de consultas, modelo e método de avaliação, portanto, valide a qualidade em seus próprios cenários.
Fonte: resultados de benchmark do Web IQ. 2.850 consultas globais amostradas aleatoriamente, avaliadas de 8 a 9 de novembro de 2026.
O IQ da Web trata as fontes relacionadas à saúde de forma diferente?
Os modelos de classificação do Web IQ usam sinais para credibilidade de origem. Para consultas relacionadas à saúde, esses sinais são orientados por princípios desenvolvidos independentemente pela Academia Nacional de Medicina. Isso se aplica à Pesquisa na Web e aos resultados automáticos provenientes da Pesquisa na Web; não se aplica a 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 escolhidos, use Escopos.
Por que os resultados diferem de Bing.com?
Web IQ é otimizado para consumo de LLM, densidade factual, qualidade de passagem e baixa latência. Bing.com é uma experiência do consumidor com sinais de classificação adicionais, personalização adicional, respostas visuais adicionais e conteúdo adicional que podem não ser redistribuíveis por meio de uma API. Algumas diferenças de classificação são esperadas.
Solicitações idênticas podem retornar resultados diferentes?
Alguma variação é esperada porque o índice é atualizado continuamente e as atualizações se propagam entre data centers. Os resultados de solicitações idênticas feitas em sequência próxima devem permanecer amplamente estáveis. Se você vir uma variação significativa em consultas idênticas em segundos, entre em contato com o Web IQ Support.
Por que uma consulta retorna menos resultados do que o esperado?
Verifique a resposta bruta do Web IQ antes de contar os resultados. A causa mais comum é uma configuração do lado do cliente ou uma etapa de pipeline downstream que filtra os resultados válidos antes de serem medidos.
maxResultsVerifique também a qualificação de conteúdo, o comportamento do SafeSearch e quaisquer site: operadores ou -site: operadores na consulta.
Como a linguagem, a região e a localização afetam os resultados?
A linguagem da consulta em si é a mais importante; e region os language parâmetros desempenham uma função secundária, e seu efeito pode variar de acordo com a API. Qualquer idioma com suporte funciona com qualquer região com suporte, por exemplo en , com IN, AUou NZ. A região afeta a classificação, a combinação de fontes e unidades (por exemplo, °C ou °F), mas não o formato de data. Uma consulta sobre um tópico global ainda retorna resultados globais. Para consultas locais como "clima perto de mim", a localização importa mais do que a região.
Ambos os parâmetros assumem códigos de duas letras; qualquer outro valor retorna HTTP 400. Se uma região de duas letras não tiver suporte, o Web IQ usa US. Se não houver suporte para um idioma de duas letras, ele usará o idioma padrão para essa região. Nenhum dos casos retorna um erro. Isso funciona da mesma forma em Pesquisa na Web, Pesquisa de Notícias e Auto. Consulte idiomas e regiões com suporte.
Qual é a diferença entre o Auto e o Auto Advanced?
São dois modos da mesma API. Auto, o padrão, escolhe as fontes para uma pergunta e retorna as evidências citadas em uma chamada. O Auto Advanced executa rodadas de recuperação adicionais para perguntas complexas; para usá-lo, defina "mode": "advanced". É cobrado separadamente; consulte Preços.
Preciso de responseFilter com o Auto?
No. Auto decide automaticamente de quais evidências uma consulta precisa (web, notícias, clima e muito mais) e as retorna em uma chamada, portanto, você não precisa chamar cada API separadamente.
responseFilter lista os tipos de evidência que o Auto pode incluir; quando você omite, todos os tipos são elegíveis. Para deixar de fora tipos que você nunca deseja, como imagens ou vídeos, liste apenas os que você deseja (por exemplo, ["web", "news"]). Defina-o uma vez para o aplicativo em vez de por consulta. O Auto dá suporte aos mesmos idiomas e regiões que a Pesquisa na Web e responseFilter funciona da mesma forma em todas as regiões. Consulte a referência da Auto API.
Formatos de conteúdo
O que cada resultado retorna: passagens ou o documento completo?
Pesquisa na Web e Pesquisa de Notícias retornam o conteúdo de cada resultado no campo content. Com contentFormat definido como passage, você obtém as partes do documento mais relevantes para sua consulta. Com text, htmlou markdown, você obtém o documento completo: a versão estruturada da página que o Web IQ cria durante a indexação. Os trechos funcionam para cada aplicativo; os formatos completos do documento precisam de acesso completo ao documento. Imagens e vídeos retornam detalhes do resultado, como títulos, URLs e miniaturas, não conteúdo de página. Places retorna detalhes estruturados de locais, como endereços, horários de funcionamento, avaliações e fotos, além de passagens relacionadas à consulta de pesquisa. Consulte Passagens e formatos de conteúdo.
O que é passagee por que usá-lo?
Defina contentFormat=passage e a API retorna, para cada resultado, apenas os segmentos do documento mais relevantes para a consulta, não o documento completo. O documento completo é processado do lado do Web IQ, e o que retorna é um trecho direcionado à consulta, para que sua LLM não precise passar por parágrafos não relacionados para encontrar a sentença relevante.
- Economia de token: a LLM recebe uma fração do documento em vez de tudo isso.
- Melhor factualidade: com menos conteúdo fora do tópico no contexto, o modelo tem menos probabilidade de ancorar em um parágrafo tangencial.
Defina contentFormat=passage em cada solicitação de Web Search and News. O Browse também oferece suporte a passage: envie um query e Browse retorna as partes da página mais relevantes para sua consulta.
Qual formato devo usar?
Use passage para aterramento. É o formato recomendado e funciona para cada aplicativo. Use text, html ou markdown quando precisar de todo o documento, por exemplo, para resumir ou extrair de uma página completa. Esses formatos precisam de acesso completo ao documento.
Devo definir contentFormat e maxLength em cada solicitação?
Sim. Defina ambos em cada solicitação de Pesquisa na Web e Notícias para que você sempre obtenha o formato e o comprimento esperados.
Qual é o tamanho máximo do campo content?
Até maxLength caracteres. Sem acesso completo ao documento, as passagens têm no máximo 3.000 caracteres por resultado, mesmo que maxLength seja maior. Com acesso completo maxLength ao documento, pode ter até content, até 500.000 caracteres. Documentos completos mais longos do que maxLength são cortados.
Por que recebo HTTP 403 (AuthContentFormatForbidden) ao definir contentFormat como text, html, ou markdown?
Na Pesquisa na Web e na Pesquisa de Notícias, text, html e markdown retornam o documento completo e precisam de acesso completo ao documento. Sem ele, esses formatos retornam HTTP 403 com o código AuthContentFormatForbiddende erro.
passage funciona em qualquer aplicativo.
Como fazer para obter o documento completo como text, htmlou markdown?
Abra uma solicitação de suporte do Web IQ. Aplicativos que já usam html ou text continuam funcionando como hoje.
O que o Browse retorna?
Navegar retorna conteúdo para uma URL que você escolher, até maxLength caracteres. Com contentFormat definido como passage e um query, retorna as partes da página mais relevantes para a consulta. Esse é o formato padrão, a menos que seu aplicativo tenha acesso completo ao documento. Com acesso completo ao documento, ele também pode retornar todo o documento como text, htmlou markdown. Consulte a referência da API Browse.
Por que recebo HTTP 400 do Browse quando não envio um query?
Uma solicitação de passagem requer uma query que não esteja em branco.
passage é o formato padrão, a menos que seu aplicativo tenha acesso completo ao documento, portanto, inclua query em cada solicitação de Browse, até 1000 caracteres. Consulte Passagens e formatos de conteúdo.
Como ajustar maxResults e maxLength para gerenciar os custos de janela de contexto e token?
O IQ da Web pode priorizar passagens relevantes para uma consulta em vez de fornecer contexto de página desnecessário. Isso pode reduzir a quantidade de texto passado para seu modelo e reduzir os custos de token de entrada. Os benefícios dependem do seu modelo, dos prompts, da combinação de consultas e das configurações de recuperação.
Para a maioria dos cenários de grounding, mais resultados com passagens mais curtas produzem resultados melhores do que menos resultados com passagens mais longas para aproximadamente o mesmo orçamento total de tokens. Um bom ponto de partida é maxResults=10 com maxLength cerca de 3.000 caracteres em passage formato. Faça testes comparativos com suas próprias consultas e seu modelo.
Por que a Pesquisa na Web e a Pesquisa de Notícias não retornam um campo snippet?
Isso é intencional. Ambos retornam content como um trecho dependente de consulta (passage) em vez de um snippet separado e independente de consulta.
Conteúdo da resposta
Qual é o valor máximo maxResults para a Pesquisa na Web?
A Pesquisa na Web dá suporte a até 50 resultados por solicitação.
Quais parâmetros de solicitação posso configurar?
A Pesquisa na Web expõe maxResults, language e region, contentFormat (passage, text, htmlou markdown), maxLengthe safeSearch. Consulte a referência de API para a lista de parâmetros completa.
Qual é a diferença entre lastUpdatedAt e crawledAt?
lastUpdatedAt é a data de atualização de conteúdo relatada pelo editor, retornada por Pesquisa na Web, Notícias, Vídeos, Imagens, Browse e Auto quando disponível.
crawledAt é a hora em que o Web IQ buscou a página pela última vez, retornado por Pesquisa na Web, Procurar, Notícias e Automático. Não é o momento da sua solicitação. A cobertura de ambos os campos varia de acordo com o resultado e nem todos os resultados os incluem.
O que é Browse Live Crawl e quando devo usá-lo?
O Browse retorna conteúdo do índice Da Web do Bing, que é atualizado continuamente conforme nossos rastreadores observam alterações na Web. É assim que a pesquisa na Web funciona em geral: os resultados da pesquisa são fornecidos a partir de um índice, em vez de buscar cada URL em tempo real em cada solicitação, e é isso que dá ao Browse sua velocidade e consistência.
O Browse dá suporte ao Live Crawl para URLs que não estão disponíveis no índice. Defina liveCrawl: "fallback" na solicitação para solicitar uma busca dinâmica quando a cópia indexada estiver ausente. O rastreamento ao vivo está sujeito a restrições de cortesia do publicador e à disponibilidade; fallback não garante um rastreamento real. Se o conteúdo indexado estiver disponível, Browse o retornará. Omitir o parâmetro (ou definir liveCrawl: "none") retorna apenas conteúdo indexado, sem rastreamento dinâmico. Consulte a referência da API Browse para obter detalhes completos do parâmetro.
O Live Crawl está disponível por padrão no Web IQ Browse e é provisionado com um teto de capacidade modesto por segundo, separado do QPS geral do Browse. Esse teto é compartilhado entre todas as chaves de API sob o AppID. A maioria das cargas de trabalho do Browse não precisa do Live Crawl e são melhor atendidas pelo caminho indexado padrão; use o Live Crawl quando uma URL não estiver disponível no índice.
O Browse pode recuperar páginas renderizadas em JavaScript?
Sim. Use renderDynamicPages: true em conjunto com liveCrawl: "fallback". Consulte a referência da Browse API para obter os detalhes completos do conjunto de parâmetros e da resposta. Teste URLs representativas antes de depender desse comportamento na produção.
O Browse pode extrair arquivos PDF online?
PDFs hospedados online não são um cenário de Navegação documentado hoje. Se você tiver um caso específico de uso de PDF, entre em contato com o Web IQ Support com uma URL representativa e o comportamento esperado e obterá uma resposta definitiva.
Cobrança e jurídico
Quanto custa o Web IQ?
O Web IQ usa preços baseados em consumo por chamada. O preço depende das APIs habilitadas para sua conta, seu uso e seus termos comerciais. Consulte Preços para ver as taxas atuais. O IQ da Web é cobrado por meio de Azure, portanto, seu uso conta para seu MACC (Compromisso de Consumo Microsoft Azure) e seu ACD (Desconto de Consumo Azure) e outros descontos de Azure negociados se aplicam a essas taxas. Commerce, em versão prévia privada, também é cobrado por chamada: Pesquisa, Ofertas e Detalhes do Produto compartilham um medidor e a mesma taxa.
Como a cobrança aparecerá em Azure?
O uso do Web IQ é medido e cobrado à sua assinatura do Azure por meio do seu recurso do Web IQ. O serviço em si é hospedado pela Microsoft, não provisionado em seu locatário.
Para ver os custos de perguntas frequentes da Web, abra a análise de custo para sua assinatura no portal do Azure, use o modo de exibição Custo por recurso e filtre no tipo microsoft.webiq/accountsde recurso. Cada API que você chama (por exemplo, Pesquisa na Web, Imagens ou Notícias) é exibida como seu próprio medidor. Auto tem dois medidores, um para /auto e um para /auto com mode: advanced. As APIs de Comércio compartilham um medidor de consumo.
O IQ da Web inclui um compromisso SLA, RTO ou RPO?
No. Microsoft Web IQ não inclui um contrato de nível de serviço. Os Termos de Uso do Web IQ não se comprometem com metas de disponibilidade, latência, RTO (Objetivo de Tempo de Recuperação) ou RPO (Objetivo de Ponto de Recuperação), e os termos do SLA não são adicionados para clientes individuais.
Preciso exibir citações?
Sim. A Exibição A, Seção 1 (Uso de LLM) dos Termos de Uso do Web IQ requer a atribuição de origem e um link de volta para cada fonte usada para o conteúdo de LLM exibido, próximo a esse conteúdo.
- Cite apenas as fontes realmente usadas para gerar a resposta. Se o IQ da Web retornou 10 resultados e seu modelo usou 3, exiba esses 3.
- As citações devem permanecer visíveis com a resposta e ser acessíveis com uma única ação. Não os mostre apenas brevemente, oculte-os atrás de várias telas ou exija que os usuários solicitem referências separadamente.
- Para interfaces restritas, como carros, wearables, dispositivos de voz ou quiosques, use um código QR persistente que leva a uma página listando cada citação usada na resposta atual, um aplicativo complementar que mostra a resposta com citações clicáveis ou uma lista na tela que o usuário pode abrir diretamente.
Você pode armazenar os links de origem mostrados com um Resumo de LLM junto com ele, no histórico de chat de um usuário final ou como parte do seu trabalho interno. Veja a pergunta de cache abaixo.
Quanto conteúdo de origem meu agente de IA ou aplicativo pode exibir?
O Anexo A dos Web IQ Terms of Use limita o Conteúdo de Grounding exibido de qualquer fonte única ao menor entre 200 caracteres e o máximo especificado pelo proprietário do site ou webmaster. Para experiências de voz ou áudio, aplique o mesmo limite à saída falada. Aplicam-se restrições adicionais a resumos e visualização. Examine os Termos de Uso antes de criar trechos; esse limite não é permissão para reproduzir páginas de origem inteiras.
Os resultados de imagem e vídeo podem ser usados para fundamentar uma LLM?
Metadados de imagem e vídeo e texto alt são incluídos na definição de Grounding Content. No entanto, os Termos de Uso do Web IQ proíbem o uso de imagens ou vídeos reais de resultados para fundamentação, incluindo-os na saída de LLM ou na criação de imagens ou vídeos derivados deles. Examine os termos da implementação pretendida.
Posso armazenar em cache ou armazenar o conteúdo do Web IQ?
Como regra geral, não. Os Web IQ Terms of Use proíbem copiar, armazenar, armazenar em cache, arquivar ou criar um banco de dados de conteúdo, exceto conforme os termos permitem (Seção 3.2.15 e Anexo A, Seção 4):
- Histórico de chat do usuário final: você pode armazenar LLM Summaries (os resumos que seu aplicativo cria com base no Grounding Content para usuários finais, Seção 2.5) em uma base não agregada, por usuário final, para o histórico de chat de cada usuário final, desde que a lei aplicável permita.
- Produto de trabalho interno: você pode armazenar resumos llm e os links de origem mostrados com eles como uma parte integrada de seu produto de trabalho interno, como memorandos, relatórios, apresentações ou logs de segurança e auditoria, na medida permitida pela lei de direitos autorais. Eles não podem ser usados como substituto para os Serviços ou o Conteúdo, por exemplo, para criar um banco de dados de Conteúdo, indexar links, rastrear ou extrair dados, ou oferecer uma pesquisa separada.
- Processamento transitório de Ação Atômica: o conteúdo pode ser mantido em um estado de processamento transitório apenas conforme estritamente necessário para concluir uma única solicitação lógica ou fluxo de trabalho iniciado por uma LLM (uma "Ação Atômica", que pode envolver várias etapas internas ou interações de agente). O conteúdo deve ser excluído imediatamente quando a Ação Atômica for concluída.
Fora dessas exceções, não armazene os próprios resultados da pesquisa: os Termos de Uso não permitem bancos de dados derivados, cache persistente ou arquivamento de longo prazo de Conteúdo.
Onde posso ler os Termos de Uso do Web IQ?
Os termos atuais são publicados em Microsoft Termos de Uso do Web IQ. Elas se aplicam junto com o seu Contrato de Cliente da Microsoft existente.