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.
As ferramentas de fundamentação na Web do Serviço de Agente do Microsoft Foundry conectam seus agentes a dados públicos da Web em tempo real, superando a limitação de conhecimento do modelo do Foundry do agente. Por exemplo, você pode fazer perguntas como "quais são as principais notícias de IA hoje" e receber respostas atuais e citadas.
Como funciona a fundamentação da web
O processo de aterramento envolve várias etapas principais:
- Formulação de consulta: o agente identifica lacunas de informações e constrói consultas de pesquisa com base na entrada do usuário.
- Execução da pesquisa: a ferramenta de referência envia consultas ao Bing e recupera resultados.
- Síntese de informações: o agente processa os resultados da pesquisa e integra as descobertas em respostas.
- Atribuição de origem: o agente fornece transparência citando fontes de pesquisa com URLs.
Pré-requisitos
Antes de usar qualquer ferramenta de aterramento na web, verifique se você tem:
- Um ambiente de agente básico ou padrão.
- O pacote do SDK mais recente para seu idioma (Python:
azure-ai-projects, C#:Azure.AI.ProjectseAzure.AI.Extensions.OpenAI, JavaScript:@azure/ai-projects). Consulte o início rápido para ver as etapas de instalação. - Implantação de um modelo Azure OpenAI em seu projeto Foundry.
Nota
A Pesquisa na Web não requer funções extras além do acesso ao projeto do Foundry. A integração com a Pesquisa do Bing e a integração com a Pesquisa Personalizada do Bing requerem a função de Contributor ou Owner para criar recursos do Bing, e a função de Gerente de Projetos de IA do Azure para criar conexões de projetos. Para obter detalhes, consulte a configuração do ambiente do agente.
Importante
Pesquisa na Web, Fundamento com a Pesquisa do Bing e o Fundamento com a Pesquisa Personalizada do Bing são Serviços de Consumo Internos com termos para serviços online. Eles são regidos pelo Grounding com os termos de uso do Bing e a Política de Privacidade Microsoft.
O Microsoft Data Protection Addendum não se aplica aos dados enviados para Grounding with Bing Search ou Grounding with Bing Custom Search. Quando você usa esses serviços, seus dados fluem fora da conformidade Azure e do limite geográfico. Isso também significa que o uso desses serviços renuncia a todos os compromissos elevados de conformidade e segurança de nuvem da comunidade governamental, incluindo soberania de dados e suporte baseado em cidadania e triagem, conforme aplicável.
Nota
O uso do recurso de Grounding com o Bing Search e o Grounding com o Bing Custom Search incorre em custos. Confira os detalhes de preços. Azure administradores podem restringir o acesso a essas ferramentas. Para obter detalhes, consulte o controle administrador para a ferramenta de Pesquisa na Web.
Determinar a melhor ferramenta para seus casos de uso
Se você estiver apenas começando, use a Pesquisa na Web. Ele não requer recursos adicionais do Azure e é a maneira mais simples de adicionar a integração web ao seu agente.
Se você estiver migrando do Aterramento com a Pesquisa do Bing na plataforma de agentes clássicos, a Pesquisa na Web e o Aterramento com Pesquisa do Bing serão opções de GA na nova API de agentes. A Pesquisa na Web não requer nenhum recurso separado do Bing. A Integração com a Pesquisa do Bing oferece mais parâmetros e dá suporte a modelos não OpenAI implantados diretamente no Azure.
Os casos de uso a seguir ajudam você a comparar as ferramentas disponíveis. O caso de uso 1 abrange a pesquisa geral na Web, em que a Pesquisa na Web e a Fundamentação com a Pesquisa Bing podem recuperar resultados da Web pública. O caso de uso 2 abrange a pesquisa restrita a domínios, que tem suporte somente da Fundamentação com a Pesquisa Personalizada do Bing.
Caso de uso 1: fundamentação a partir da web geral indexada pelo Bing
| Pesquisa na Web (recomendado) | Integração com a Pesquisa do Bing | |
|---|---|---|
| Etapa | GA | GA |
| Ancoragem com o recurso do Bing | Gerenciado por Microsoft | Gerenciado por você – requer a criação prévia de um recurso de Vinculação com a Pesquisa do Bing |
| Parâmetros com suporte |
-
user_location: fornece resultados geográficos relevantes- search_context_size: baixo/médio/alto (padrão: médio)Saiba mais sobre parâmetros de Pesquisa na Web |
-
count: o máximo de resultados retornados pelo Bing - freshness: especifica o período para os resultados da pesquisa- market: especifica a região para os resultados da pesquisa - set_lang: especifica o idioma para os resultados da pesquisa Saiba mais sobre os parâmetros da Pesquisa do Bing |
| Limite de dados | Fluxos de dados fora do limite de conformidade Azure | Fluxos de dados fora do limite de conformidade Azure |
| Modelos com suporte | modelos do Azure OpenAI | Modelos OpenAI do Azure e modelos diretos do Azure (modelos não OpenAI implantados diretamente no Azure) |
Caso de uso 2: ancoragem de domínios específicos que você definiu
| Pesquisa na Web (recomendado) | Integração com a Pesquisa Personalizada do Bing | |
|---|---|---|
| Etapa | GA (requer uma instância de Pesquisa Personalizada do Bing) | Visualizar |
| Restringir a domínios personalizados | Com suporte – use custom_search_configuration para pré-definir domínios permitidos ou bloqueados (requer a criação de um recurso de Pesquisa Personalizada do Bing + instância) |
Com suporte – use custom_search_configuration para pré-definir domínios permitidos ou bloqueados (requer a criação de um recurso de Pesquisa Personalizada do Bing + instância) |
| Outros parâmetros |
-
user_location: fornece resultados geográficos relevantes- search_context_size: baixo/médio/alto (padrão: médio)Saiba mais sobre parâmetros de Pesquisa na Web |
-
count: o número máximo de resultados retornados pelo Bing - freshness: especifica o período para os resultados da pesquisa- market: especifica a região para os resultados da pesquisa - set_lang: especifica o idioma para os resultados da pesquisa Saiba mais sobre os parâmetros de Pesquisa Personalizada do Bing |
| Modelos com suporte | modelos do Azure OpenAI | Azure OpenAI modelos e Azure modelos diretos |
Perguntas comuns
Qual ferramenta devo usar se estou apenas começando?
Use a Pesquisa na Web. Ele não requer recursos de Azure adicionais, manipula automaticamente o gerenciamento de recursos do Bing e fornece resultados geográficos relevantes com o parâmetro user_location.
Posso usar ferramentas de fundamentação web com projetos Foundry protegidos por rede?
As ferramentas de fundamentação da web não respeitam VPNs ou pontos de extremidade privados. Eles atuam como pontos de extremidade públicos. Considere esta implicação de segurança ao usar o Foundry com segurança de rede com essas ferramentas.
Como restringir os resultados da pesquisa a sites específicos?
Use a Pesquisa na Web. Essa ferramenta permite que você defina uma lista de permissões ou uma lista de blocos de domínios, portanto, os resultados da pesquisa vêm apenas das fontes aprovadas.
Há custos adicionais para fundamentação da rede?
Sim. Pesquisa na Web, integração com Pesquisa do Bing e integração com Pesquisa Personalizada do Bing (pré-visualização) incorrem em custos além do uso padrão do Azure OpenAI. Confira os detalhes de preços.
Solucionando problemas
| Questão | Causa provável | Resolução |
|---|---|---|
| O agente não usa aterramento da web | A ferramenta não configurada ou o modelo não dá suporte à ferramenta. | Verifique se a ferramenta foi adicionada à definição do agente. Use tool_choice="required" para forçar o uso da ferramenta. Verifique se a implantação do modelo dá suporte à ferramenta. |
| Nenhuma citação em resposta | O modelo gerou uma resposta sem usar os resultados da pesquisa. | Adicione instruções explícitas para sempre citar fontes. Use tool_choice="required" para garantir a invocação da ferramenta. |
| Os resultados da pesquisa não são relevantes | A formulação de consulta não capturou a intenção do usuário. | Melhore as instruções do agente para orientar a construção da consulta. Para ferramentas do Bing, ajuste market e set_lang parâmetros. |
| Ferramenta bloqueada pelo administrador | Sua organização desativou as ferramentas de fundamentação da web. | Entre em contato com o administrador do Azure para habilitar o acesso. Consulte o controle de administrador. |
| Custos inesperados | As ferramentas de fundamentação da web têm preços baseados no uso. | Examine os detalhes de preços e implemente a limitação de taxa, se necessário. |