Konfigurieren von QnA Maker-Ressourcen

  • Artikel

Benutzer können QnA Maker für die Verwendung einer anderen Cognitive Search-Ressource konfigurieren. Bei Verwendung der allgemein verfügbaren Version von QnA Maker können sie außerdem App-Diensteinstellungen konfigurieren.

Hinweis

Der QnA Maker-Dienst wird am 31. März 2025 außer Betrieb gesetzt. Eine neuere Version der Funktionalität „Fragen und Antworten“ ist jetzt als Teil von Azure KI Language verfügbar. Antworten auf Fragen innerhalb des Sprachdiensts finden Sie unter Fragen und Antworten. Ab dem 1. Oktober 2022 können Sie keine neuen QnA Maker-Ressourcen mehr erstellen. Informationen zum Migrieren vorhandener QnA Maker-Wissensdatenbanken für Fragen und Antworten finden Sie im Migrationsleitfaden.

Konfigurieren von QnA Maker zur Verwendung einer anderen Cognitive Search-Ressource

Hinweis

Wenn Sie den dem QnA Maker zugeordneten Azure Search-Dienst ändern, verlieren Sie den Zugriff auf alle bereits darin vorhandenen Wissensdatenbanken. Stellen Sie sicher, dass Sie die vorhandenen Wissensdatenbanken exportieren, bevor Sie den Azure Search-Dienst ändern.

Wenn Sie einen QnA-Dienst und dessen Abhängigkeiten (z.B. Search) über das Portal erstellen, wird automatisch ein Suchdienst erstellt und mit dem QnA Maker-Dienst verknüpft. Nachdem diese Ressourcen erstellt wurden, können Sie die App Service-Einstellung aktualisieren, um einen bereits vorhandenen Suchdienst zu nutzen und den soeben erstellten Suchdienst zu entfernen.

Die App Service-Ressource von QnA Maker verwendet die Cognitive Search-Ressource. Um die von QnA Maker verwendete Cognitive Search-Ressource zu ändern, müssen Sie die Einstellung im Azure-Portal ändern.

  1. Rufen Sie den Administratorschlüssel und den Namen der Cognitive Search-Ressource ab, die von QnA Maker verwendet werden soll.

  2. Melden Sie sich beim Azure-Portal an, und suchen Sie den App Service, der Ihrer QnA Maker-Ressource zugeordnet ist. Beide weisen denselben Namen auf.

  3. Wählen Sie Einstellungen und dann Konfiguration aus. Dadurch werden alle vorhandenen Einstellungen für den App Service des QnA Makers angezeigt.

    Screenshot des Azure-Portals mit dargestellten Konfigurationseinstellungen für App Service

  4. Ändern Sie die Werte für die folgenden Schlüssel:

    • AzureSearchAdminKey
    • AzureSearchName

  5. Um die neuen Einstellungen zu verwenden, müssen Sie den App Service neu starten. Wählen Sie Übersicht und dann Neu starten aus.

    Screenshot des Azure-Portals beim Neustart von App Service nach dem Ändern der Konfigurationseinstellungen

Wenn Sie einen QnA-Dienst über Azure Resource Manager-Vorlagen erstellen, können Sie alle Ressourcen erstellen und die App Service-Erstellung so steuern, dass sie einen vorhandenen Suchdienst nutzt.

Weitere Informationen zum Konfigurieren der App Service-Anwendungseinstellungen finden Sie hier.

Abrufen der neuesten Runtime-Updates

Die QnA Maker-Runtime ist Teil der Azure App Service-Instanz, die beim Erstellen eines QnA Maker-Diensts im Azure-Portal bereitgestellt wird. Updates für die Runtime werden in regelmäßigen Abständen bereitgestellt. Die QnA Maker App Service-Instanz befindet sich nach der Websiteerweiterung vom April 2019 (Version 5+) im automatischen Updatemodus. Dieses Update ist so konzipiert, dass es während Upgrades keine Downtime berücksichtigt.

