Opvolgprompts gebruiken om meerdere beurten in een gesprek te maken

Gebruik opvolgingsprompts en context om de meerdere beurten, ook wel multi-turn genoemd, voor uw bot van de ene vraag naar de andere te beheren.

Bekijk de volgende demonstratievideo om te zien hoe multi-turn werkt:

Gesprek met meerdere paden in QnA Maker

Notitie

De QnA Maker-service wordt op 31 maart 2025 buiten gebruik gesteld. Er is nu een nieuwere versie van de vraag- en antwoordmogelijkheid beschikbaar als onderdeel van Azure Cognitive Service for Language. Zie Vragen beantwoorden voor de mogelijkheden voor het beantwoorden van vragen in de Taalservice. Vanaf 1 oktober 2022 kunt u geen nieuwe QnA Maker-resources meer maken. Raadpleeg de migratiehandleiding voor informatie over het migreren van bestaande QnA Maker-knowledge bases naar het beantwoorden van vragen.

Wat is een gesprek met meerdere paden?

Sommige vragen kunnen niet in één keer worden beantwoord. Wanneer u uw clienttoepassingsgesprekken (chatbot) ontwerpt, kan een gebruiker een vraag stellen die moet worden gefilterd of verfijnd om het juiste antwoord te bepalen. U maakt deze stroom door de vragen mogelijk door de gebruiker te voorzien van vervolgprompts.

Wanneer een gebruiker een vraag stelt, retourneert QnA Maker het antwoord en eventuele vervolgprompts. Met dit antwoord kunt u de vervolgvragen als keuzen presenteren.

Waarschuwing

Prompts met meerdere paden worden niet geëxtraheerd uit documenten met veelgestelde vragen. Als u extractie met meerdere paden nodig hebt, verwijdert u de vraagtekens die de QnA-paren als veelgestelde vragen aanwijzen.

Voorbeeld van een gesprek met meerdere paden met een chatbot

Met meerdere paden beheert een chatbot een gesprek met een gebruiker om het uiteindelijke antwoord te bepalen, zoals wordt weergegeven in de volgende afbeelding:

Een dialoogvenster met meerdere paden met prompts die een gebruiker door een gesprek leiden

