Lernprogramm: Hinzufügen von Azure KI-Suche zu einer C#-Web-App auf Azure Container Apps

Note

Azure KI-Suche ist über das Azure Portal, REST-APIs und Azure SDKs verfügbar. Es unterstützt auch Foundry IQ, die verwaltete Wissensschicht, die Unternehmensinhalte in wiederverwendbare, berechtigungsfähige Wissensbasen für Agenten im Microsoft Foundry-Portal transformiert.

Dieses Lernprogramm erstellt eine Website, die einen Katalog von Büchern durchsucht und die Website für Azure Container Apps bereitstellt. Die Bereitstellung verwendet die Azure Developer CLI (azd) und die verwaltete Identität als Standardauthentifizierungsmethode für Azure KI-Suche.

In diesem Tutorial lernen Sie:

• Stellen Sie Azure KI-Suche und einen Index automatisch mit der Azure Developer CLI bereit.
• Integrieren Sie Suchabfragen, Vorschläge, Facets, Paginierung und Dokumentsuche in die C#-App.
• Stellen Sie die App für Azure Container Apps mit verwalteter Identität als Standardauthentifizierungsmethode bereit.

Wozu dient das Beispiel?

Diese Beispielwebsite bietet Zugriff auf einen Katalog mit 10.000 Büchern. Sie können den Katalog durchsuchen, indem Sie Text in die Suchleiste eingeben. Während Sie Text eingeben, verwendet die Website das Vorschlagfeature des Suchindexes zum AutoVervollständigen des Textes.

Nach Abschluss der Abfrage zeigt die Website die Liste der Bücher mit einem Teil ihrer Details an. Sie können ein Buch auswählen, um die vollständigen Details anzuzeigen, die im Suchindex gespeichert sind.

Die Suchfunktion umfasst Folgendes:

• Suche – Stellt Suchfunktionen für die Anwendung bereit.
• Vorschlag – Stellt Vorschläge bereit, während der Benutzer in die Suchleiste eingibt.
• Facets und Filter – Stellt eine facetierte Navigationsstruktur bereit, die nach Autor oder Sprache gefiltert wird.
• Paginierte Ergebnisse – Stellt Auslagerungssteuerelemente zum Scrollen durch Ergebnisse bereit.
• Dokumentsuche – Sucht ein Dokument anhand der ID, um den gesamten Inhalt für die Detailseite abzurufen.

Wie ist das Beispiel organisiert?

Der Beispielcode enthält die folgenden Komponenten:

App	Zweck	GitHub Repositoryspeicherort
client	React-App (Präsentationsebene) zum Anzeigen von Büchern mit Suche. Sie ruft die API auf.	/azure-search-static-web-app/client
api	C# Azure Functions-API (Geschäftsschicht), die in einem Container auf Azure Container Apps gehostet wird, der die Azure KI-Suche-API mit dem .NET SDK aufruft.	/azure-search-static-web-app/api
bulk-insert	.NET Projekt, das den Index erstellt und Dokumente lädt. Die azd Bereitstellung führt dies automatisch über den postprovision Hook aus.	/azure-search-static-web-app/bulk-insert
infra	Bicep Infrastruktur, die zum azd Bereitstellen von Azure KI-Suche, Azure Container Apps und unterstützenden Ressourcen verwendet wird.	Azure-Samples/azure-search-static-web-app

Einrichten der Entwicklungsumgebung

Installieren Sie die folgende Software für Ihre lokale Entwicklungsumgebung. Der azd up Befehl stellt alle Azure Ressourcen bereit, einschließlich Azure KI-Suche, sodass Sie sie nicht vorher erstellen müssen.

• .NET 9 oder höher
• Git-Client
• Visual Studio Code
• C# Dev Tools-Erweiterung für Visual Studio Code
• Azure Developer CLI (azd)
• Docker Desktop oder eine andere Docker-kompatible Containerlaufzeit

In diesem Lernprogramm wird die Azure Functions-API nicht lokal ausgeführt. Wenn Sie es lokal ausführen möchten, installieren Sie Azure Functions Core Tools.

Klonen des Suchbeispiels mit Git

Sie können das Beispiel aus einem lokalen Klon bereitstellen. Der azd up Befehl liest die Anwendungs- und Infrastrukturdateien aus Ihrem lokalen Repository, erstellt die Container, stellt Azure Ressourcen bereit und stellt den Client und die API für Azure Container Apps bereit.

1. Klonen Sie in einem Bash-Terminal die Beispielanwendung auf Ihren lokalen Computer.

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

2. Wechseln Sie im gleichen Bash-Terminal zum Repositoryverzeichnis für dieses Suchbeispiel.

   cd azure-search-static-web-app
   

3. Verwenden Sie den Befehl Visual Studio Code, code .um das Repository zu öffnen. Sofern nicht anders angegeben, führen Sie die verbleibenden Vorgänge in Visual Studio Code aus.

   code .
   

Nächster Schritt

Bereitstellen der App in Azure Container Apps