Sehen Sie sich die aktuelle Version unter https://www.qnamaker.ai/UserSettings an. Wenn Ihre Version älter als Version 5.x ist, müssen Sie App Service neu starten, damit die neuesten Updates angewendet werden:

  1. Wechseln Sie im Azure-Portal zu Ihrem QnA Maker-Dienst (Ressourcengruppe).

    Azure-Ressourcengruppe von QnA Maker

  2. Wählen Sie die App Service-Instanz aus, und öffnen Sie den Abschnitt Übersicht.

    App Service-Instanz für QnA Maker

  3. Starten Sie App Service neu. Der Updateprozess sollte innerhalb weniger Sekunden abgeschlossen sein. Abhängige Anwendungen oder Bots, in denen dieser QnA Maker-Dienst verwendet wird, stehen während dieses Neustartzeitraums für Endbenutzer nicht zur Verfügung.

    Neustarten der QnA Maker App Service-Instanz

Konfigurieren der App Service-Leerlaufeinstellung zur Vermeidung von Timeouts

Die App Service-Instanz, von der die QnA Maker-Vorhersageruntime für eine veröffentlichte Wissensdatenbank bereitgestellt wird, verfügt über eine Leerlauftimeoutkonfiguration, durch die standardmäßig automatisch ein Timeout ausgelöst wird, wenn sich der Dienst im Leerlauf befindet. Dies hat für QnA Maker zur Folge, dass für die generateAnswer-API Ihrer Vorhersageruntime gelegentlich ein Timeout auftritt, wenn eine Weile kein Datenverkehr übermittelt wurde.

Legen Sie den Leerlauf auf „Immer aktiv“ fest, um zu gewährleisten, dass die Vorhersageendpunkt-App geladen bleibt, auch wenn kein Datenverkehr übermittelt wird.

  1. Melden Sie sich beim Azure-Portal an.

  2. Suchen Sie nach der App Service-Instanz Ihrer QnA Maker-Ressource, und wählen Sie sie aus. Sie hat den gleichen Namen wie die QnA Maker-Ressource, aber einen anderen Typ (App Service).

  3. Navigieren Sie zu Einstellungen, und wählen Sie Konfiguration aus.

  4. Wählen Sie im Konfigurationsbereich Allgemeine Einstellungen aus, navigieren Sie zu Immer aktiv, und wählen Sie Ein aus.

    Wählen Sie im Konfigurationsbereich „Allgemeine Einstellungen“ aus, navigieren Sie zu „Immer aktiv“, und wählen Sie „Ein“ aus.

  5. Wählen Sie zum Speichern der Konfiguration Speichern aus.

  6. Sie werden gefragt, ob Sie die App neu starten möchten, um die neue Einstellung zu verwenden. Wählen Sie Weiter.

Weitere Informationen zum Konfigurieren der allgemeinen App Service-Einstellungen finden Sie hier.

Geschäftskontinuität mit Traffic Manager

Das Hauptziel des Geschäftskontinuitätsplans besteht darin, einen ausfallsicheren Wissensdatenbank-Endpunkt zu erstellen, der sicherstellen kann, dass keine Ausfallzeiten für den Bot oder die ihn verwendende Anwendung entstehen.

QnA Maker-Geschäftskontinuitätsplan

Das oben dargestellte allgemeine Konzept lautet wie folgt:

  1. Richten Sie zwei parallele QnA Maker-Dienste in Azure-Regionspaaren ein.

  2. Sichern Sie Ihren primären QnA Maker-App-Dienst, und stellen Sie ihn bei der Sekundäreinrichtung wieder her. Dadurch wird sichergestellt, dass beide Setups mit demselben Hostnamen und denselben Schlüsseln arbeiten.

  3. Halten Sie die primären und sekundären Azure-Suchindizes synchron. Verwenden Sie das hier aufgeführte GitHub-Beispiel, um zu erfahren, wie Azure-Indizes gesichert und wiederhergestellt werden.

  4. Sichern Sie die Application Insights-Daten mithilfe des fortlaufenden Exports.

  5. Verwenden Sie Traffic Manager nach der Einrichtung der primären und sekundären Stapel, um die zwei Endpunkte zu konfigurieren und eine Routingmethode einzurichten.

  6. Sie müssten ein TLS-Zertifikat (Transport Layer Security), früher SSL-Zertifikat (Secure Sockets Layer) genannt, für Ihren Traffic Manager-Endpunkt erstellen. Binden Sie das TLS/SSL-Zertifikat an Ihre App-Dienste.

  7. Verwenden Sie dann den Traffic Manager-Endpunkt in Ihrem Bot oder in Ihrer App.