Quickstart: Uw QnA Maker-knowledge base maken, trainen en publiceren

  • Artikel
  • 5 minuten om te lezen

Notitie

Er is nu een nieuwere versie van de vraag- en antwoordfunctie beschikbaar als onderdeel van Azure Cognitive Service for Language. Zie documentatie voor Azure Cognitive Service for Language voor meer informatie. Zie Vraag beantwoorden voor mogelijkheden voor het beantwoorden van vragenin Language Service. Raadpleeg de migratiehandleiding voor informatie over het migreren van bestaande Knowledge Bases.

U kunt een QnA Maker-knowledge base (KB) maken van uw eigen inhoud, zoals veelgestelde vragen of producthandleidingen. Dit artikel bevat een voorbeeld van het maken van een QnA Maker knowledge base op basis van een eenvoudige webpagina met veelgestelde vragen om vragen te beantwoorden.

Vereisten

  • Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.
  • Een QnA Maker resource die is gemaakt in de Azure Portal. Onthoud uw Azure Active Directory, abonnement en QnA Maker resourcenaam die u hebt geselecteerd tijdens het maken van de resource.

Uw eerste QnA Maker-knowledge base maken

  1. Meld u bij de QnAMaker.ai-portal met uw Azure-referenties.

  2. Selecteer Een knowledge base maken in de QnA Maker-portal.

  3. Sla op de pagina Maken Stap 1 over als u uw QnA Maker-resource al hebt.

Als u de service nog niet hebt gemaakt, selecteert u Stabiel en Een QnA-service maken. U wordt omgeleid naar de Azure Portal om een QnA Maker-service in te stellen in uw abonnement. Onthoud uw Azure Active Directory-id, het abonnement en de naam van de QnA-resource die u hebt geselecteerd tijdens het maken van de resource.

Ga terug naar de QnA Maker-portal, vernieuw de browserpagina en ga door naar Stap 2 als u klaar bent met het maken van de resource in Azure Portal.

  1. Selecteer in Stap 2 uw Active Directory, abonnement en service (resource), en de taal voor alle Knowledge Bases die in de service worden gemaakt.

    Schermopname van het selecteren van een knowledge base in de QnA Maker-service

  2. Geef uw knowledge base in Stap 3 de naam Mijn voorbeeld-QnA-KB.

  3. Configureer in Stap 4 de instellingen met de volgende tabel:

    Instelling Waarde
    Schakel uitpakken van meerdere paden in vanuit URL's, .pdf- of .docx-bestanden. Ingeschakeld
    Standaardtekst met meerdere paden Selecteer een optie
    + URL toevoegen https://www.microsoft.com/en-us/software-download/faq
    Chit-chat Professional selecteren

  4. Selecteer in stap 5, Uw KB maken.

    Tijdens het extractieproces, dat enige tijd duurt, wordt het document gelezen en worden de vragen en antwoorden geïdentificeerd.

    Nadat QnA Maker de knowledge base heeft gemaakt, wordt de pagina Knowledge Base geopend. U kunt de inhoud van de knowledge base op deze pagina bewerken.

Een nieuwe vraag-en-antwoordreeks toevoegen

  1. Selecteer in de QnA Maker-portal op de pagina Bewerken + Vraag-en-antwoordpaar toevoegen in de contextwerkbalk.

  2. Voeg de volgende vraag toe:

    How many Azure services are used by a knowledge base?

  3. Voeg het antwoord toe in markdown-indeling:

    * Azure QnA Maker service\n* Azure Cognitive Search\n* Azure web app\n* Azure app plan

    Voeg de vraag toe als tekst en het antwoord met markdown-indeling.

    Het markdownsymbool, *, wordt gebruikt voor opsommingstekens. De \n wordt gebruikt voor een nieuwe regel.

    Op de pagina Bewerken wordt de markdown weer gegeven. Wanneer u later het deelvenster Testen gebruikt, ziet u dat de markdown goed wordt weergegeven.

Opslaan en trainen

Selecteer in de rechterbovenhoek Save and train (Opslaan en trainen) om de wijzigingen op te slaan en QnA Maker te trainen. Bewerkingen worden alleen bewaard als ze worden opgeslagen.

