Ligação à Terra com Bing Search (clássico)

Nota

Este documento refere-se aos agentes Microsoft Foundry (clássico).

• Recomendamos aos clientes que comecem com uma nova ferramenta de Pesquisa Web com a API do agente. Se pretender compreender a diferença entre a ferramenta de Pesquisa Web e o Grounding com a ferramenta Bing Search, pode obter mais informações aqui

🔍 Consulte a nova documentação do Grounding with Bing Search. Os Agentes (clássicos) estão agora obsoletos e serão descontinuados a 31 de março de 2027. Use os novos agentes no Serviço de Agentes Foundry da Microsoft, disponível para o público em geral. Siga o guia de migração para atualizar as suas cargas de trabalho.

Grounding com Bing Search permite que os seus Azure AI Agents incorporem dados públicos da web em tempo real ao gerar respostas. Precisas de criar um recurso de Pesquisa Grounding com o Bing e depois ligar esse recurso aos teus Agentes de IA do Azure. Quando um utilizador envia uma consulta, os Agentes de IA do Azure decidem se o Grounding com Bing Search deve ser usado ou não. Se sim, usa o Bing para pesquisar dados públicos da web e devolver os blocos relevantes. Por fim, os agentes de inteligência artificial do Azure utilizarão fragmentos devolvidos para produzir uma resposta.

Pode fazer perguntas como "qual é a principal notícia atualmente" ou "qual é a atualização recente na indústria do retalho nos EUA?", que exigem dados públicos em tempo real.

Desenvolvedores e utilizadores finais não têm acesso ao conteúdo bruto devolvido pelo Grounding com o Bing Search. A resposta modelo, no entanto, inclui citações com ligações para os sites usados para gerar a resposta, e um link para a consulta Bing usada na pesquisa. Pode obter a resposta do modelo acedendo aos dados do thread que foi criado. Estas duas referências devem ser mantidas e exibidas exatamente na forma fornecida pela Microsoft, conforme os Requisitos de Utilização e Exibição do Grounding with Bing Search. Consulte a secção sobre como apresentar o Grounding nos resultados de pesquisa do Bing para mais detalhes.

Importante

1. A sua utilização do Grounding com o Bing Search pode gerar custos. Consulte a página de preços para mais detalhes.
2. Apenas subscrições pagas e subscrições do tipo "pay-as-you-go" do Azure são elegíveis para integração com Bing Search. Subscrições patrocinadas ou baseadas em créditos gratuitos não são elegíveis para implementar o Grounding com o Bing Search.
3. Ao criar e usar um recurso de Integração com Bing Search através de uma abordagem code-first, como usando CLI do Azure, ou ao implementar através de um modelo de implementação, concorda em estar vinculado e cumprir os termos disponíveis em https://www.microsoft.com/en-us/bing/apis/grounding-legal, que podem ser atualizados periodicamente.
4. Quando utiliza o Grounding com o Bing Search, os dados do seu cliente são transferidos para fora do limite de conformidade do Azure para o serviço Grounding with Bing Search. O grounding com Bing Search não está sujeito aos mesmos termos de processamento de dados (incluindo localização do processamento) e não tem os mesmos padrões de conformidade e certificações que o Foundry Agent Service, conforme descrito nos Termos de Utilização do Grounding with Bing Search. É sua responsabilidade avaliar se a utilização do Grounding com Bing Search no seu agente corresponde às suas necessidades e requisitos.

Como funciona o Grounding com a Pesquisa do Bing

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

Quando um utilizador envia uma consulta, a implementação do modelo de IA do cliente processa-a primeiro (usando as instruções fornecidas) para depois realizar uma consulta de pesquisa Bing ( que é visível para os programadores). A ancoragem com o Bing retorna resultados de pesquisa relevantes para a implementação do modelo do cliente, para gerar o resultado final.

Nota

