Bereitstellen einer C#-Foundry-IQ-App (Azure KI-Suche) in 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.

Stellen Sie die suchfähige Website mithilfe der Azure Developer CLI (azd) in Azure Container Apps bereit. Diese Bereitstellung umfasst den React-Client, die .NET-API, Foundry IQ, verwaltete Identität und unterstützende Azure-Ressourcen.

Die Bereitstellung verwendet verwaltete Identität als Standardauthentifizierungsmethode für Foundry IQ. Sie können sich für die schlüsselbasierte Authentifizierung anmelden, indem Sie sie vor der Bereitstellung festlegen USE_KEYLESS_AUTHfalse .

Anmelden bei Azure

  1. Öffnen Sie in Visual Studio Code ein Terminal im Repositorystamm, z. B. azure-search-static-web-app.

  2. Anmelden bei Azure mithilfe von azd.

    azd auth login
    
  3. Wenn Sie von Ihrem Browser dazu aufgefordert werden, schließen Sie den Anmeldeablauf mithilfe des Azure Kontos ab, das Sie für dieses Lernprogramm verwenden.

Erstellen Sie eine azd-Umgebung

  • Erstellen Sie eine azd Umgebung. Ersetzen Sie YOUR-ENVIRONMENT-NAME durch einen kurzen Namen, der diese Lernprogrammbereitstellung identifiziert.

    azd env new YOUR-ENVIRONMENT-NAME
    

(Optional) Schlüsselbasierte Authentifizierung konfigurieren

Die Standardauthentifizierungsmethode ist verwaltete Identität, sodass die meisten Umgebungen diesen Abschnitt überspringen können. Schließen Sie diesen Abschnitt nur ab, wenn Ihre Umgebung API-Schlüssel erfordert.

Setze USE_KEYLESS_AUTH auf false.

azd env set USE_KEYLESS_AUTH false

Wenn Sie USE_KEYLESS_AUTH nicht festlegen, verwendet die Bereitstellung die verwaltete Identität. Die Bicep-Infrastruktur gewährt der Container-App-Identität Zugriff auf die Foundry IQ-Datenebene.

Bereitstellen mit „azd up“

  1. Führen Sie im Repositorystamm azd up aus.

    azd up
    
  2. Wenn Sie dazu aufgefordert werden, wählen Sie das Azure Abonnement und den Standort für die Ressourcen aus.

  3. Warten Sie, bis durch azd die Infrastruktur bereitgestellt, die Container erstellt, die Images gepusht und die Dienste in Azure Container Apps bereitgestellt wurden.

  4. Überprüfen Sie die Ausgabe nach der Bereitstellung. Die Ausgabe enthält die vollqualifizierten Client- und Serverdomänennamen (FQDNs) für die Azure Container Apps Bereitstellung.

    AZURE_CLIENT_URL: <client-container-app-fqdn>
    AZURE_SERVER_URL: <server-container-app-fqdn>
    SEARCH_SERVICE_NAME: <search-service-name>
    

    Verwenden Sie den AZURE_CLIENT_URL Wert, um die Website zu öffnen. Die Client-App ruft die Server-App über den Endpunkt auf, der während der Bereitstellung konfiguriert ist.

    Die Bereitstellung hat auch den Foundry IQ-Dienst erstellt und den good-books Index automatisch über den postprovision Hook im Beispiel-Repository geladen.

Verwenden Sie die Suche auf Ihrer Container-Apps-Website

  1. Öffnen Sie den Client-FQDN aus der azd up Ausgabe in einem Browser.

  2. Geben Sie in der Suchleiste der Website eine Suchabfrage ein, z. B. code. Das AutoVervollständigen-Feature schlägt übereinstimmende Buchtitel vor.

  3. Wählen Sie einen Vorschlag aus, oder fahren Sie mit der Eingabe Ihrer eigenen Abfrage fort. Wählen Sie die EINGABETASTE aus, wenn Sie die Suchabfrage abgeschlossen haben.

  4. Überprüfen Sie die Ergebnisse, und wählen Sie dann ein Buch aus, um weitere Details anzuzeigen.

Problembehandlung

Wenn die Web-App nicht bereitgestellt wird oder nicht funktioniert, verwenden Sie die folgende Liste, um das Problem zu ermitteln und zu beheben:

  • Wurde azd up abgeschlossen?

    Überprüfen Sie die azd up Ausgabe des ersten fehlgeschlagenen Bereitstellungs-, Build- oder Deploymentschritts. Wenn die Bereitstellung während der Provisionierung beendet wird, überprüfen Sie Ihre Abonnementberechtigungen und die ausgewählte Region. Wenn die Bereitstellung während des Containerbuilds oder der Bereitstellungsschritte beendet wird, führen Sie azd up nach der Behebung des gemeldeten Problems erneut aus.

  • Können Sie den Clientendpunkt öffnen?

    Öffnen Sie den AZURE_CLIENT_URL Wert aus der azd up Ausgabe. Wenn die Seite nicht geladen wird, wechseln Sie zum Azure-Portal, öffnen Sie die Clientcontainer-App, und überprüfen Sie den Revisionsstatus und die Protokolle.

  • Kann der Client den Serverendpunkt aufrufen?

    Öffnen Sie Ihre Browserentwicklertools, und überprüfen Sie die Netzwerkaufrufe aus der Client-App. Wenn Aufrufe der API fehlschlagen, vergewissern Sie sich, dass die Servercontainer-App ausgeführt wird und dass die Client-App den Server-FQDN während der Bereitstellung empfangen hat.

  • Kann der Server Foundry IQ abfragen?

    Wenn Suchvorgänge Fehler zurückgeben, überprüfen Sie die Servercontainer-App-Protokolle. Vergewissern Sie sich bei verwalteter Identität, dass die Identität Zugriff auf die Foundry IQ-Datenebene hat. Vergewissern Sie sich bei der schlüsselbasierten Authentifizierung, dass Sie USE_KEYLESS_AUTH vor der Bereitstellung auf false festgelegt haben und dass die generierte Containerumgebung die Konfiguration des Foundry IQ-Diensts enthält.

Bereinigen von Ressourcen

Verwenden Sie azd down --purge, um die Azure-Ressourcen zu löschen, die in diesem Lernprogramm erstellt wurden. Das --purge Flag entfernt dauerhaft Ressourcen, die vorläufiges Löschen unterstützen, anstatt sie für den Aufbewahrungszeitraum in einem wiederherstellbaren Zustand zu belassen. Durch das Löschen werden Namenskonflikte vermieden, wenn Sie dieses Tutorial später erneut bereitstellen.

  1. Führen Sie im Repositorystamm den Bereinigungsbefehl aus.

    azd down --purge
    
  2. Überprüfen Sie die Ressourcen, die azd auflistet.

  3. Bestätigen Sie den Löschvorgang, wenn Sie dazu aufgefordert werden.

Wenn Sie einen Foundry IQ-Dienst außerhalb der azd Bereitstellung erstellt haben, wechseln Sie im Azure Portal zu Ihrem Foundry IQ-Dienst, und wählen Sie oben auf der Seite "Löschen" aus.

Nächster Schritt