Como usar o Aterramento com a Pesquisa Personalizada do Bing (versão prévia)

2025-06-17

Navegue até a tela Agentes para seu agente no portal do Azure AI Foundry, role para baixo no painel de Configuração à direita até conhecimento. Em seguida, selecioneAdicionar.
Selecione a ferramenta Grounding with Bing Custom Search.
Selecione para criar uma nova conexão ou use uma conexão existente
1. Quanto à uma nova conexão, selecione o recurso Aterramento com a Pesquisa Personalizada do Bing.
Depois de se conectar a um recurso, selecione o nome da configuração.
Salve a ferramenta e comece a conversar com seu agente.

Importante

Essa API REST permite que os desenvolvedores invoquem o Aterramento com a ferramenta Pesquisa Personalizada do Bing pelo Serviço do Agente da Fábrica de IA do Azure. Ela não envia chamadas para o Aterramento com a API da Pesquisa Personalizada do Bing diretamente.
Os exemplos a seguir serão aplicáveis se você estiver usando o recurso do Azure AI Foundry Project com a ferramenta Microsoft Fabric por meio da chamada à API REST
Sua ID de conexão deve estar nesse formato: /subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-bing-connection-name>

Siga o Início Rápido da API REST para definir os valores certos para as variáveis AGENT_TOKENAZURE_AI_FOUNDRY_PROJECT_ENDPOINT de ambiente e API_VERSION.

Criar um agente com o Aterramento com a ferramenta Pesquisa Personalizada do Bing habilitada

Para disponibilizar a ferramenta "Grounding com Pesquisa Personalizada do Bing" para seu agente, utilize uma conexão para inicializar a ferramenta e anexá-la ao agente. Você pode encontrar sua conexão na seção de recursos conectados do seu projeto no portal do Azure AI Foundry.

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/assistants?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "instructions": "You are a helpful agent.",
        "name": "my-agent",
        "model": "gpt-4o",
        "tools": [
          {
            "type": "bing_custom_search",
            "bing_custom_search": {
                "search_configurations": [
                    {
                        "connection_id": /subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-bing-connection-name>,
                        "instance_name": <your_custom_search_configuration_name>, 
                        "count": 7,
                        "market": "en-US", 
                        "set_lang": "en",
                        "freshness": "day",
                    }
                ]
            }
          }
        ]
      }'

Criar um thread

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d ''

Adicionar uma pergunta do usuário ao thread

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/messages?api-version=api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
      "role": "user",
      "content": "<ask a question tailored towards your web domains>"
    }'

Criar uma execução e verificar a saída

Crie uma execução e observe que o modelo usa a ferramenta Aterramento com a Pesquisa Personalizada do Bing para fornecer uma resposta à pergunta do usuário.

curl --request POST \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/runs?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "asst_abc123",
  }'

Recuperar o status da execução

curl --request GET \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/runs/run_abc123?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN"

Recuperar a resposta do agente

curl --request GET \
  --url $AZURE_AI_FOUNDRY_PROJECT_ENDPOINT/threads/thread_abc123/messages?api-version=$API_VERSION \
  -H "Authorization: Bearer $AGENT_TOKEN"