In de voorgaande afbeelding heeft een gebruiker een gesprek gestart door Mijn account in te voeren. De Knowledge Base heeft drie gekoppelde vraag-en-antwoordparen. Om het antwoord te verfijnen, selecteert de gebruiker een van de drie opties in de Knowledge Base. De vraag (#1) heeft drie vervolgprompts, die in de chatbot worden weergegeven als drie opties (#2).

Wanneer de gebruiker een optie (#3) selecteert, wordt de volgende lijst met verfijningsopties (#4) weergegeven. Deze reeks gaat door (#5) totdat de gebruiker het juiste, laatste antwoord (#6) bepaalt.

Meerdere keren gebruiken in een bot

Nadat u uw KB hebt gepubliceerd, kunt u de knop Bot maken selecteren om uw QnA Maker-bot te implementeren in de Azure Bot-service. De prompts worden weergegeven in de chatclients die u hebt ingeschakeld voor uw bot.

Een gesprek met meerdere paden maken op de structuur van een document

Wanneer u een Knowledge Base maakt, wordt in de sectie Uw KB vullen het selectievakje Extractie van URL's, .pdf of .docx-bestanden inschakelen weergegeven.

Selectievakje voor het inschakelen van extraheren met meerdere paden

Wanneer u deze optie selecteert, extraheert QnA Maker de hiërarchie die aanwezig is in de documentstructuur. De hiërarchie wordt geconverteerd in om prompts op te volgen en de hoofdmap van de hiërarchie fungeert als de bovenliggende QnA. In sommige documenten bevat de hoofdmap van de hiërarchie geen inhoud, die als antwoord kan dienen. U kunt de standaardantwoordtekst opgeven die als vervangende antwoordtekst moet worden gebruikt om dergelijke hiërarchieën te extraheren.

Structuur met meerdere bochten kan alleen worden afgeleid uit URL's, PDF-bestanden of DOCX-bestanden. Voor een voorbeeld van structuur bekijkt u een afbeelding van een PDF-bestand met de gebruikershandleiding van een Microsoft Surface.

Schermopname van een voorbeeld van de structuur in een gebruikershandleiding.

Uw eigen multi-turn document bouwen

Als u een document met meerdere bewerkingen maakt, moet u rekening houden met de volgende richtlijnen:

  • Gebruik koppen en subkoppen om de hiërarchie aan te geven. Gebruik bijvoorbeeld een h1 om de bovenliggende QnA aan te geven en h2 om de QnA aan te geven die als prompt moet worden beschouwd. Gebruik kleine kopgrootte om de volgende hiërarchie aan te geven. Gebruik geen stijl, kleur of een ander mechanisme om structuur in uw document te impliceren. QnA Maker haalt de prompts met meerdere bewerkingen niet op.

  • Het eerste teken van de kop moet een hoofdletter hebben.

  • Eindig een kop niet met een vraagteken, ?.

  • U kunt het voorbeelddocument als voorbeeld gebruiken om uw eigen document met meerdere bewerkingen te maken.

Bestanden toevoegen aan een KB met meerdere bochten

Wanneer u een hiërarchisch document toevoegt, bepaalt QnA Maker de opvolgingsprompts van de structuur om een gespreksstroom te maken.

  1. Selecteer in QnA Maker een bestaande Knowledge Base, die is gemaakt met Enable multi-turn extraction from URLLs, .pdf or .docx files ingeschakeld.
  2. Ga naar de pagina Instellingen en selecteer het bestand of de URL die u wilt toevoegen.
  3. Sla de Knowledge Base op en train deze.

Waarschuwing

Ondersteuning voor het gebruik van een geëxporteerd TSV- of XLS-Knowledge Base-bestand als gegevensbron voor een nieuwe of lege Knowledge Base wordt niet ondersteund. U moet dat bestandstype importeren vanaf de pagina Instellingen van de QnA Maker-portal om geëxporteerde prompts met meerdere bewerkingen toe te voegen aan een Knowledge Base.

Maak Knowledge Base met prompts met meerdere bewerkingen met de API maken

U kunt een kenniscase maken met prompts met meerdere bewerkingen met behulp van de QnA Maker Create-API. De prompts worden toegevoegd in de matrix van prompts de context eigenschap.

Vragen en antwoorden weergeven met context

Verminder de weergegeven vraag-en-antwoordparen tot alleen paren met contextuele gesprekken.

Selecteer Weergaveopties en selecteer vervolgens Context weergeven. In de lijst worden vraag-en-antwoordparen weergegeven die vervolgprompts bevatten.

Vraag-en-antwoordparen filteren op contextuele gesprekken

De context met meerdere bochten wordt weergegeven in de eerste kolom.

Schermopname met de sectie Context gemarkeerd.

In de voorgaande afbeelding geeft #1 vetgedrukte tekst aan in de kolom, wat de huidige vraag aangeeft. De bovenliggende vraag is het bovenste item in de rij. Alle vragen eronder zijn de gekoppelde vraag-en-antwoordparen. Deze items kunnen worden geselecteerd, zodat u direct naar de andere contextitems kunt gaan.

Een bestaand vraag-en-antwoordpaar toevoegen als vervolgprompt

De oorspronkelijke vraag, Mijn account, bevat vervolgprompts, zoals Accounts en aanmelden.

De antwoorden en opvolgingsprompts 'Accounts en aanmelden'

Voeg een vervolgprompt toe aan een bestaand vraag-en-antwoord-paar dat momenteel niet is gekoppeld. Omdat de vraag niet is gekoppeld aan een vraag-en-antwoord-paar, moet de huidige weergave-instelling worden gewijzigd.

  1. Als u een bestaand vraag-en-antwoordpaar wilt koppelen als een vervolgprompt, selecteert u de rij voor het vraag-en-antwoord-paar. Zoek voor de Surface-handleiding naar Afmelden om de lijst te verkleinen.

  2. Selecteer in de rij voor Afmelden in de kolom Antwoord de optie Opvolgingsprompt toevoegen.

  3. Voer in de velden in het pop-upvenster Follow-upprompt de volgende waarden in:

    Veld Waarde
    Weergavetekst Voer Het apparaat uitschakelen in. Dit is aangepaste tekst die moet worden weergegeven in de vervolgprompt.
    Alleen context Schakel dit selectievakje in. Een antwoord wordt alleen geretourneerd als de vraag context opgeeft.
    Koppeling naar antwoord Voer Het aanmeldingsscherm gebruiken in om het bestaande vraag-en-antwoord-paar te zoeken.
  4. Er wordt één overeenkomst geretourneerd. Selecteer dit antwoord als follow-up en selecteer vervolgens Opslaan.

    De pagina 'Vervolgprompt'

  5. Nadat u de opvolgingsprompt hebt toegevoegd, selecteert u Opslaan en trainen in de bovenste navigatiebalk.

De weergavetekst bewerken

Wanneer er een vervolgprompt wordt gemaakt en een bestaand vraag-en-antwoordpaar wordt ingevoerd als koppeling naar antwoord, kunt u nieuwe weergavetekst invoeren. Deze tekst vervangt de bestaande vraag niet en voegt geen nieuwe alternatieve vraag toe. Het staat los van deze waarden.

  1. Als u de weergavetekst wilt bewerken, zoekt en selecteert u de vraag in het veld Context .

  2. Selecteer in de rij voor die vraag de vervolgprompt in de antwoordkolom.

  3. Selecteer de weergavetekst die u wilt bewerken en selecteer vervolgens Bewerken.

    De opdracht Bewerken voor de weergavetekst

  4. Wijzig de bestaande weergavetekst in het pop-upvenster van de vervolgprompt .

  5. Wanneer u klaar bent met het bewerken van de weergavetekst, selecteert u Opslaan.

  6. Opslaan en trainen in de bovenste navigatiebalk.

Een nieuw vraag-en-antwoordpaar toevoegen als een opvolgingsprompt

Wanneer u een nieuw vraag-en-antwoordpaar toevoegt aan de Knowledge Base, moet elk paar worden gekoppeld aan een bestaande vraag als vervolgprompt.

  1. Zoek en selecteer op de werkbalk Knowledge Base het bestaande vraag-en-antwoordpaar voor Accounts en meld u aan.

  2. Selecteer in de kolom Antwoord voor deze vraag de optie Vervolgprompt toevoegen.

  3. Maak onder Opvolgingsprompt (PREVIEW) een nieuwe opvolgingsprompt door de volgende waarden in te voeren:

    Veld Waarde
    Weergavetekst Maak een Windows-account. De aangepaste tekst die moet worden weergegeven in de vervolgprompt.
    Alleen context Schakel dit selectievakje in. Dit antwoord wordt alleen geretourneerd als de vraag context specificeert.
    Koppeling naar antwoord Voer de volgende tekst in als antwoord:
    Maak een Windows-account met een nieuw of bestaand e-mailaccount.
    Wanneer u de database opslaat en traint, wordt deze tekst geconverteerd.

    Een nieuwe promptvraag en -antwoord maken

  4. Selecteer Nieuwe maken en selecteer vervolgens Opslaan.

    Met deze actie maakt u een nieuw vraag-en-antwoord-paar en koppelt u de geselecteerde vraag als een vervolgprompt. De kolom Context geeft voor beide vragen een vervolgpromptrelatie aan.

  5. Selecteer Weergaveopties en selecteer vervolgens Context weergeven (PREVIEW).

    De nieuwe vraag laat zien hoe deze is gekoppeld.

    Een nieuwe opvolgingsprompt maken

    De bovenliggende vraag geeft een nieuwe vraag weer als een van de keuzen.

    Schermopname van de kolom Context, die voor beide vragen een vervolgpromptrelatie aangeeft.

  6. Nadat u de opvolgingsprompt hebt toegevoegd, selecteert u Opslaan en trainen in de bovenste navigatiebalk.

Meerdere beurten weergeven tijdens het testen van opvolgingsprompts

Wanneer u de vraag test met vervolgprompts in het testvenster, bevat het antwoord de vervolgprompts.

Het antwoord bevat de vervolgprompts

Een JSON-aanvraag om een eerste antwoord en opvolgingsprompts te retourneren

Gebruik het lege context object om het antwoord op de vraag van de gebruiker op te vragen en vervolgprompts op te nemen.

{
  "question": "accounts and signing in",
  "top": 10,
  "userId": "Default",
  "isTest": false,
  "context": {}
}

Een JSON-antwoord om een eerste antwoord en opvolgingsprompts te retourneren

In de vorige sectie werd gevraagd om een antwoord en eventuele vervolgprompts voor Accounts en aanmelden. Het antwoord bevat de promptinformatie, die zich bevindt op answers[0].context, en de tekst die moet worden weergegeven voor de gebruiker.

{
    "answers": [
        {
            "questions": [
                "Accounts and signing in"
            ],
            "answer": "**Accounts and signing in**\n\nWhen you set up your Surface, an account is set up for you. You can create additional accounts later for family and friends, so each person using your Surface can set it up just the way he or she likes. For more info, see All about accounts on Surface.com. \n\nThere are several ways to sign in to your Surface Pro 4: ",
            "score": 100.0,
            "id": 15,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": [
                    {
                        "displayOrder": 0,
                        "qnaId": 16,
                        "qna": null,
                        "displayText": "Use the sign-in screen"
                    }
                ]
            }
        },
        {
            "questions": [
                "Sign out"
            ],
            "answer": "**Sign out**\n\nHere's how to sign out: \n\n  Go to Start, and right-click your name. Then select Sign out. ",
            "score": 38.01,
            "id": 18,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": [
                    {
                        "displayOrder": 0,
                        "qnaId": 16,
                        "qna": null,
                        "displayText": "Turn off the device"
                    }
                ]
            }
        },
        {
            "questions": [
                "Use the sign-in screen"
            ],
            "answer": "**Use the sign-in screen**\n\n1.  \n\nTurn on or wake your Surface by pressing the power button. \n\n2.  \n\nSwipe up on the screen or tap a key on the keyboard. \n\n3.  \n\nIf you see your account name and account picture, enter your password and select the right arrow or press Enter on your keyboard. \n\n4.  \n\nIf you see a different account name, select your own account from the list at the left. Then enter your password and select the right arrow or press Enter on your keyboard. ",
            "score": 27.53,
            "id": 16,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": []
            }
        }
    ]
}

