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

Note

Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.

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 Foundry IQ.

In diesem Tutorial lernen Sie:

  • Bereitstellen von Foundry IQ und automatisches Seeden eines Indexes mit der Azure Developer CLI.
  • 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.

Screenshot der Beispiel-App mit Suchergebnissen für Hund mit Autor- und Sprachfacetten und Paginierungssteuerelementen.

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 Steuerelemente für die Seitennavigation 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 Foundry IQ-API mit dem .NET SDK aufruft. /azure-search-static-web-app/api
bulk-insert .NET Projekt, das den Index erstellt und Dokumente lädt. Das azd Deployment wird automatisch über den postprovision-Hook ausgeführt. /azure-search-static-web-app/bulk-insert
infra Bicep Infrastruktur, die zum Bereitstellen von azd Foundry IQ, 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 Foundry IQ, sodass Sie sie nicht vorher erstellen müssen.

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 von einem lokalen Klon aus 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