Problembehandlung für QnA Maker

Antwort: Probleme bei der Durchsatzleistung weisen darauf hin, dass Sie sowohl für Ihren App-Dienst als auch für die Cognitive Search-Instsanz zentral hochskalieren müssen. Fügen Sie Ihrer Cognitive Search-Instanz ggf. ein Replikat hinzu, um die Leistung zu verbessern.

Hier finden Sie weitere Informationen zu Tarifen.

Antwort: Der QnA Maker-Dienstendpunkt ist beim Debuggen hilfreich, wenn Sie sich an den QnA Maker-Support oder UserVoice wenden. Der Endpunkt ist eine URL mit folgendem Format: https://your-resource-name.azurewebsites.net.

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

   

2. Wählen Sie die der QnA Maker-Ressource zugeordnete App Service-Instanz aus. Normalerweise sind die Namen identisch.

   

3. Sie finden die Endpunkt-URL im Abschnitt „Übersicht“.

   

Antwort: Löschen Sie keine der Azure-Dienste, die zusammen mit der QnA Maker-Ressource erstellt wurden, wie Search oder Web-App. Diese sind erforderlich, damit QnA Maker funktioniert. Wenn Sie einen dieser Dienste löschen, funktioniert QnA Maker nicht mehr richtig.

Alle Löschvorgänge sind endgültig, dazu gehört auch das Löschen von Frage/Antwort-Paaren, Dateien, URLs, benutzerdefinierten Fragen und Antworten, Wissensdatenbanken oder Azure-Ressourcen. Stellen Sie sicher, dass Sie Ihre Wissensdatenbank von der Seite Einstellungen exportieren, bevor Sie Teile der Wissensdatenbank löschen.

Antwort: Es ist möglich, dass QnA Maker einige Frage-und-Antwort-Inhalte (Question and Answer, QnA) aus gültigen FAQ-URLs nicht automatisch extrahieren kann. In solchen Fällen können Sie den QnA-Inhalt in eine TXT-Datei einfügen und prüfen, ob das Tool diesen Inhalt erfassen kann. Alternativ dazu können Sie Ihrer Wissensdatenbank über das QnA Maker-Portal redaktionell Inhalte hinzufügen.

Antwort: Die Größe der Wissensdatenbank hängt von der beim Erstellen des QnA Maker-Diensts ausgewählten SKU für Azure Search ab. Ausführlichere Informationen finden Sie hier.

Antwort: Sie haben noch keine QnA Maker-Dienste in Azure erstellt. Klicken Sie hier, um zu erfahren, wie das funktioniert.

Antwort: Die Freigabe erfolgt auf der Ebene eines QnA Maker-Diensts, was bedeutet, dass alle Wissensdatenbanken in diesem Dienst freigegeben werden. Hier finden Sie Informationen zum Zusammenarbeiten an einer Wissensdatenbank.

Antwort: Die Freigabe basiert auf der rollenbasierten Zugriffssteuerung in Azure. Wenn Sie jede Ressource in Azure für einen anderen Benutzer freigeben können, können Sie auch QnA Maker freigeben.

Antwort: Sie können den gesamten QnA Maker-Dienst freigeben, nicht aber einzelne Wissensdatenbanken.

Antwort: Die Standardmeldung ist Teil der Einstellungen in Ihrem App-Dienst.

• Wechseln Sie im Azure-Portal zu Ihrer App Service-Ressource.

• Wählen Sie die Option Einstellungen aus.

• Ändern Sie den Wert der Einstellung DefaultAnswer.
• Starten Sie Ihren App-Dienst neu.

Antwort: Weitere Informationen finden Sie unter Speicherorte von Datenquellen.

Antwort: Jeder Bearbeitungsvorgang, sei es eine Tabellenaktualisierung, ein Test oder eine Änderung der Einstellungen, muss gespeichert werden, bevor die Veröffentlichung erfolgen kann. Wählen Sie nach jedem Bearbeitungsvorgang unbedingt die Schaltfläche Speichern und Trainieren aus.

