Problembehandlung für QnA Maker

Die kuratierte Liste der am häufigsten gestellten Fragen in Bezug auf den QnA Maker-Dienst ermöglichen einen schnelleren Einstieg in die Nutzung des Diensts und bessere Ergebnisse.

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.

Verwalten von Vorhersagen

Wie kann ich die Durchsatzleistung für Abfragevorhersagen verbessern?

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.

Abrufen des QnA Maker-Dienstendpunkts

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“.

   

Verwalten der Wissensdatenbank

Ich habe versehentlich einen Teil von QnA Maker gelöscht. Was soll ich tun?

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.

Warum extrahieren meine URLs/Dateien keine Frage-Antwort-Paare?

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.

Wie groß darf eine von mir erstellte Wissensdatenbank sein?

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.

Warum werden in der Dropdownliste keine Einträge angezeigt, wenn ich versuche, eine neue Wissensdatenbank zu erstellen?

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

Wie gebe ich eine Wissensdatenbank für andere Personen frei?

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.

Kann ich eine Wissensdatenbank zur Bearbeitung für einen Mitwirkenden freigeben, der sich nicht im selben AAD-Mandanten befindet?

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.

Angenommen, ich verfüge über einen App Service-Plan mit fünf QnA Maker-Wissensdatenbanken. Kann ich die Lese-/Schreibberechtigungen fünf verschiedenen Benutzern zuweisen, sodass jeder dieser Benutzer nur auf eine QnA Maker-Wissensdatenbank zugreifen kann?

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

Wie kann ich die Standardmeldung ändern, die angezeigt wird, wenn keine gute Übereinstimmung gefunden wurde?

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.

Warum wird mein SharePoint-Link nicht extrahiert?

Antwort: Weitere Informationen finden Sie unter Speicherorte von Datenquellen.

Die Aktualisierungen, die ich an meiner Wissensdatenbank vorgenommen habe, sind beim Veröffentlichen nicht mehr vorhanden. Warum nicht?

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.

Unterstützt die Wissensdatenbank komplexe Daten oder Multimedia?

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.

Unterstützt QnA Maker andere Sprachen als Englisch?

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.

Verwalten eines Diensts

Wann sollte ich meinen App-Dienst neu starten?

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.

Ich habe meinen Suchdienst gelöscht. Wie kann ich dieses Problem beheben?

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

Ich habe meinen Index „testkb“ in meinem Suchdienst gelöscht. Wie kann ich dieses Problem beheben?

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.

Ich erhalte den folgenden Fehler: Please check if QnA Maker App service's CORS settings allow or if there are any organization specific network restrictions. (Überprüfen Sie, ob die CORS-Einstellungen des QnA Maker-App-Diensts https://www.qnamaker.ai zulassen oder ob organisationsspezifische Netzwerkeinschränkungen vorliegen.) Wie kann ich dies beheben?

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.

Wann sollte ich meine Endpunktschlüssel aktualisieren?

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

Kann ich die gleiche Azure KI Search-Ressource für Wissensdatenbanken in mehreren Sprachen verwenden?

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.

Wie kann ich den Namen der Azure KI Search-Ressource, die von QnA Maker verwendet wird, ändern?

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.

Wenn QnA Maker „Runtime core is not initialized“ (Laufzeitkern ist nicht initialisiert) zurückgibt, wie kann ich diesen Fehler beheben?

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.

Warum funktioniert meine Application Insights-Instanz nicht?

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

Meine Application Insights-Instanz ist aktiviert. Warum funktioniert Sie dennoch nicht ordnungsgemäß?

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.

Integration in andere Dienste, einschließlich Bots

Muss ich Bot Framework nutzen, um QnA Maker verwenden zu können?

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.

Wie kann ich einen neuen Bot mit QnA Maker erstellen?

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

Wie kann ich eine andere Wissensdatenbank mit einem vorhandenen Azure KI Bot Service verwenden?

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.

Können zwei oder mehr Clientanwendungen eine Wissensdatenbank gemeinsam nutzen?

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.

Wie bette ich den QnA Maker-Dienst in meine Website ein?

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.

Datenspeicher

Welche Daten werden gespeichert, und wo werden sie gespeichert?

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.