Comment utiliser Grounding avec Recherche personnalisée Bing (préversion)

1. Accédez à l’écran Agents de votre agent dans le portail Azure AI Foundry, faites défiler le volet Configuration à droite jusqu’à la connaissance. Ensuite, cliquez sur Ajouter.

   

2. Sélectionnez l’outil Grounding avec Recherche personnalisée Bing.

3. Sélectionner pour créer une connexion ou utiliser une connexion existante

   1. Pour une nouvelle connexion, sélectionnez votre base de données avec la ressource Recherche personnalisée Bing.

4. Une fois que vous êtes connecté à une ressource, sélectionnez le nom de la configuration.

5. Sauvegardez l’outil et commencez à converser avec votre agent.

Important

• Cette API REST permet aux développeurs d’appeler l’outil Ancrage avec Recherche personnalisée Bing via l’agent de service Azure AI Foundry. Elle n’envoie pas d’appels directement à l’API Grounding avec Recherche personnalisée Bing.
• Les exemples suivants s’appliquent si vous utilisez la ressource Azure AI Foundry Project avec l’outil Microsoft Fabric via l’appel d’API REST
• Votre ID de connexion doit être au format suivant : /subscriptions/<sub-id>/resourceGroups/<your-rg-name>/providers/Microsoft.CognitiveServices/accounts/<your-ai-services-name>/projects/<your-project-name>/connections/<your-bing-connection-name>

Suivez le guide de démarrage rapide de l’API REST pour définir les valeurs appropriées pour les variables AGENT_TOKENd’environnement et AZURE_AI_FOUNDRY_PROJECT_ENDPOINTAPI_VERSION.

Créer un agent avec l’outil Grounding avec l’outil Recherche personnalisée Bing activé

Pour rendre l’outil Grounding avec Recherche personnalisée Bing disponible pour votre agent, utilisez une connexion pour initialiser l’outil et l’attacher à l’agent. Vous trouverez votre connexion dans la section ressources connectées de votre projet dans le portail 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",
                    }
                ]
            }
          }
        ]
      }'

Créer 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 ''

Ajouter une question utilisateur au 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>"
    }'

Créer une exécution et vérifier la sortie

Créez une exécution et observez que le modèle utilise l’outil Grounding avec Recherche personnalisée Bing pour fournir une réponse à la question de l’utilisateur.

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

Récupérer l’état de l’exécution

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

Récupérer la réponse de l’agent

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