Problemen met QnA Maker oplossen

De gecureerde lijst met de meest gestelde vragen met betrekking tot de QnA Maker-service helpt u sneller en met betere resultaten de service te gebruiken.

Notitie

De QnA Maker-service wordt op 31 maart 2025 buiten gebruik gesteld. Een nieuwere versie van de vraag- en antwoordmogelijkheid is nu beschikbaar als onderdeel van Azure AI Language. Zie vraagantwoording voor vragen in de Language Service voor het beantwoorden van vragen. Vanaf 1 oktober 2022 kunt u geen nieuwe QnA Maker-resources maken. Raadpleeg de migratiehandleiding voor informatie over het migreren van bestaande QnA Maker-knowledge bases om vragen te beantwoorden.

Voorspellingen beheren

Hoe kan ik de doorvoerprestaties voor queryvoorspellingen verbeteren?

Antwoord: Prestatieproblemen met doorvoer geven aan dat u omhoog moet schalen voor zowel uw App Service als uw Cognitive Search. Overweeg om een replica toe te voegen aan uw Cognitive Search om de prestaties te verbeteren.

Meer informatie over prijscategorieën.

Het QnAMaker-service-eindpunt ophalen

Antwoord: QnAMaker-service-eindpunt is handig voor foutopsporing wanneer u contact op neemt met QnAMaker-ondersteuning of UserVoice. Het eindpunt is een URL in deze vorm: https://your-resource-name.azurewebsites.net.

  1. Ga naar uw QnAMaker-service (resourcegroep) in Azure Portal

    QnAMaker Azure resource group in Azure portal

  2. Selecteer de App Service die is gekoppeld aan de QnA Maker-resource. Normaal gesproken zijn de namen hetzelfde.

    Select QnAMaker App Service

  3. De eindpunt-URL is beschikbaar in de sectie Overzicht

    QnAMaker endpoint

De Knowledge Base beheren

Ik heb per ongeluk een deel van mijn QnA Maker verwijderd. Wat moet ik doen?

Antwoord: Verwijder geen van de Azure-services die samen met de QnA Maker-resource zijn gemaakt, zoals Zoeken of Web-app. Deze zijn nodig om QnA Maker te laten werken, als u er een verwijdert, werkt QnA Maker niet meer goed.

Alle verwijderingen zijn permanent, inclusief vraag- en antwoordparen, bestanden, URL's, aangepaste vragen en antwoorden, knowledge bases of Azure-resources. Zorg ervoor dat u uw knowledge base exporteert vanaf de Instellingen pagina voordat u een deel van uw Knowledge Base verwijdert.

