Zelfstudie: uw Knowledge Base toevoegen aan Power Virtual Agents

Maak een bot met Power Virtual Agents en breid deze uit om antwoorden uit uw Knowledge Base op te halen.

In deze zelfstudie leert u het volgende:

Een agent integreren met een Knowledge Base

Met Power Virtual Agents kunnen teams zonder code te schrijven krachtige bots maken met behulp van een begeleide grafische interface. U hebt dus geen gegevenswetenschappers of ontwikkelaars nodig.

In Power Virtual Agents maakt u een agent met een reeks onderwerpen (onderwerpgebieden) om vragen van gebruikers te beantwoorden door acties uit te voeren. Als er geen antwoord wordt gevonden, kan via een terugvalactie een standaardantwoord worden gegeven.

Configureer de agent om de vraag naar uw Knowledge Base te verzenden als onderdeel van de actie van een onderwerp, of als onderdeel van het onderwerppad Systeemterugval. Ze gebruiken beide een actie om verbinding te maken met uw Knowledge Base en een antwoord te retourneren.

Power Automate maakt verbinding met actie GenerateAnswer

Als u uw agent wilt verbinden met uw Knowledge Base, gebruikt u Power Automate om de actie te maken. Power Automate biedt een processtroom die verbinding maakt met de API GenerateAnswer van QnA Maker.

Nadat u de stroom hebt ontworpen en opgeslagen, is deze beschikbaar in een Power Automate-oplossing. Gebruik deze oplossing als een actie in uw agent.

Een agent verbinden met uw Knowledge Base

Hier volgt een overzicht van de stappen die nodig zijn om een agent in Power Virtual Agents te verbinden met een Knowledge Base in QnA Maker.

• In de portal van QnA Maker:
  • Stel de Knowledge Base samen en publiceer deze.
  • Kopieer de gegevens van uw Knowledge Base, zoals de id, de runtime-eindpuntsleutel en de runtime-eindpunthost.
• In de portal van Power Virtual Agents:
  • Bouw een onderwerp voor de agent.
  • Roep een actie aan (in Power Automate).
• In de portal van Power Automate:
  • Zoek de sjabloon Generate answers using QnA Maker.
  • Gebruik de sjabloon om de stroom te configureren voor het gebruik van GenerateAnswer van QnA Maker.
    • In QnA Maker gepubliceerde gegevens van de Knowledge Base:
      • Id van de Knowledge Base
      • Eindpunthost voor QnA Maker-resource
      • Eindpuntsleutel voor QnA Maker-resource
    • Invoer - gebruikersquery
    • Uitvoer - antwoord uit de Knowledge Base
  • Maak een oplossing en voeg de stroom toe, of voeg de stroom toe aan een bestaande oplossing.
• Ga terug naar Power Virtual Agents:
  • Selecteer de uitvoer van de oplossing als een bericht voor een onderwerp.

Een knowledge base maken

1. Volg de quickstart om een Knowledge Base te maken. Het laatste gedeelte, over het maken van een bot, hoeft u niet te doen. Gebruik in plaats daarvan deze zelfstudie om een bot te maken met Power Virtual Agents.

   

   Neem de gepubliceerde Knowledge Base-instellingen (op de pagina Settings) over in de portal van QnA Maker. U hebt deze gegevens nodig voor de Power Automate-stap om de verbinding met GenerateAnswer van QnA Maker te configureren.

2. Zoek in de QnA Maker-portal op de pagina Settings de eindpuntsleutel, de eindpunthost en de Knowledge Base-id.

Een agent maken in Power Virtual Agents

1. Meld u aan bij Power Virtual Agents. Gebruik uw schoolaccount of e-mailaccount van het werk.

2. Als dit uw eerste bot is, komt u op de startpagina van de agent. Als dit niet uw eerste bot is, selecteert u de bot in de rechterbovenhoek van de pagina en selecteert u + Nieuwe bot.

   

Onderwerpen in de bot

De agent gebruikt de verzameling onderwerpen voor het beantwoorden van vragen in uw onderwerpgebied. In deze zelfstudie bevat de agent al verschillende onderwerpen, onderverdeeld in gebruikersonderwerpen en systeemonderwerpen.

Selecteer Onderwerpen in het navigatiemenu aan de linkerkant om de onderwerpen te zien die standaard beschikbaar zijn.

Het onderwerp voor systeemterugval maken

