Utiliser un index AI Search existant avec l'outil Azure AI Search

Utiliser un index Azure AI Search existant avec l'outil Azure AI Search de l’agent.

Remarque

Les index Azure AI Search doivent respecter les critères suivants :

• L'index doit contenir au moins un champ de texte consultable et récupérable (type Edm.String)
• L'index doit contenir au moins un champ vectoriel consultable (type Collection(Edm.Single))
• L’index est supposé être configuré correctement

Types de recherche

Vous pouvez spécifier le type de recherche de votre index en choisissant l’un des éléments suivants :

• Simple
• Sémantique
• Vecteur
• Hybride (vector + mot clé)
• Hybride (Vector + Keyword + Semantic)

Index sans type de recherche spécifié

• Par défaut, l’outil Recherche d’IA Azure exécute une recherche hybride (mot clé + vecteur) sur tous les champs de texte

Assistance à l'utilisation

Prise en charge d’Azure AI Foundry	Kit de développement logiciel (SDK) Python	Kit de développement logiciel (SDK) C#	Kit de développement logiciel (SDK) JavaScript	API REST	Configuration d’agent de base	Configuration d’agent standard
✔️	✔️	✔️	✔️	✔️	✔️	✔️

Configuration

Prérequis : disposer d'un index Azure AI Search existant

Pour utiliser l'outil Azure AI Search, il faut disposer d'un index Azure AI Search existant. Si vous n'avez pas d'index existant, vous pouvez en créer un dans le Portail Microsoft Azure à l'aide de l'assistant d'importation et de vectorisation des données.

• Démarrage rapide : créer un index vectoriel avec l'assistant d'importation et de vectorisation des données dans le Portail Microsoft Azure

Créez une connexion de projet à la ressource Azure AI Search avec l'index que vous souhaitez utiliser

Une fois la configuration de l'agent terminée, vous devez créer une connexion de projet à la ressource Azure AI Search qui contient l'index que vous souhaitez utiliser.

Si vous avez déjà connecté à votre projet la ressource AI Search qui contient l'index que vous souhaitez utiliser, ignorez cette étape.

Obtenez votre clé de connexion à la ressource Azure AI Search et votre point de terminaison

1. Accédez à votre ressource Recherche Azure AI.

   • Dans le Portail Microsoft Azure, accédez à la ressource AI Search qui contient l’index à utiliser.

2. Copiez le point de terminaison de connexion.

   • Dans l'onglet Aperçu, copiez l'URL de votre ressource. L’URL doit être au format https://<your-resource-name>.search.windows.net/.

3. Vérifiez que le contrôle d'accès à l'API est défini sur Les deux et copiez l'une des clés sous Gérer les clés d'administration.

   • Dans la barre de navigation de gauche, descendez jusqu'à la section Paramètres et sélectionnez Clés.
   • Dans la section Contrôle d'accès à l'API, assurez-vous que l'option Les deux pour Contrôle d'accès basé sur la clé API et sur le rôle est sélectionnée.
   • Si vous souhaitez que la connexion utilise des clés API pour l'authentification, copiez l'une des clés sous Gérer les clés d’administration.

Créer une connexion de projet avec Azure AI Search

Si vous utilisez Microsoft Entra ID pour le type d'authentification de la connexion, vous devez attribuer manuellement à l'identité gérée par le projet les rôles Search Index Data Contributor et Search Service Contributor à la ressource Azure AI Search. Le nom de connexion doit être le nom de l’index de recherche IA.

Azure CLI

Créez le fichier connections.yml suivant

Vous pouvez utiliser une clé API ou un fichier de configuration YAML sans informations d’identification. Remplacez les caractères de remplacement pour name, endpoint et api_key par les valeurs de votre ressource Azure AI Search. Pour plus d’informations sur le fichier de configuration YAML, consultez le Schéma YAML des connexions Azure AI Search.

• Exemple de clé API :

  name: my_project_acs_connection_keys
  type: azure_ai_search
  endpoint: https://contoso.search.windows.net/
  api_key: XXXXXXXXXXXXXXX
  

• Sans information d’identification

  name: my_project_acs_connection_credentialless
  type: azure_ai_search
  endpoint: https://contoso.search.windows.net/
  

Exécutez ensuite la commande suivante :

Remplacez my_resource et my_project_name par votre groupe de ressources et votre nom de projet créés dans la configuration de l'agent.

az ml connection create --file {connection.yml} --resource-group {my_resource_group} --workspace-name {my_project_name}

Python

Remplacez les espaces réservés my_connection_name, my_endpoint et my_key (facultatif) par les détails de votre connexion Azure AI Search et exécutez le code suivant pour créer une connexion de projet à votre ressource Azure AI Search.

from azure.ai.ml.entities import AzureAISearchConnection

# create an Azure AI Search project connection
my_connection_name = "my-connection-name"
my_endpoint = "my-endpoint" # this could also be called target
my_api_keys = None # leave blank for Authentication type = AAD

my_connection = AzureAISearchConnection(name=my_connection_name,
                                    endpoint=my_endpoint, 
                                    api_key= my_api_keys)

# Create the connection
ml_client.connections.create_or_update(my_connection)

Azure AI Foundry

1. Dans Azure AI Foundry, accédez au projet que vous avez créé dans la configuration de l'agent. Cliquez sur Ouvrir dans le centre de gestion.

2. Cliquez sur l'onglet Connexions et sélectionnez Ajouter une connexion.

3. Sélectionnez Recherche Azure AI.

4. Fournissez les détails de connexion requis pour la ressource Azure AI Search que vous souhaitez utiliser. L'authentification par identité gérée et l'authentification par clé sont toutes deux prises en charge. Une fois tous les champs remplis, cliquez sur Ajouter une connexion.

5. Vérifiez que la connexion a été créée avec succès et qu'elle apparaît désormais dans l'onglet Connexions du projet.

Maintenant que vous avez créé une connexion de projet à votre ressource Azure AI Search, vous pouvez configurer et commencer à utiliser l'outil Azure AI Search avec le SDK. Voir l'onglet des exemples de code pour commencer.

---

Ajouter l’outil Recherche Azure AI à un agent

Vous pouvez ajouter l’outil Recherche d’IA Azure à un agent par programmation à l’aide des exemples de code répertoriés en haut de cet article ou du portail Azure AI Foundry. Si vous souhaitez utiliser le portail :

1. Dans l’écran Agents de votre agent, faites défiler le volet Configuration à droite jusqu’à connaissances. Ensuite, cliquez sur Ajouter.

   

2. Sélectionnez Recherche Azure AI et suivez les invites pour ajouter l’outil.

   

Étapes suivantes

• Consultez des exemples sur l’utilisation de l’outil Recherche d’IA Azure.