De knowledge base testen

  1. Selecteer in de rechterbovenhoek van de QnA Maker-portal Testen om te testen of de wijzigingen worden toegepast.

  2. Voer in het tekstvak een voorbeeld van een gebruikersquery in.

    I want to know the difference between 32 bit and 64 bit Windows

    Voer in het tekstvak een voorbeeld van een gebruikersquery in.

  3. Selecteer Inspect (Inspecteren) om het antwoord gedetailleerder te onderzoeken. Het testvenster wordt gebruikt om uw wijzigingen in de knowledge base te testen voordat u uw knowledge base publiceert.

  4. Selecteer nogmaals Testen om het deelvenster Testen te sluiten.

De knowledge base publiceren

Wanneer u een knowledge base publiceert, wordt de inhoud van uw knowledge base verplaatst van de test-index naar een prod-index in Azure Search.

Schermafbeelding van het verplaatsen van de inhoud van uw knowledge base

  1. Selecteer in de QnA Maker-portal Publiceren. Selecteer vervolgens Publish (Publiceren) op de pagina om te bevestigen.

    De QnA Maker-service is nu gepubliceerd. U kunt het eindpunt in uw toepassing of botcode gebruiken.

    Schermopname van geslaagde publicatie

Een bot maken

Na het publiceren kunt u een bot maken op de pagina Publiceren:

  • U kunt snel een aantal bots maken, die allemaal verwijzen naar dezelfde knowledge base voor verschillende regio's of abonnementen voor de individuele bots.
  • Als u slechts één bot wilt gebruiken voor de knowledge base, gebruikt u de koppeling Alle bots weergeven in Azure Portal om een lijst met uw huidige bots weer te geven.

Wanneer u wijzigingen aanbrengt in de knowledge base en deze opnieuw publiceert, hoeft u geen verdere actie te ondernemen voor de bot. Deze is al geconfigureerd voor gebruik van de knowledge base en kan overweg met alle toekomstige wijzigingen in de knowledge base. Steeds wanneer u een knowledge base publiceert, worden alle bots die met de knowledge base zijn verbonden, automatisch bijgewerkt.

  1. Selecteer in de QnA Maker-portal op de pagina Publiceren de optie Bot maken. Deze knop wordt alleen weergegeven nadat u de knowledge base hebt gepubliceerd.

    Schermopname van het maken van een bot

  2. Er wordt een nieuw browsertabblad geopend voor Azure Portal, met daarin de pagina Maken van de Azure Bot Service. De Azure Bot Service configureren. De bot en QnA Maker kunnen het abonnement voor de web-appservice delen, maar ze kunnen de web-app niet delen. Dit betekent dat de naam van de app voor de bot anders moet zijn dan de naam van de app voor de QnA Maker-service.

    • Wel doen
      • Wijzig de gebruikersnaam van de bot als deze niet uniek is.
      • Selecteer de SDK-taal. Nadat de bot is gemaakt, kunt u de code downloaden naar uw lokale ontwikkelomgeving en het ontwikkelingsproces voortzetten.
    • Niet doen
      • De volgende instellingen wijzigen in de Azure-portal als u de bot maakt. Deze zijn vooraf ingevuld voor uw bestaande knowledge base:
        • QnA-verificatiesleutel
        • App Service-plan en -locatie

  3. Open de resource Botservice nadat de bot is gemaakt.

  4. Selecteer onder Botbeheer Testen in webchat.

  5. Voer in het chatbericht Typ uw bericht het volgende in:

    Azure services?

    De chatbot reageert met een antwoord uit uw knowledge base.

    Voer een gebruikersquery in om de webchat testen.

Wat hebt u gedaan?

U hebt een nieuwe knowledge base gemaakt, een openbare URL toegevoegd aan de knowledge base, uw eigen QnA-paar toegevoegd, getraind en getest, en de knowledge base gepubliceerd.

Nadat u de knowledge base hebt gepubliceerd, hebt u een bot gemaakt en de bot getest.

Dit is in een paar minuten gedaan zonder dat u code hoeft te schrijven of de inhoud moest opschonen.

Resources opschonen

Verwijder de QnA Maker- en Bot-framework-resources in Azure Portal als u niet verdergaat met de volgende quickstart.

Volgende stappen

Vragen toevoegen met metagegevens

Voor meer informatie: