Visão geral das ferramentas de fundamentação web

As ferramentas de grounding na web do Microsoft Foundry Agent Service conectam os seus agentes a dados públicos em tempo real da web, superando a limitação de conhecimento do modelo Foundry do agente. Por exemplo, pode fazer perguntas como "qual é a principal notícia de IA atualmente" e receber respostas atuais e citadas.

Como funciona a integração da web

O processo de aterramento envolve vários passos principais:

  1. Formulação da consulta: O agente identifica lacunas de informação e constrói consultas de pesquisa com base na entrada do utilizador.
  2. Execução de pesquisa: A ferramenta de grounding envia consultas ao Bing e recupera os resultados.
  3. Síntese de informação: O agente processa os resultados da pesquisa e integra os resultados nas respostas.
  4. Atribuição de fonte: O agente fornece transparência ao citar fontes de pesquisa com URLs.

Pré-requisitos

Antes de usar qualquer ferramenta de aterramento web, certifique-se de que tem:

  • Um ambiente básico ou padrão de agente.
  • O pacote SDK mais recente para a sua linguagem (Python: azure-ai-projects, C#: Azure.AI.Projects e Azure.AI.Extensions.OpenAI, JavaScript: @azure/ai-projects). Consulte o quickstart para os passos de instalação.
  • Uma implementação de modelo Azure OpenAI no seu projeto Foundry.

Nota

A Pesquisa Web não requer funções adicionais além do acesso ao seu projeto Foundry. Integração com Bing Search e Bing Custom Search exigem as funções de Contribuidor ou Proprietário para criar recursos Bing, e a função de Gestor de Projetos de Azure AI para criar ligações de projeto. Para detalhes, consulte configuração do ambiente do agente.

Importante

Web Search, Grounding com Bing Search e Grounding com Bing Custom Search são Serviços de Consumo de Primeira Parte com termos para serviços online. São regidas pelo Grounding com os termos de uso do Bing e pela Declaração de Privacidade Microsoft.

O Adendo Microsoft Proteção de Dados não se aplica a dados enviados para Grounding com Bing Search ou Grounding com Bing Custom Search. Quando utiliza estes serviços, os seus dados fluem para além dos limites de conformidade e geometria do Azure. Isto também significa que a utilização destes serviços dispensa todos os compromissos elevados de segurança e conformidade da Government Community Cloud, incluindo soberania de dados e suporte baseado em triagem/cidadania, conforme aplicável.

Nota

A utilização de Grounding com Bing Search e Grounding com Bing Custom Search implica custos. Consulte os detalhes dos preços. Os administradores do Azure podem restringir o acesso a estas ferramentas. Para detalhes, consulte Controlo de administrador para a ferramenta de Pesquisa Web.

Determine a melhor ferramenta para os seus casos de uso

Se está a começar agora, use Web Search. Não requer recursos adicionais do Azure e é a forma mais simples de incorporar integração web ao seu agente.

Se estiver a migrar do Grounding com Bing Search na plataforma clássica de agentes, tanto Web Search como Grounding com Bing Search são opções GA na nova API de agentes. A Pesquisa Web não requer um recurso Bing separado. O alinhamento com o Bing Search oferece mais parâmetros e suporta modelos que não são da OpenAI implantados diretamente no Azure.

Os seguintes casos de uso ajudam-no a comparar as ferramentas disponíveis. O caso de uso 1 abrange a pesquisa geral na web, onde tanto a Pesquisa na Web como o Grounding com a Pesquisa Bing podem obter resultados da web pública. O caso de uso 2 cobre a pesquisa restrita ao domínio, que apenas o Grounding com a Pesquisa Personalizada Bing suporta.

Caso de uso 1: Grounding a partir da web geral indexada pelo Bing

Web Search (recomendado) Integração com a Pesquisa Bing
Estágio disponibilidade geral disponibilidade geral
Ponto de ligação com fonte Bing Gerido pela Microsoft Gerido por si — requer primeiro criar um recurso de Grounding com o Bing Search
Parâmetros suportados - user_location: Fornece resultados geo-relevantes
- search_context_size: baixo/médio/alto (padrão: médio)
Saiba mais sobre os parâmetros da Web Search		 - count: o máximo de resultados devolvidos pelo Bing
- freshness: especifica o período para os resultados da pesquisa
- market: especifica a região dos resultados da pesquisa
- set_lang: especifica a linguagem dos resultados da pesquisa
Saiba mais sobre os parâmetros de pesquisa do Bing
Fronteira de dados Os dados fluem fora do limite de conformidade do Azure Os dados fluem fora do limite de conformidade do Azure
Modelos suportados Modelos Azure OpenAI Modelos OpenAI do Azure e modelos diretos do Azure (modelos não-OpenAI implementados diretamente no Azure)

Caso de Uso 2: Aterramento a partir de domínios específicos que definiste

Web Search (recomendado) Introdução com Pesquisa Personalizada do Bing
Estágio GA (requer uma instância Bing Custom Search) Pré-visualização
Restrição a domínios personalizados Suportado — usar custom_search_configuration para pré-definir domínios permitidos ou bloqueados (requer criar um recurso + instância Bing Custom Search) Suportado — usar custom_search_configuration para pré-definir domínios permitidos ou bloqueados (requer criar um recurso + instância Bing Custom Search)
Outros parâmetros - user_location: Fornece resultados geo-relevantes
- search_context_size: baixo/médio/alto (padrão: médio)
Saiba mais sobre os parâmetros da Web Search		 - count: o número máximo de resultados devolvidos pelo Bing
- freshness: especifica o período para os resultados da pesquisa
- market: especifica a região dos resultados da pesquisa
- set_lang: especifica a linguagem dos resultados da pesquisa
Saiba mais sobre os parâmetros de Pesquisa Personalizada do Bing
Modelos suportados Modelos Azure OpenAI Modelos Azure OpenAI e modelos diretos Azure

Perguntas comuns

Que ferramenta devo usar se estou apenas a começar?

Use a pesquisa na Web. Não requer recursos adicionais de Azure, gere automaticamente a gestão de recursos do Bing e fornece resultados geo-relevantes com o parâmetro user_location.

Posso usar ferramentas de interface web com projetos Foundry protegidos por rede?

As ferramentas de fundamentação web não respeitam VPNs ou endpoints privados. Atuam como pontos de acesso públicos. Considere esta implicação de segurança ao usar o Foundry protegido por rede com estas ferramentas.

Como posso restringir os resultados de pesquisa a sites específicos?

Use a pesquisa na Web. Esta ferramenta permite-lhe definir uma lista de autorização ou lista de bloco de domínios, de modo a que os resultados de pesquisa provenham apenas de fontes que aprova.

Existem custos adicionais para o aterramento da teia?

Sim. Web Search, Grounding via Bing Search e Grounding via Bing Custom Search (prévia) geram custos além do uso padrão do Azure OpenAI. Consulte os detalhes dos preços.

Resolução de problemas

Problema Causa provável Resolução
O agente não utiliza fundamentos da web A ferramenta não está configurada ou o modelo não suporta a ferramenta. Verifique se a ferramenta está incluída na definição do seu agente. Use tool_choice="required" para forçar o uso da ferramenta. Verifique se a implementação do seu modelo suporta a ferramenta.
Sem citações em resposta O modelo gerava uma resposta sem usar resultados de pesquisa. Adicione instruções explícitas para citar sempre as fontes. Use tool_choice="required" para garantir a invocação da ferramenta.
Os resultados da pesquisa não são relevantes A formulação da consulta não captou a intenção do utilizador. Melhorar as instruções do agente para orientar a construção da consulta. Para as ferramentas do Bing, ajuste os parâmetros market e set_lang.
Ferramenta bloqueada pelo administrador A sua empresa desativou as ferramentas de estabilidade da web. Contacte o seu administrador do Azure para permitir o acesso. Ver controlo de administrador.
Custos inesperados As ferramentas de aterramento web têm preços baseados no uso. Revise os detalhes dos preços e implemente limites de taxas, se necessário.

Conteúdo relacionado

  • Last updated on