Waarom worden mijn URL('s)/file(s) geen vraag-antwoordparen geëxtraheerd?

Antwoord: Het is mogelijk dat QnA Maker bepaalde vraag-en-antwoord-inhoud (QnA) niet automatisch kan extraheren uit geldige URL's voor veelgestelde vragen. In dergelijke gevallen kunt u de QnA-inhoud in een TXT-bestand plakken en zien of het hulpprogramma deze kan opnemen. U kunt ook redactionele inhoud toevoegen aan uw Knowledge Base via de QnA Maker-portal.

Hoe groot kan ik mijn Knowledge Base maken?

Antwoord: De grootte van de knowledge base is afhankelijk van de SKU van Azure Search die u kiest bij het maken van de QnA Maker-service. Lees hier voor meer informatie.

Waarom zie ik niets in de vervolgkeuzebank wanneer ik een nieuwe Knowledge Base maak?

Antwoord: U hebt nog geen QnA Maker-services in Azure gemaakt. Lees hier hoe u dat doet.

Hoe kan ik een met anderen Knowledge Base delen?

Antwoord: Delen werkt op het niveau van een QnA Maker-service, dat wil gezegd, alle knowledge bases in de service worden gedeeld. Lees hier hoe u kunt samenwerken aan een knowledge base.

Kunt u een knowledge base delen met een inzender die zich niet in dezelfde AAD-tenant bevindt, om een knowledge base te wijzigen?

Antwoord: Delen is gebaseerd op op rollen gebaseerd toegangsbeheer van Azure. Als u een resource in Azure met een andere gebruiker kunt delen, kunt u ook QnA Maker delen.

Als u een App Service-plan hebt met 5 QnAMaker-knowledge bases. Kunt u lees-/schrijfrechten toewijzen aan 5 verschillende gebruikers, zodat elk van hen slechts toegang heeft tot 1 QnAMaker-knowledge base?

Antwoord: U kunt een volledige QnAMaker-service delen, niet afzonderlijke knowledge bases.

Hoe kan ik het standaardbericht wijzigen wanneer er geen goede overeenkomst wordt gevonden?

Antwoord: Het standaardbericht maakt deel uit van de instellingen in uw App Service.

  • Ga naar uw App Service-resource in Azure Portal

qnamaker appservice

  • Selecteer de optie Instellingen

qnamaker appservice settings

  • De waarde van de instelling DefaultAnswer wijzigen
  • Uw App Service opnieuw starten

qnamaker appservice restart

Waarom wordt mijn SharePoint-koppeling niet geëxtraheerd?

Antwoord: Zie locaties voor gegevensbronnen voor meer informatie.

De updates die ik in mijn knowledge base heb aangebracht, worden niet doorgevoerd in publiceren. Waarom niet?

Antwoord: Elke bewerking voor bewerken, ongeacht in een tabelupdate, test of instelling, moet worden opgeslagen voordat deze kan worden gepubliceerd. Zorg ervoor dat u na elke bewerking Opslaan en trainen de knop Opslaan en trainen selecteert.

Ondersteunt de Knowledge Base uitgebreide gegevens of multimedia?

Antwoord:

Multimedia automatisch extraheren voor bestanden en URL's

  • URL's: beperkte html-naar-Markdown-conversiemogelijkheid.
  • Bestanden - niet ondersteund

Antwoordtekst in Markdown

Zodra QnA-paren zich in de Knowledge Base bevinden, kunt u de Markdown-tekst van een antwoord bewerken om koppelingen naar media op te nemen die beschikbaar zijn via openbare URL's.

Biedt QnA Maker ondersteuning voor niet-Engelse talen?

Antwoord: Zie meer informatie over ondersteunde talen.

Als u inhoud in meerdere talen hebt, moet u ervoor zorgen dat u een afzonderlijke service maakt voor elke taal.

Services beheren

Wanneer moet ik mijn App Service opnieuw starten?

Antwoord: Vernieuw uw app-service wanneer het waarschuwingspictogram naast de versiewaarde voor de knowledge base in de tabel Eindpuntsleutels op de pagina Gebruiker Instellingen pagina staat.

Ik heb mijn bestaande Search-service verwijderd. Hoe kan ik dit oplossen?

Antwoord: Als u een Azure AI Search-index verwijdert, is de bewerking definitief en kan de index niet worden hersteld.

Ik heb mijn 'testkb'-index verwijderd in mijn Search-service. Hoe kan ik dit oplossen?

Antwoord: Als u de index in uw testkb Search-service hebt verwijderd, kunt u de gegevens uit de laatst gepubliceerde KB herstellen. Gebruik het herstelprogramma RestoreTestKBIndex dat beschikbaar is op GitHub.

Ik krijg de volgende fout: Controleer of de CORS-instellingen van QnA Maker App Service zijn toegestaan https://www.qnamaker.ai of dat er organisatiespecifieke netwerkbeperkingen zijn. Hoe kan ik dit oplossen?

Antwoord: Werk in de API-sectie van het deelvenster App Service de CORS-instelling bij naar * of "https://www.qnamaker.ai". Als het probleem hiermee niet wordt opgelost, controleert u of er organisatiespecifieke beperkingen bestaan.

Wanneer moet ik mijn eindpuntsleutels vernieuwen?

Antwoord: Vernieuw uw eindpuntsleutels als u vermoedt dat ze zijn aangetast.

Kan ik dezelfde Azure AI Search-resource gebruiken voor knowledge bases met meerdere talen?

Antwoord: Als u meerdere talen en meerdere Knowledge Bases wilt gebruiken, moet de gebruiker voor elke taal een QnA Maker-resource maken. U maakt dan per taal een afzonderlijke Azure Search-service. Het combineren van verschillende taalkennisdatabases in één Azure Search-service leidt tot verminderde relevantie van resultaten.

Hoe kan ik de naam wijzigen van de Azure AI Search-resource die wordt gebruikt door QnA Maker?

Antwoord: De naam van de Azure AI Search-resource is de QnA Maker-resourcenaam met enkele willekeurige letters die aan het einde worden toegevoegd. Hierdoor is het moeilijk om onderscheid te maken tussen meerdere zoekbronnen voor QnA Maker. Maak een afzonderlijke zoekservice (geef deze de naam zoals u wilt) en verbind deze met uw QnA-service. De stappen zijn vergelijkbaar met de stappen die u moet uitvoeren om een azure-zoekopdracht te upgraden.

Wanneer QnA Maker 'Runtime-kern is niet geïnitialiseerd' retourneert, hoe kan ik dit oplossen?

Antwoord: De schijfruimte voor uw app-service is mogelijk vol. Stappen voor het herstellen van uw schijfruimte:

  1. Selecteer in Azure Portal de App-service van uw QnA Maker en stop de service.

  2. Terwijl u zich nog in de App Service, selecteert u Ontwikkelhulpprogramma's en vervolgens Geavanceerde hulpprogramma's en vervolgens Go. Er wordt een nieuw browservenster geopend.

  3. Selecteer Debug-console en vervolgens CMD om een opdrachtregelprogramma te openen.

  4. Navigeer naar de map site/wwwroot/Data/QnAMaker/ .

  5. Verwijder alle mappen waarvan de naam begint met rd.

    Verwijder het volgende niet :

    • Bestand KbIdToRankerMappings.txt
    • Bestand EndpointSettings.json
    • Map EndpointKeys
  6. Start de App Service.

  7. Open uw Knowledge Base om te controleren of deze nu werkt.

Waarom werkt mijn Application Insights niet?

Antwoord: Controleer en werk de onderstaande stappen bij om het probleem op te lossen:

  1. In App Service -> Instellingen groep -> Configuratiesectie -> Toepassing Instellingen -> De naam UserAppInsightsKey-parameters correct zijn geconfigureerd en ingesteld op het desbetreffende tabblad Overzicht van Application Insights ('Instrumentation Key').

  2. Zorg ervoor dat App Insights is ingeschakeld en is verbonden met de respectieve Application Insights-resource in App Service -> Instellingen groep -> Application Insights>.

Mijn Application Insights is ingeschakeld, maar waarom werkt deze niet goed?

Antwoord: Volg de onderstaande stappen:

  1. Kopieer de waarde van de naam 'APPINSIGHTS_INSTRUMENTATIONKEY' naar de naam UserAppInsightsKey door deze te overschrijven als er al een waarde aanwezig is.

  2. Als de sleutel UserAppInsightsKey niet bestaat in app-instellingen, voegt u een nieuwe sleutel met die naam toe en kopieert u de waarde.

  3. Sla deze op en start de app-service automatisch opnieuw op. Dit zou het probleem moeten oplossen.

Integreren met andere services, waaronder Bots

Moet ik Bot Framework gebruiken om QnA Maker te kunnen gebruiken?

Antwoord: Nee, u hoeft het Bot Framework niet te gebruiken met QnA Maker. QnA Maker wordt echter aangeboden als een van de verschillende sjablonen in Azure AI Bot Service. Bot Service maakt snelle intelligente botontwikkeling mogelijk via Microsoft Bot Framework en wordt uitgevoerd in een serverloze omgeving.

Hoe kan ik een nieuwe bot maken met QnA Maker?

Antwoord: Volg de instructies in deze documentatie om uw bot te maken met Azure AI Bot Service.

Hoe kan ik een andere knowledge base gebruiken met een bestaande Azure AI Bot Service?

Antwoord: U moet de volgende informatie over uw Knowledge Base hebben:

  • Knowledge Base-id.
  • De naam van het aangepaste subdomein van het gepubliceerde eindpunt van de Knowledge Base, ook wel bekend als host, vindt u op Instellingen pagina nadat u het hebt gepubliceerd.
  • De gepubliceerde eindpuntsleutel van de Knowledge Base, gevonden op Instellingen pagina nadat u het hebt gepubliceerd.

Ga met deze informatie naar de app-service van uw bot in Azure Portal. Wijzig deze waarden onder Instellingen -> Configuratie -> Toepassingsinstellingen.

De eindpuntsleutel van de Knowledge Base wordt gelabeld QnAAuthkey in de ABS-service.

Kunnen twee of meer clienttoepassingen een knowledge base delen?

Antwoord: Ja, de knowledge base kan worden opgevraagd bij een willekeurig aantal clients. Als het antwoord van de Knowledge Base traag lijkt te zijn of een time-out optreedt, kunt u overwegen om de servicelaag voor de app-service die is gekoppeld aan de Knowledge Base te upgraden.

Hoe kan ik de QnA Maker-service insluiten op mijn website?

Antwoord: Volg deze stappen om de QnA Maker-service in te sluiten als webchatbesturingselement op uw website:

  1. Maak uw FAQ-bot door de instructies hier te volgen.
  2. Schakel de webchat in door de stappen hier te volgen

Gegevensopslag

Welke gegevens worden opgeslagen en waar worden deze opgeslagen?

Antwoord:

Wanneer u uw QnA Maker-service maakt, hebt u een Azure-regio geselecteerd. Uw knowledge bases en logboekbestanden worden opgeslagen in deze regio.