Ao usar o Grounding com o Bing Search, apenas a consulta de pesquisa do Bing, os parâmetros da ferramenta e a sua chave de recursos são enviados para o Bing, sem qualquer informação específica do utilizador final. A tua chave de recursos é enviada para o Bing apenas para fins de faturação e limitação de taxas.

A autorização ocorrerá entre o serviço Grounding do Bing Search e o serviço Agente. Qualquer consulta de pesquisa Bing gerada e enviada para Bing para efeitos de grounding é transferida, juntamente com a chave de recursos, para fora do limite de conformidade do Azure para o serviço de pesquisa Grounding with Bing. O grounding com a Pesquisa Bing está sujeito aos Termos de Utilização da Pesquisa Bing e não possui os mesmos padrões de conformidade e certificações que o Serviço de Agente, conforme descrito nos Termos de Utilização da Pesquisa Bing. É sua responsabilidade avaliar se a utilização do Grounding com Bing Search no seu agente corresponde às suas necessidades e requisitos.

As transações com o recurso Grounding com Bing são contabilizadas pelo número de vezes que a ferramenta é chamada por execução. Pode ver quantas chamadas de ferramenta são feitas a partir da etapa de execução.

Capacidades suportadas e problemas conhecidos

• Grounding, na ferramenta de pesquisa Bing, foi concebido para recuperar informações em tempo real da web, não de domínios específicos.
• NÃO é recomendado resumir uma página web inteira.
• Numa única execução, o modelo de IA avaliará os resultados da ferramenta e poderá decidir invocar novamente a ferramenta para obter mais informações e contexto. O modelo de IA pode também decidir quais as saídas da ferramenta que são usadas para gerar a resposta.
• O serviço Azure AI Agent devolverá a resposta gerada por modelo de IA como saída, afetando assim a latência de ponta a ponta no pré/pós-processamento dos LLMs.
• O grounding com a ferramenta Bing Search NÃO devolve a saída da ferramenta aos programadores e utilizadores finais.
• A integração com o Bing Search só funciona com agentes que não usam VPN ou endpoints privados. O agente deve ter acesso normal à rede.

Suporte de utilização

Suporte para a fundição de IA do Azure	Python SDK	C# SDK	JavaScript SDK	SDK de Java	API REST	Configuração básica do agente	Configuração padrão do agente
✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️

Configuração

Nota

1. O grounding com o Bing Search funciona com todos os modelos Azure OpenAI que o Agent Service suporta, exceto os modelos gpt-4o-mini, 2024-07-18 e gpt-5.

1. Crie um Agente de IA Azure seguindo os passos do quickstart.

2. Crie um recurso de pesquisa associado ao Grounding com o Bing. Precisa de ter o papel de Proprietário ou Contribuidor na sua subscrição ou grupo de recursos para o criar.

   1. Podes criar um no portal Azure, e selecionar os diferentes campos no formulário de criação. Certifica-te de que crias este recurso Grounding with Bing Search no mesmo grupo de recursos que o teu Azure AI Agent, AI Project e outros recursos.

      

   2. Também pode criar um através da abordagem 'code-first'. Caso afirmativo, precisa de registar manualmente o Bing Search como fornecedor de recursos do Azure. Deve ter permissão para realizar a operação /register/action para o fornecedor de recursos. A permissão está incluída nos papéis de Contribuinte e Proprietário .

       az provider register --namespace 'Microsoft.Bing'
   

3. Depois de criares um recurso de Pesquisa de Grounding com o Bing, podes encontrá-lo no portal Azure. Navega até ao grupo de recursos onde criaste o recurso, procura o recurso de pesquisa Grounding with Bing que criaste.

   

Parâmetros opcionais

Quando adiciona a ferramenta Grounding with Bing Search ao seu agente, pode passar os seguintes parâmetros. Estes parâmetros vão impactar a saída da ferramenta Grounding with Bing Search, e o modelo de IA pode não utilizar totalmente todas as saídas. Consulte os exemplos de código para informações sobre o suporte a versões da API e como passar estes parâmetros.

