Tutoriel : Ajouter Recherche Azure AI à une application web C# sur Azure Container Apps

Note

Recherche Azure AI est disponible via le portail Azure, les API REST et les SDK Azure. Il sous-tend également Foundry IQ, la couche de connaissances managée qui transforme le contenu d’entreprise en bases de connaissances réutilisables et prenant en charge les autorisations pour les agents dans le portail Microsoft Foundry.

Ce didacticiel crée un site web qui effectue des recherches dans un catalogue de livres et déploie le site web sur Azure Container Apps. Le déploiement utilise l’interface CLI Azure développeur (azd) et l’identité managée comme méthode d’authentification par défaut pour Recherche Azure AI.

Dans ce tutoriel, vous allez :

• Déployez Recherche Azure AI et amorçage automatiquement un index avec l’interface CLI du développeur Azure.
• Intégrez des requêtes de recherche, des suggestions, des facettes, une pagination et une recherche de document dans l’application C#.
• Déployez l’application sur Azure Container Apps avec une identité managée comme méthode d’authentification par défaut.

Que fait l’exemple ?

Cet exemple de site web permet d’accéder à un catalogue de 10 000 livres. Vous pouvez effectuer une recherche dans le catalogue en entrant du texte dans la barre de recherche. Pendant que vous entrez du texte, le site web utilise la fonctionnalité de suggestion de l’index de recherche pour l’autocomplétion du texte.

Une fois la requête terminée, le site web affiche la liste des livres avec une partie de leurs détails. Vous pouvez sélectionner un livre pour afficher ses détails complets, qui sont stockés dans l’index de recherche.

L’expérience de recherche comprend les éléments suivants :

• Recherche : fournit des fonctionnalités de recherche pour l’application.
• Suggérer : fournit des suggestions en tant que types d’utilisateurs dans la barre de recherche.
• Facettes et filtres : fournit une structure de navigation à facettes qui filtre par auteur ou langage.
• Résultats paginés : fournit des contrôles de pagination pour le défilement des résultats.
• Recherche de document : recherche un document par ID pour récupérer tout son contenu pour la page de détails.

Comment l’exemple est-il organisé ?

Cet exemple de code comprend les composants suivants :

Application	Objectif	emplacement du référentiel GitHub
client	Application React (couche de présentation) pour afficher des livres avec recherche. Il appelle l’API.	/azure-search-static-web-app/client
api	API Azure Functions C# (couche métier), hébergée dans un conteneur sur Azure Container Apps, qui appelle l’API Recherche Azure AI avec le KIT de développement logiciel (SDK) .NET.	/azure-search-static-web-app/api
bulk-insert	.NET projet qui crée l’index et charge les documents. Le azd déploiement s’exécute automatiquement via le postprovision hook.	/azure-search-static-web-app/bulk-insert
infra	Bicep infrastructure utilisée par azd le déploiement de Recherche Azure AI, de Azure Container Apps et de ressources de prise en charge.	Azure-Samples/azure-search-static-web-app

Configurer l''environnement de développement

Installez le logiciel suivant pour votre environnement de développement local. La azd up commande provisionne toutes les ressources Azure, y compris Recherche Azure AI, de sorte que vous n'avez pas besoin de les créer au préalable.

• .NET 9 ou version ultérieure
• Git
• Visual Studio Code
• Extension C# Dev Tools pour Visual Studio Code
• Azure Developer CLI (azd)
• Docker Desktop ou un autre runtime de conteneur compatible Docker

Ce didacticiel n'exécute pas l'API Azure Functions localement. Si vous souhaitez l’exécuter localement, installez Azure Functions Core Tools.

Cloner l’exemple de recherche avec Git

Vous pouvez déployer l’exemple à partir d’un clone local. La azd up commande lit les fichiers d’application et d’infrastructure à partir de votre référentiel local, génère les conteneurs, provisionne Azure ressources et déploie le client et l’API sur Azure Container Apps.

1. Dans un terminal Bash, clonez l’exemple d’application sur votre ordinateur local.

   git clone https://github.com/Azure-Samples/azure-search-static-web-app.git
   

2. Dans le même terminal Bash, accédez au répertoire du référentiel pour cet exemple de recherche.

   cd azure-search-static-web-app
   

3. Utilisez la commande Visual Studio Code, code .pour ouvrir le référentiel. Sauf indication contraire, vous effectuez les tâches restantes dans Visual Studio Code.

   code .
   

Étape suivante

Déployer l’application vers Azure Container Apps