De prompts matrix bevat tekst in de displayText eigenschap en de qnaId waarde. U kunt deze antwoorden weergeven als de volgende weergegeven keuzes in de gespreksstroom en vervolgens de geselecteerde qnaId terugsturen naar QnA Maker in de volgende aanvraag.

Een JSON-aanvraag om een niet-initiële antwoord en opvolgingsprompts te retourneren

Vul het context object in om de vorige context op te nemen.

In de volgende JSON-aanvraag is de huidige vraag Gebruik Windows Hello om u aan te melden. De vorige vraag was accounts en aanmelden.

{
  "question": "Use Windows Hello to sign in",
  "top": 10,
  "userId": "Default",
  "isTest": false,
  "qnaId": 17,
  "context": {
    "previousQnAId": 15,
    "previousUserQuery": "accounts and signing in"
  }
}

Een JSON-antwoord om een niet-eerste antwoord en vervolgprompts te retourneren

Het JSON-antwoord QnA Maker GenerateAnswer bevat de vervolgprompts in de context eigenschap van het eerste item in het answers object:

{
    "answers": [
        {
            "questions": [
                "Use Windows Hello to sign in"
            ],
            "answer": "**Use Windows Hello to sign in**\n\nSince Surface Pro 4 has an infrared (IR) camera, you can set up Windows Hello to sign in just by looking at the screen. \n\nIf you have the Surface Pro 4 Type Cover with Fingerprint ID (sold separately), you can set up your Surface sign you in with a touch. \n\nFor more info, see What is Windows Hello? on Windows.com. ",
            "score": 100.0,
            "id": 17,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": []
            }
        },
        {
            "questions": [
                "Meet Surface Pro 4"
            ],
            "answer": "**Meet Surface Pro 4**\n\nGet acquainted with the features built in to your Surface Pro 4. \n\nHere's a quick overview of Surface Pro 4 features: \n\n\n\n\n\n\n\nPower button \n\n\n\n\n\nPress the power button to turn your Surface Pro 4 on. You can also use the power button to put it to sleep and wake it when you're ready to start working again. \n\n\n\n\n\n\n\nTouchscreen \n\n\n\n\n\nUse the 12.3" display, with its 3:2 aspect ratio and 2736 x 1824 resolution, to watch HD movies, browse the web, and use your favorite apps. \n\nThe new Surface G5 touch processor provides up to twice the touch accuracy of Surface Pro 3 and lets you use your fingers to select items, zoom in, and move things around. For more info, see Surface touchscreen on Surface.com. \n\n\n\n\n\n\n\nSurface Pen \n\n\n\n\n\nEnjoy a natural writing experience with a pen that feels like an actual pen. Use Surface Pen to launch Cortana in Windows or open OneNote and quickly jot down notes or take screenshots. \n\nSee Using Surface Pen (Surface Pro 4 version) on Surface.com for more info. \n\n\n\n\n\n\n\nKickstand \n\n\n\n\n\nFlip out the kickstand and work or play comfortably at your desk, on the couch, or while giving a hands-free presentation. \n\n\n\n\n\n\n\nWi-Fi and Bluetooth® \n\n\n\n\n\nSurface Pro 4 supports standard Wi-Fi protocols (802.11a/b/g/n/ac) and Bluetooth 4.0. Connect to a wireless network and use Bluetooth devices like mice, printers, and headsets. \n\nFor more info, see Add a Bluetooth device and Connect Surface to a wireless network on Surface.com. \n\n\n\n\n\n\n\nCameras \n\n\n\n\n\nSurface Pro 4 has two cameras for taking photos and recording video: an 8-megapixel rear-facing camera with autofocus and a 5-megapixel, high-resolution, front-facing camera. Both cameras record video in 1080p, with a 16:9 aspect ratio. Privacy lights are located on the right side of both cameras. \n\nSurface Pro 4 also has an infrared (IR) face-detection camera so you can sign in to Windows without typing a password. For more info, see Windows Hello on Surface.com. \n\nFor more camera info, see Take photos and videos with Surface and Using autofocus on Surface 3, Surface Pro 4, and Surface Book on Surface.com. \n\n\n\n\n\n\n\nMicrophones \n\n\n\n\n\nSurface Pro 4 has both a front and a back microphone. Use the front microphone for calls and recordings. Its noise-canceling feature is optimized for use with Skype and Cortana. \n\n\n\n\n\n\n\nStereo speakers \n\n\n\n\n\nStereo front speakers provide an immersive music and movie playback experience. To learn more, see Surface sound, volume, and audio accessories on Surface.com. \n\n\n\n\n",
            "score": 21.92,
            "id": 3,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": [
                    {
                        "displayOrder": 0,
                        "qnaId": 4,
                        "qna": null,
                        "displayText": "Ports and connectors"
                    }
                ]
            }
        },
        {
            "questions": [
                "Use the sign-in screen"
            ],
            "answer": "**Use the sign-in screen**\n\n1.  \n\nTurn on or wake your Surface by pressing the power button. \n\n2.  \n\nSwipe up on the screen or tap a key on the keyboard. \n\n3.  \n\nIf you see your account name and account picture, enter your password and select the right arrow or press Enter on your keyboard. \n\n4.  \n\nIf you see a different account name, select your own account from the list at the left. Then enter your password and select the right arrow or press Enter on your keyboard. ",
            "score": 19.04,
            "id": 16,
            "source": "product-manual.pdf",
            "metadata": [],
            "context": {
                "isContextOnly": true,
                "prompts": []
            }
        }
    ]
}