Nome	Valor	Tipo	Obrigatório
count	O número de resultados de pesquisa a devolver na resposta. O valor padrão é 5 e o valor máximo é 50. O número real entregue pode ser inferior ao solicitado. É possível que várias páginas incluam alguma sobreposição nos resultados. Este parâmetro afeta apenas os resultados das páginas web. É possível que o modelo de IA não utilize todos os resultados de pesquisa devolvidos pelo Bing.	UnsignedShort	Não
freshness	Filtrar os resultados da pesquisa pelos seguintes valores de idade que não diferenciam entre maiúsculas e minúsculas. Dia: Devolver páginas que o Bing descobriu nas últimas 24 horas. Semana: Retorne páginas que o Bing descobriu nos últimos 7 dias. Mês: Devolve páginas que o Bing descobriu nos últimos 30 dias. Para obter artigos descobertos pelo Bing num período de tempo específico, especifique um intervalo de datas na forma: YYYY-MM-DD..YYYY-MM-DD. Por exemplo, freshness=2019-02-01..2019-05-30. Para limitar os resultados a uma única data, defina este parâmetro para uma data específica. Por exemplo, freshness=2019-02-04.	Corda	Não
market	O mercado de onde vêm os resultados. Normalmente, mkt é o país/região de onde o utilizador está a fazer o pedido. No entanto, pode ser um país/região diferente se o utilizador não estiver localizado num país/região onde o Bing produz resultados. O mercado deve estar na forma: <language>-<country/region>. Por exemplo, en-US. A cadeia de caracteres não diferencia maiúsculas de minúsculas. Para uma lista de possíveis valores de mercado, consulte Códigos de mercado. Se souber, é incentivado a especificar sempre o mercado. Especificar o mercado ajuda o Bing a encaminhar o pedido e a devolver uma resposta adequada e ótima. Se especificar um mercado que não está listado nos códigos de mercado, o Bing utiliza um código de mercado mais adequado baseado num mapeamento interno sujeito a alterações.	Corda	Não
set_lang	A linguagem a usar para os textos da interface do utilizador. Pode especificar a linguagem usando um código de 2 ou 4 letras. O uso de códigos de 4 letras é preferível. Para uma lista de códigos de línguas suportadas, veja linguagens suportadas pelo Bing. O Bing carrega as cadeias localizadas se setlang contiver um código de cultura neutro válido de 2 letras (fr) ou um código de cultura específico válido de 4 letras (fr-ca). Por exemplo, para fr-ca, Bing carrega as fr cadeias de código de cultura neutra. Se setlang não for válido (por exemplo, zh) ou o Bing não suportar o idioma (por exemplo, af, af-na), o Bing assume por predefinição en (inglês). Para especificar o código de 2 letras, defina este parâmetro para um código de linguagem ISO 639-1. Para especificar o código de 4 letras, use o formulário <language>-<country/region> onde <language> é um código de língua ISO 639-1 (cultura neutra) e <country/region> é um código de país/região ISO 3166 (cultura específica). Por exemplo, use en-US para inglês dos Estados Unidos. Embora opcional, deve sempre especificar a língua. Normalmente, define-se setLang para a mesma linguagem especificada por mkt , a menos que o utilizador queira que as strings da interface de utilizador sejam exibidas noutra língua.	Corda	Não

Como apresentar o Grounding com os resultados de pesquisa do Bing

De acordo com os termos de uso e requisitos de utilização e exibição do Grounding with Bing, precisa de mostrar tanto os URLs do site como os URLs das consultas de pesquisa do Bing na sua interface personalizada. Pode encontrar URLs de sites por meio do annotations parâmetro na resposta da API e URLs de consulta de pesquisa do Bing por meio do runstep detalhe. Para renderizar a página web, recomendamos que substitua o endpoint nos URLs de pesquisa do Bing por www.bing.com, e o URL da sua consulta de pesquisa do Bing será exibido como "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óximos passos

Veja exemplos de código para usar a ferramenta Grounding with Bing de forma programática.