Hoewel de agent vanuit elk onderwerp verbinding kan maken met uw Knowledge Base, gebruiken we in deze zelfstudie het onderwerp systeemterugval. Het terugvalonderwerp wordt gebruikt wanneer de agent geen antwoord kan vinden. De agent geeft de tekst van de gebruiker door aan de API GenerateAnswer van QnA Maker, ontvangt het antwoord uit de Knowledge Base en geeft dit als een bericht weer aan de gebruiker.

1. Ga naar de portal van Power Virtual Agents en selecteer rechtsboven Instellingen (pictogram van een tandwiel). Selecteer vervolgens Systeemterugval.

   

2. Selecteer + Toevoegen om een terugvalonderwerp voor het systeem toe te voegen.

   

3. Nadat het onderwerp is toegevoegd, selecteert u Naar terugvalonderwerp gaan om het terugvalonderwerp te maken op het ontwerpcanvas.

   Tip

   Als u terug wilt naar het terugvalonderwerp, kunt u het vinden in de sectie Onderwerpen, in het gedeelte Systeemonderwerpen.

Het ontwerpcanvas gebruiken om een actie toe te voegen

Gebruik het ontwerpcanvas van Power Virtual Agents om het terugvalonderwerp te koppelen aan uw Knowledge Base. Het onderwerp begint met de niet-herkende gebruikerstekst. Voeg een actie toe waarmee deze tekst wordt doorgegeven aan QnA Maker, waarna het antwoord als een bericht wordt weergegeven. De laatste stap is het weergeven van een antwoord. Dit wordt als een afzonderlijke stap behandeld, verderop in deze zelfstudie.

In dit gedeelte maakt u de gespreksstroom voor het terugvalonderwerp.

1. De nieuwe terugvalactie bevat mogelijk al elementen in de gespreksstroom. Verwijder het item Escaleren door het menu Opties te selecteren.

   

2. Selecteer de connector + naar het vak Bericht en selecteer vervolgens Een actie aanroepen.

   

3. Selecteer Een stroom maken. U gaat nu naar de portal van Power Automate.

   

   Power Automate wordt geopend met een nieuwe sjabloon. U gaat deze nieuwe sjabloon niet gebruiken.

   

Een Power Automate-stroom maken om te verbinden met uw Knowledge Base

Met de volgende procedure maakt u een Power Automate-stroom die het volgende doet:

• Ontvangt de inkomende tekst van de gebruiker en verstuurt deze naar QnA Maker.
• Retourneert het eerste antwoord naar uw agent.

1. Selecteer in Power Automate Sjablonen in het navigatiemenu aan de linkerkant. Als er wordt gevraagd of u de browserpagina wilt verlaten, bevestigt u dat.

2. Zoek op de pagina met sjablonen naar de sjabloon Generate answers using QnA Maker en selecteer vervolgens de sjabloon. Deze sjabloon bevat alle stappen voor het aanroepen van QnA Maker met de instellingen van uw Knowledge Base en het retourneren van het eerste antwoord.

3. Selecteer Doorgaan op het nieuwe scherm voor de QnA Maker-stroom.

   

4. Selecteer het actievak Antwoord genereren en vul uw QnA Maker-instellingen in vanuit een vorige sectie met de titel Een knowledge base maken. Servicehost in de volgende afbeelding verwijst naar de host van uw Knowledge Base (Host) en heeft de indeling https://YOUR-RESOURCE-NAME.azurewebsites.net/qnamaker.

   

5. Selecteer Opslaan om de stroom op te slaan.

Een oplossing maken en de stroom toevoegen

De agent kan de stroom alleen vinden en er verbinding mee maken als de stroom is opgenomen in een Power Automate-oplossing.

1. Selecteer in de portal van Power Automate Oplossingen in het navigatiemenu aan de linkerkant.

2. Selecteer + Nieuwe oplossing

3. Voer een weergavenaam in. De lijst met oplossingen bevat elke oplossing in uw organisatie of school. Kies een naamconventie waarmee u kunt filteren op alleen uw oplossingen. U kunt bijvoorbeeld uw e-mailadres als voorvoegsel toevoegen aan de naam van de oplossing: jondoe-power-virtual-agent-qnamaker-fallback.

4. Selecteer uw uitgever in de lijst met uitgevers.

5. Accepteer de standaardwaarden voor de naam en versie.

6. Selecteer Maken om het proces te voltooien.