Een query uitvoeren op de Knowledge Base met de QnA Maker-id

Als u een aangepaste toepassing bouwt, worden in het antwoord van de eerste vraag eventuele vervolgprompts en de bijbehorende qnaId prompts geretourneerd. Nu u de id hebt, kunt u deze doorgeven in de aanvraagbody van de vervolgprompt. Als de aanvraagbody de qnaIden het contextobject bevat (dat de vorige QnA Maker-eigenschappen bevat), retourneert GenerateAnswer de exacte vraag op id, in plaats van het classificatie-algoritme te gebruiken om het antwoord te vinden op basis van de vraagtekst.

Weergavevolgorde wordt ondersteund in de Update-API

De weergavetekst en weergavevolgorde die worden geretourneerd in het JSON-antwoord, worden ondersteund voor bewerking door de Update-API.

Prompts met meerdere bewerkingen toevoegen of verwijderen met de Update-API

U kunt prompts met meerdere bochten toevoegen of verwijderen met behulp van de QnA Maker Update-API. De prompts worden toegevoegd in de matrix van promptsToAdd de context eigenschap en de promptsToDelete matrix.

Knowledge Base exporteren voor versiebeheer

QnA Maker ondersteunt versiebeheer door het opnemen van gespreksstappen met meerdere paden in het geëxporteerde bestand.

Volgende stappen