Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
Öffnen Sie in Visual Studio Code ein Terminal im Repositorystamm, z. B.
azure-search-static-web-app.Anmelden bei Azure mithilfe von
azd.azd auth loginWenn 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
azdUmgebung. Ersetzen SieYOUR-ENVIRONMENT-NAMEdurch 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“
Führen Sie im Repositorystamm
azd upaus.azd upWenn Sie dazu aufgefordert werden, wählen Sie das Azure Abonnement und den Standort für die Ressourcen aus.
Warten Sie, bis durch
azddie Infrastruktur bereitgestellt, die Container erstellt, die Images gepusht und die Dienste in Azure Container Apps bereitgestellt wurden.Ü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_URLWert, 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-booksIndex automatisch über denpostprovisionHook im Beispiel-Repository geladen.
Verwenden Sie die Suche auf Ihrer Container-Apps-Website
Öffnen Sie den Client-FQDN aus der
azd upAusgabe in einem Browser.Geben Sie in der Suchleiste der Website eine Suchabfrage ein, z. B.
code. Das AutoVervollständigen-Feature schlägt übereinstimmende Buchtitel vor.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.
Ü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 upabgeschlossen?Überprüfen Sie die
azd upAusgabe 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 Sieazd upnach der Behebung des gemeldeten Problems erneut aus.Können Sie den Clientendpunkt öffnen?
Öffnen Sie den
AZURE_CLIENT_URLWert aus derazd upAusgabe. 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_AUTHvor der Bereitstellung auffalsefestgelegt 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.
Führen Sie im Repositorystamm den Bereinigungsbefehl aus.
azd down --purgeÜberprüfen Sie die Ressourcen, die
azdauflistet.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.