Antwort:

Automatische Multimediaextraktion für Dateien und URLs

• URLs: eingeschränkte Konvertierungsfunktionen von HTML zu Markdown
• Dateien: nicht unterstützt

Antworttext in Markdown

Wenn die QnA-Paare in der Wissensdatenbank hinzugefügt wurden, können Sie den Markdowntext einer Antwort bearbeiten, um Links zu Medien einzufügen, die über öffentliche URLs verfügbar sind.

Antwort: Weitere Informationen hierzu finden Sie unter Unterstützte Sprachen.

Wenn Sie über Inhalte in verschiedenen Sprachen verfügen, stellen Sie sicher, dass Sie für jede Sprache einen separaten Dienst erstellen.

Antwort: Aktualisieren Sie Ihren App-Dienst, wenn sich das Symbol „Vorsicht“ neben dem Versionswert für die Wissensdatenbank in der Tabelle Endpunktschlüssel auf der Seite Benutzereinstellungen befindet.

Antwort: Wenn Sie einen Azure KI Search-Index löschen, ist der Vorgang endgültig, weshalb der Index nicht wiederhergestellt werden kann.

Antwort: Falls Sie den testkb-Index in Ihrem Suchdienst gelöscht haben, können Sie die Daten aus der zuletzt veröffentlichten Wissensdatenbank wiederherstellen. Verwenden Sie das Wiederherstellungstool RestoreTestKBIndex, das auf GitHub verfügbar ist.

Antwort: Aktualisieren Sie im API-Abschnitt des Bereichs „App Service“ die CORS-Einstellung auf * oder „https://www.qnamaker.ai"“. Lässt sich das Problem dadurch nicht beheben, überprüfen Sie, ob organisationsspezifische Einschränkungen gelten.

Antwort: Aktualisieren Sie Ihre Endpunktschlüssel, wenn Sie den Verdacht hegen, dass sie gestohlen oder ausgespäht wurden.

Antwort: Um mehrere Wissensdatenbanken und mehrere Sprachen zu nutzen, müssen Benutzer eine QnA Maker-Ressource für jede Sprache erstellen. Dadurch wird ein separater Azure Search-Dienst pro Sprache erstellt. Das Kombinieren von Wissensdatenbanken verschiedener Sprachen in einem einzelnen Azure Search-Dienst führt zur einer niedrigeren Relevanz der Ergebnisse.

Antwort: Der Name der Azure KI Search-Ressource ist der Name der QnA Maker-Ressource, an den einige zufällige Buchstaben angefügt sind. Dadurch wird es schwierig, mehrere Search-Ressourcen für QnA Maker zu unterscheiden. Erstellen Sie einen separaten Azure Cognitive Search-Dienst (benennen Sie ihn nach Belieben), und verbinden Sie ihn mit Ihrem QnA-Dienst. Die Schritte dafür sind ähnlich wie bei einem Upgrade von Azure Search.

Antwort: Der Speicherplatz für Ihren App-Dienst ist möglicherweise voll. Schritte zum Bereinigen des Speicherplatzes:

1. Wählen Sie im Azure-Portal den App-Dienst für QnA Maker aus, und beenden Sie dann den Dienst.

2. Wählen Sie, während Sie sich noch im App-Dienst befinden, Entwicklungstools, Erweiterte Tools und dann Starten aus. Dadurch wird ein neues Browserfenster geöffnet.

3. Wählen Sie Debugging-Konsole und dann CMD aus, um ein Befehlszeilentool zu öffnen.

4. Navigieren Sie zum Verzeichnis site/wwwroot/Data/QnAMaker/ .

5. Entfernen Sie jeden Ordner, dessen Name mit rd beginnt.

   Folgende Elemente dürfen Sie nicht löschen:

   • Datei „KbIdToRankerMappings.txt
   • Datei „EndpointSettings.json“
   • Ordner „EndpointKeys“

