Come utilizzare il concetto di grounding con Ricerca personalizzata Bing (anteprima)

2025-06-16

Passare alla schermata Agenti per l'agente nel portale Azure AI Foundry, scorrere verso il basso nel riquadro Installazione a destra fino alla sezione conoscenza. Selezionare quindi Aggiungi.
Selezionare lo strumento Grounding con Bing Custom Search.
Selezionare questa opzione per creare una nuova connessione oppure usare una connessione esistente
1. Per una nuova connessione, selezionare la risorsa Di base con Ricerca personalizzata Bing.
Dopo aver stabilito la connessione a una risorsa, selezionare il nome della configurazione.
Salvare lo strumento e iniziare a chattare con l'agente.

Importante

Questa API REST consente agli sviluppatori di chiamare lo strumento Grounding con Ricerca personalizzata Bing tramite il servizio agente di Azure AI Foundry. Non invia chiamate al Grounding con l'API Ricerca personalizzata di Bing direttamente.
Gli esempi seguenti sono applicabili se si usa la risorsa del progetto Di Azure AI Foundry con lo strumento Microsoft Fabric tramite una chiamata API REST
L'ID connessione deve essere nel formato seguente: /subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-bing-connection-name>

Seguire la guida introduttiva all'API REST per impostare i valori corretti per le variabili AGENT_TOKENAZURE_AI_FOUNDRY_PROJECT_ENDPOINT di ambiente e API_VERSION.

Creare un agente con il grounding e lo strumento Ricerca personalizzata Bing abilitato

Per rendere disponibile lo strumento di Grounding con Bing Ricerca Personalizzata per il tuo agente, utilizza una connessione per inizializzare lo strumento e allegarlo all'agente. È possibile trovare la connessione nella sezione risorse connesse del progetto nel portale di 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",
                    }
                ]
            }
          }
        ]
      }'

Creare un 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 ''

Aggiungere una domanda utente al 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>"
    }'

Creare un'esecuzione e controllare l'output

Eseguire un'operazione e osservare che il modello utilizza lo strumento Grounding con Ricerca personalizzata Bing per fornire una risposta alla domanda dell'utente.

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",
  }'

Recuperare lo stato dell'esecuzione

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

Recuperare la risposta dell'agente

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