Opvolgprompts gebruiken om meerdere beurten in een gesprek te maken
Gebruik vervolgprompts en context om de meerdere bochten, ook wel multi-turn genoemd, te beheren voor uw bot van de ene vraag naar de andere.
Bekijk de volgende demonstratievideo om te zien hoe multi-turn werkt:
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.
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 presenteren met vervolgprompts.
Wanneer een gebruiker een vraag stelt, retourneert QnA Maker het antwoord en eventuele vervolgprompts. Met dit antwoord kunt u de vervolgvragen als keuzes presenteren.
Let op
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:
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.
Een bot met meerdere inleveren gebruiken
Nadat u uw KB hebt gepubliceerd, kunt u de knop Bot maken selecteren om uw QnA Maker-bot te implementeren in Azure AI Bot Service. De prompts worden weergegeven in de chatclients die u hebt ingeschakeld voor uw bot.
Een gesprek met meerdere paden maken op basis van de structuur van een document
Wanneer u een knowledge base maakt, wordt in de sectie KB vullen het selectievakje Voor het inschakelen van url's met meerdere paden weergegeven, .pdf of .docx bestanden .
Wanneer u deze optie selecteert, extraheert QnA Maker de hiërarchie die aanwezig is in de documentstructuur. De hiërarchie wordt geconverteerd naar vervolgprompts en de hoofdmap van de hiërarchie fungeert als de bovenliggende QnA. In sommige documenten heeft de hoofdmap van de hiërarchie geen inhoud, die als antwoord kan dienen. U kunt de standaardantwoordtekst opgeven die moet worden gebruikt als een vervangende antwoordtekst om dergelijke hiërarchieën te extraheren.
Structuur met meerdere bochten kan alleen worden afgeleid uit URL's, PDF-bestanden of DOCX-bestanden. Bekijk een afbeelding van een handmatig PDF-bestand van Microsoft Surface voor een voorbeeld van een structuur.
Uw eigen document met meerdere bochten bouwen
Als u een document met meerdere onderdelen 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 en h2 aan te geven 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 extraheert de prompts met meerdere keren niet.
Het eerste teken van de kop moet een hoofdletter hebben.
Beëindig een kop niet met een vraagteken.
?U kunt het voorbeelddocument als voorbeeld gebruiken om uw eigen multi-turn document te maken.
Bestanden toevoegen aan een KB met meerdere bochten
Wanneer u een hiërarchisch document toevoegt, bepaalt QnA Maker vervolgprompts van de structuur om een gespreksstroom te maken.
- Selecteer in QnA Maker een bestaande knowledge base, die is gemaakt met extractie met meerdere paden inschakelen op URL's, .pdf of .docx bestanden ingeschakeld.
- Ga naar de pagina Instellingen , selecteer het bestand of de URL die u wilt toevoegen.
- Sla de knowledge base op en train deze .
Let op
Ondersteuning voor het gebruik van een geëxporteerd TSV- of XLS-knowledge base-bestand met meerdere draaiingen als gegevensbron voor een nieuwe of lege Knowledge Base wordt niet ondersteund. U moet dat bestandstype importeren op de pagina Instellingen van de QnA Maker-portal om geëxporteerde prompts voor meerdere keren toe te voegen aan een Knowledge Base.
Een knowledge base maken met prompts met meerdere beurten met de Create-API
U kunt een kenniscase maken met prompts met meerdere beurten met behulp van de QnA Maker Create-API. De prompts worden toegevoegd aan de matrix van prompts de context eigenschap.
Vragen en antwoorden weergeven met context
Verminder de weergegeven vraag-en-antwoordparen tot alleen die paren met contextuele gesprekken.
Selecteer Weergaveopties en selecteer vervolgens Context weergeven. In de lijst worden vraag-en-antwoordparen weergegeven die vervolgprompts bevatten.
De context met meerdere beurten wordt weergegeven in de eerste kolom.
In de voorgaande afbeelding geeft #1 vetgedrukte tekst in de kolom aan, waarmee de huidige vraag wordt aangegeven. De bovenliggende vraag is het bovenste item in de rij. Alle onderstaande vragen 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.
Voeg een vervolgprompt toe aan een bestaand vraag-en-antwoordpaar dat momenteel niet is gekoppeld. Omdat de vraag niet is gekoppeld aan een vraag-en-antwoordpaar, moet de huidige weergave-instelling worden gewijzigd.
Als u een bestaand vraag-en-antwoordpaar wilt koppelen als vervolgprompt, selecteert u de rij voor het vraag-en-antwoordpaar. Zoek voor de Surface-handleiding naar Afmelden om de lijst te verminderen.
Selecteer in de rij voor Afmelden in de kolom Antwoord de prompt Opvolgen toevoegen.
Voer in de velden in het pop-upvenster Vervolgprompt 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 aangeeft. Koppeling naar antwoord Voer het aanmeldingsscherm in om het bestaande vraag-en-antwoordpaar te vinden. Eén overeenkomst wordt geretourneerd. Selecteer dit antwoord als opvolgen en selecteer Vervolgens Opslaan.
Nadat u de vervolgprompt hebt toegevoegd, selecteert u Opslaan en trainen in de bovenste navigatiebalk.
De weergavetekst bewerken
Wanneer er een vervolgprompt wordt gemaakt en er een bestaand vraag-en-antwoordpaar wordt ingevoerd als koppeling naar antwoord, kunt u nieuwe weergavetekst invoeren. Deze tekst vervangt de bestaande vraag niet en er wordt geen nieuwe alternatieve vraag toegevoegd. Deze waarden zijn gescheiden van die waarden.
Als u de weergavetekst wilt bewerken, zoekt en selecteert u de vraag in het contextveld.
Selecteer in de rij voor die vraag de vervolgprompt in de antwoordkolom.
Selecteer de weergavetekst die u wilt bewerken en selecteer vervolgens Bewerken.
Wijzig de bestaande weergavetekst in het pop-upvenster Vervolgprompt .
Wanneer u klaar bent met het bewerken van de weergavetekst, selecteert u Opslaan.
Sla op de bovenste navigatiebalk op en train deze.
Een nieuw vraag-en-antwoordpaar toevoegen als vervolgprompt
Wanneer u een nieuw vraag-en-antwoordpaar aan de Knowledge Base toevoegt, moet elk paar als vervolgprompt aan een bestaande vraag worden gekoppeld.
Zoek en selecteer op de werkbalk van de Knowledge Base het bestaande vraag-en-antwoordpaar voor Accounts en aanmelden.
Selecteer de vervolgprompt toevoegen in de kolom Antwoord voor deze vraag.
Maak onder Vervolgprompt (PREVIEW) een nieuwe vervolgprompt 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 aangeeft. 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.
Selecteer Nieuwe maken en selecteer Vervolgens Opslaan.
Met deze actie maakt u een nieuw vraag-en-antwoordpaar en koppelt u de geselecteerde vraag als vervolgprompt. De contextkolom geeft voor beide vragen een vervolgpromptrelatie aan.
Selecteer Weergaveopties en selecteer vervolgens Context weergeven (PREVIEW).
De nieuwe vraag laat zien hoe deze is gekoppeld.
De bovenliggende vraag geeft een nieuwe vraag weer als een van de keuzen.
Nadat u de vervolgprompt hebt toegevoegd, selecteert u Opslaan en trainen in de bovenste navigatiebalk.
Meerdere beurten weergeven tijdens het testen van vervolgprompts
Wanneer u de vraag test met vervolgprompts in het deelvenster Test , bevat het antwoord 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 aan te vragen en opvolgingsprompts op te nemen.
{
"question": "accounts and signing in",
"top": 10,
"userId": "Default",
"isTest": false,
"context": {}
}
Een JSON-antwoord om een eerste antwoord en vervolgprompts te retourneren
In de voorgaande sectie is een antwoord gevraagd en eventuele vervolgprompts voor accounts en aanmelden. Het antwoord bevat de promptgegevens, die zich bevinden op answers[0].contexten de tekst die aan de gebruiker moet worden weergegeven.
{
"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 opties in de gespreksstroom en vervolgens de geselecteerde qnaId terugsturen naar QnA Maker in de volgende aanvraag.
Een JSON-aanvraag voor het retourneren van een niet-eerste antwoord en opvolgingsprompts
Vul het context object in om de vorige context op te nemen.
In de volgende JSON-aanvraag is de huidige vraag Windows Hello gebruiken om u aan te melden en was de vorige vraag 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": []
}
}
]
}
Query's 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 aanvraagtekst van de vervolgprompt. Als de hoofdtekst van de aanvraag de qnaIden het contextobject (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 op de vraagtekst te vinden.
Weergavevolgorde wordt ondersteund in de Update-API
De weergavetekst en weergavevolgorde, geretourneerd in het JSON-antwoord, worden ondersteund voor bewerking door de Update-API.
Prompts met meerdere beurten toevoegen of verwijderen met de Update-API
U kunt prompts met meerdere keren toevoegen of verwijderen met behulp van de QnA Maker Update-API. De prompts worden toegevoegd aan de matrix van de context eigenschap promptsToAdd en de promptsToDelete matrix.
Knowledge Base exporteren voor versiebeheer
QnA Maker ondersteunt versiebeheer door gespreksstappen met meerdere paden in het geëxporteerde bestand op te nemen.
Volgende stappen
- Meer informatie over contextuele gesprekken in dit dialoogvenstervoorbeeld of meer informatie over conceptueel botontwerp voor gesprekken met meerdere paden.