Uw stroom toevoegen aan de oplossing

1. Selecteer de oplossing die u zojuist hebt gemaakt in de lijst met oplossingen. De oplossing staat als het goed is bovenaan de lijst. Als dat niet het geval is, kunt u zoeken op uw e-mailadres, dat immers deel uitmaakt van de naam van de oplossing.

2. Selecteer in de oplossing + Bestaan item toevoegen en selecteer vervolgens Stroom in de lijst.

3. Zoek uw stroom in de lijst Buiten oplossingen en selecteer vervolgens Toevoegen om het proces te voltooien. Als er veel stromen zijn, kijkt u naar de kolom Gewijzigd om de meest recente stroom te vinden.

De stroom van uw oplossing toevoegen aan Power Virtual Agents

1. Ga terug naar het browsertabblad met uw agent in Power Virtual Agents. Het ontwerpcanvas is als het goed is nog steeds geopend.

2. Als u een nieuwe stap in de stroom wilt invoegen, selecteert u boven het actievak Bericht de connector + . Selecteer vervolgens Een actie aanroepen.

3. Selecteer in het pop-upvenster Stroom de nieuwe stroom met de naam Generate answers using QnA Maker... . De nieuwe actie wordt weergegeven in de stroom.

   

4. Om de invoervariabele correct in te stellen op de QnA Maker-actie, selecteert u Een variabele selecteren en selecteert u vervolgens bot.UnrecognizedTriggerPhrase.

   

5. Om de uitvoervariabele correct in te stellen op de QnA Maker-actie, selecteert u UnrecognizedTriggerPhrase in de actie Bericht, selecteert u vervolgens het pictogram om een variabele in te voegen, {x}, en selecteert u ten slotte FinalAnswer.

6. Selecteer in de contextwerkbalk Opslaan om de gegevens van het ontwerpcanvas voor het onderwerp op te slaan.

Het uiteindelijke canvas voor de agent ziet er zo uit.

De agent testen

1. Zet in het testvenster de optie Bijhouden in verschillende onderwerpen aan. Hiermee kunt u niet alleen de voortgang tussen onderwerpen bekijken, maar ook binnen één onderwerp.

2. Test de agent door de gebruikerstekst in de volgende volgorde in te voeren. Op het ontwerpcanvas worden de geslaagde stappen aangegeven met een groen vinkje.

   Volgorde van vragen	Testvragen	Doel
   1	Hello	Gesprek starten
   2	Openingstijden	Voorbeeldonderwerp. Dit is voor u geconfigureerd zonder dat u er iets voor hoeft te doen.
   3	Ja	In reactie op Did that answer your question?
   4	Uitstekend	In reactie op Please rate your experience.
   5	Ja	In reactie op Can I help with anything else?
   6	Hoe kan ik de doorvoerprestaties voor queryvoorspellingen verbeteren?	Met deze vraag wordt de terugvalactie geactiveerd, en wordt de tekst naar uw Knowledge Base verzonden om daar een antwoord te zoeken. Vervolgens wordt het antwoord weergegeven. De groene vinkjes controles voor de afzonderlijke acties geven aan dat de betreffende actie is gelukt.

   

Uw bot publiceren

Als u de agent beschikbaar wilt maken voor alle leden van uw school of organisatie, moet u de agent publiceren.

1. Selecteer Publiceren in het navigatiemenu aan de linkerkant. Selecteer vervolgens Publiceren op de pagina.

2. Probeer uw bot uit op de demowebsite (zoek naar de link onder Publiceren).

   Er wordt een nieuwe webpagina geopend met uw bot. Vraag de bot dezelfde testvraag: How can I improve the throughput performance for query predictions?

   

Uw bot delen

Als u de demo-website wilt delen, configureert u deze als een kanaal.

1. Selecteer Beheren > Kanalen in het navigatiemenu aan de linkerkant.

2. Select Demowebsite in de lijst met kanalen.

3. Kopieer de link en selecteer Opslaan. Plak de link naar de demowebsite in een e-mail en stuur deze naar de leden van uw school of organisatie.

Resources opschonen

Als u klaar bent met de Knowledge Base, verwijdert u de QnA Maker-resources in de Azure-portal.

Volgende stap

Analytische gegevens verkrijgen voor uw knowledge base

Meer informatie over:

• Power Virtual Agents
• Power Automate
• QnA Maker-connector en de instellingen voor de connector