6. Starten Sie den App-Dienst.

7. Greifen Sie auf Ihre Wissensdatenbank zu, um zu überprüfen, ob sie nun funktioniert.

Antwort: Führen Sie eine Gegenprüfung mithilfe der unten stehenden Schritte durch, um das Problem zu beheben:

1. Der Parameter „UserAppInsightsKey“ unter App Service > Einstellungsgruppe > Anwendungseinstellungen > Name ist ordnungsgemäß konfiguriert und auf die entsprechende GUID der Registerkarte „Übersicht“ in Application Insights („Instrumentierungsschlüssel“) festgelegt.>

2. Überprüfen Sie unter App Service > Einstellungsgruppe > Abschnitt „Application Insights“, ob Application Insights aktiviert und mit der entsprechenden Application Insights-Ressource verknüpft ist.>

Antwort: Führen Sie die folgenden Schritte aus:

1. Kopieren Sie den Wert des APPINSIGHTS_INSTRUMENTATIONKEY-Namens, und fügen Sie ihn als UserAppInsightsKey-Name ein. Falls dort bereits ein Wert vorhanden ist, überschreiben Sie ihn.

2. Wenn der UserAppInsightsKey-Schlüssel in den App-Einstellungen nicht vorhanden ist, fügen Sie einen neuen Schlüssel mit diesem Namen hinzu, und kopieren Sie den Wert.

3. Speichern Sie den Wert. Dadurch wird App Service automatisch neu gestartet. Das Problem sollte dadurch behoben werden.

Antwort: Nein. Sie müssen Bot Framework nicht in Verbindung mit QnA Maker verwenden. QnA Maker wird jedoch als eine von mehreren Vorlagen in Azure KI Bot Service angeboten. Bot Service ermöglicht die schnelle, intelligente Botentwicklung über Microsoft Bot Framework und wird in einer serverlosen Umgebung ausgeführt.

Antwort: Folgen Sie den Anweisungen in dieser Dokumentation, um Ihren Bot mit Azure KI Bot Service zu erstellen.

Antwort: Sie benötigen die folgenden Informationen über Ihre Wissensdatenbank:

• Wissensdatenbank-ID
• Sie finden den benutzerdefinierten Unterdomänennamen des veröffentlichten Endpunkts der Wissensdatenbank, der auch als host bezeichnet wird, nach der Veröffentlichung auf der Seite Einstellungen.
• Der Schlüssel des veröffentlichten Endpunkts der Wissensdatenbank – befindet sich nach der Veröffentlichung auf der Seite Einstellungen.

Wechseln Sie mit diesen Informationen zum App Service Ihres Bot im Azure-Portal. Ändern Sie unter Einstellungen -> Konfiguration -> Anwendungseinstellungen diese Werte.

Der Endpunktschlüssel der Wissensdatenbank ist im ABS-Dienst mit QnAAuthkey gekennzeichnet.

Antwort: Ja, die Wissensdatenbank kann von beliebig vielen Clients abgefragt werden. Wenn die Antwort der Wissensdatenbank langsam zu sein scheint oder ein Timeout auftritt, sollten Sie eine Aktualisierung des Diensttarifs für den mit der Wissensdatenbank verbundenen App-Dienst in Betracht ziehen.

Antwort: Führen Sie die folgenden Schritte aus, um den QnA Maker-Dienst als Webchat-Steuerelement in Ihre Website einzubetten:

1. Erstellen Sie Ihren FAQ-Bot, indem Sie den hier angegebenen Anweisungen folgen.
2. Aktivieren Sie den Webchat, indem Sie die hier aufgeführten Schritte ausführen.

Antwort:

Als Sie den QnA Maker-Dienst erstellt haben, haben Sie eine Azure-Region ausgewählt. Ihre Wissensdatenbanken und Protokolldateien werden in dieser Region gespeichert.