Aterramento com a Pesquisa do Bing (clássico)

Aterramento com a Pesquisa do Bing permite que seus Agentes de IA do Azure incorporem dados da Web públicos em tempo real ao gerar respostas. Você precisa criar um recurso de Integração com o Bing Search e, em seguida, conectar esse recurso aos seus agentes de IA do Azure. Quando um usuário envia uma consulta, os agentes de IA do Azure decidem se a conexão com a Pesquisa do Bing deve ser usada ou não. Nesse caso, ele usa o Bing para pesquisar dados públicos da Web e retornar partes relevantes. Por fim, os Agentes de IA do Azure usarão blocos retornados para gerar uma resposta.

Você pode fazer perguntas como "quais são as principais notícias de hoje" ou "qual é a atualização recente no setor de varejo nos EUA?", que exigem dados públicos em tempo real.

Desenvolvedores e usuários finais não têm acesso ao conteúdo bruto retornado do Fundamento com Pesquisa do Bing. A resposta do modelo, no entanto, inclui citações com links para os sites usados para gerar a resposta e um link para a consulta do Bing usada para a pesquisa. Você pode recuperar a resposta do modelo acessando os dados no thread que foi criado. Essas duas referências devem ser mantidas e exibidas exatamente na forma fornecida pela Microsoft, conforme os Requisitos de Uso e Exibição do Fundamento com Pesquisa do Bing. Consulte a seção como exibir resultados do Fundamento com Pesquisa do Bing para obter detalhes.

Como funciona o Grounding com a Pesquisa Bing

A consulta do usuário é a mensagem que um usuário final envia a um agente, como "devo levar um guarda-chuva comigo hoje? Estou em Seattle." Instruções são as mensagens do sistema que um desenvolvedor pode fornecer para compartilhar contexto e fornecer instruções ao modelo de IA sobre como usar várias ferramentas ou se comportar.

Quando um usuário envia uma consulta, a implantação do modelo de IA do cliente primeiro a processa (usando as instruções fornecidas) para depois executar uma consulta de pesquisa do Bing (que é visível para os desenvolvedores). A integração com o Bing retorna resultados de pesquisa relevantes para o modelo implementado pelo cliente, que então gera o resultado final.

A autorização ocorrerá entre o Grounding, o serviço de Pesquisa do Bing e o Serviço de Agente. Qualquer consulta de pesquisa do Bing gerada e enviada ao Bing para fins de fundamentação é transferida, juntamente com a chave de recurso, para fora do limite de conformidade do Azure para o serviço de Fundamentação com a Pesquisa do Bing. O fundamento com a Pesquisa do Bing está sujeito aos termos do Bing e não tem os mesmos padrões de conformidade e certificações que o Serviço de Agente, conforme descrito nos Termos de Uso do Fundamento com a Pesquisa Bing. É sua responsabilidade avaliar se o uso do Fundamento com o Pesquisa do Bing no seu agente atende às suas necessidades e requisitos.

As transações com o recurso Fundamento com Bing são contadas pelo número de chamadas de ferramenta por execução. Você pode ver quantas chamadas de ferramenta são feitas a partir da etapa de execução.

Recursos com suporte e problemas conhecidos

• A integração com a ferramenta de pesquisa do Bing foi projetada para recuperar informações em tempo real da Internet, NÃO de domínios específicos da Internet.
• NÃO é recomendável resumir uma página da Web inteira.
• Em uma execução, o modelo de IA avaliará as saídas da ferramenta e poderá decidir invocar a ferramenta novamente para obter mais informações e contexto. O modelo de IA também pode decidir quais partes das saídas da ferramenta são usadas para gerar a resposta.
• O serviço Agente de IA do Azure retornará resposta gerada pelo modelo de IA como saída para que a latência completa seja afetada pelo pré/pós-processamento de LLMs.
• O fundamento com a ferramenta Pesquisa do Bing NÃO retorna a saída da ferramenta para desenvolvedores e usuários finais.
• A integração com a Pesquisa do Bing funciona apenas com agentes que não estão usando VPN ou pontos de extremidade privados. O agente deve ter acesso normal à rede.

Suporte de uso

Configuração

1. Crie um agente de IA Azure seguindo as etapas no quickstart.

2. Crie um recurso de Fundamento com a Pesquisa do Bing. Você precisa ter a função Proprietário ou Colaborador em sua assinatura ou grupo de recursos para criá-la.

   1. Você pode criar um no portal Azure e selecionar os diferentes campos no formulário de criação. Crie esse recurso de aterramento com a Pesquisa do Bing no mesmo grupo de recursos que o Agente de IA do Azure, o Projeto de IA e outros recursos.

      

   2. Você também pode criar um por meio da experiência orientada por código. Nesse caso, você precisa registrar a Pesquisa do Bing manualmente como um provedor de recursos do Azure. Você precisa ter permissão para realizar a operação /register/action para o provedor de recursos. A permissão está incluída nas funções de Colaborador e Proprietário.

       az provider register --namespace 'Microsoft.Bing'
   

3. Depois de criar um recurso aterramento com a Pesquisa do Bing, você poderá encontrá-lo no portal do Azure. Navegue até o grupo de recursos no qual você criou o recurso, pesquise o recurso Fundamento com Pesquisa do Bing que você criou.

   Uma captura de tela do recurso do Bing no portal do Azure.

Parâmetros opcionais

Ao adicionar a ferramenta Fundamento com a Pesquisa do Bing ao agente, você pode passar os parâmetros a seguir. Esses parâmetros afetarão o Fundamento com a saída da ferramenta Pesquisa do Bing e o modelo de IA pode não usar totalmente todas as saídas. Consulte os exemplos de código para obter informações sobre o suporte à versão da API e como passar esses parâmetros.

Como exibir o aterramento com os resultados da Pesquisa do Bing

De acordo com o Aterramento com os termos de uso e usar e exibir os requisitos do Bing, você precisa exibir URLs do site e URLs de consulta de pesquisa do Bing em sua interface personalizada. Você pode encontrar URLs de sites por meio do parâmetro annotations na resposta da API e URLs de consulta de pesquisa do Bing por meio dos detalhes runstep. Para renderizar a página da Web, recomendamos que você substitua o endpoint das URLs de consulta de pesquisa do Bing por www.bing.com e sua URL de consulta de pesquisa do Bing ficaria assim: "https://www.bing.com/search?q={search query}".

run_steps = project_client.agents.runs_steps.list(run_id=run.id, thread_id=thread.id)
run_steps_data = run_steps['data']
print(f"Last run step detail: {run_steps_data}")

Próximas etapas

Consulte exemplos de código para usar programaticamente a ferramenta Grounding com Bing.