Een lijst met resultaten retourneren

Het komt vaak voor dat een agent gegevens in een extern systeem moet zoeken en een lijst met resultaten moet retourneren. Om dat te doen kan een agent een Power Automate-stroom aanroepen om het volgende te doen:

1. Een externe oplossing verifiëren en hiermee verbinding te maken.
2. Voer een query uit op basis van de invoer van de gebruiker.
3. De resultaten opmaken.
4. Geef de resultaten terug aan de agent.

In dit voorbeeld wordt de Dataverse-connector in Power Automate gebruikt om naar accounts te zoeken. De connector retourneert een lijst met resultaten, inclusief de accountnaam, de stad en het accountnummer, aan uw agent.

Voorwaarden

• Begrijpen hoe u een stroom maakt vanaf het Copilot Studio-ontwerpcanvas
• In- en uitvoervariabelen gebruiken om informatie door te geven
• Zoekfunctie van Dataverse voor uw omgeving configureren

Een Dataverse-accounttabel instellen

De tabel Account is een standaardtabel die standaard beschikbaar is in Power Platform-omgevingen. De tabel bevat echter nog geen accountgegevens. Voordat uw agent naar accounts kan zoeken, moet u de tabel Account invullen.

Als u al een Accounttabel met gegevens hebt, slaat u deze stap over en gaat u verder met Een onderwerp maken. Vergeet echter niet om zoektermen te gebruiken die relevant zijn voor uw gegevens wanneer u uw agent in latere stappen test.

1. Ga naar de Power Apps-portal.

2. Selecteer Tabellen in het linkernavigatievenster.

3. Selecteer de tabel Account en daarna, op de pagina met tabeleigenschappen, de optie Bewerken.

4. Voeg de volgende rijen toe aan de tabel:

   Adres 1: plaats	Accountnaam	Rekeningnummer
   Seattle	Contoso Inc	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso-maaltijdbezorging	AC0035

Een onderwerp maken

1. Ga in Copilot Studio naar de pagina Onderwerpen voor uw agent.

2. Maak een onderwerp met de naam Account zoeken.

3. Voeg de volgende triggerzinnen toe:

   • Ik zoek een klant
   • Ik zoek een account
   • accounts zoeken
   • klant zoeken

4. Voeg een berichtknooppunt toe en voer het bericht "Het lijkt erop dat u een account zoekt. Ik kan dat voor je opzoeken."

5. Voeg een Vraag-knooppunt toe en voer het bericht "Hoe heet de klant die u zoekt?" in.

6. Selecteer bij Identificeren de optie Organisatie.

   Het volledige antwoord van de gebruiker zou ook werken. Als u echter de entiteit Organisatie selecteert, maakt u gebruik van de taalbegripsmogelijkheden van de agent om de organisatienaam uit de respons te halen.

7. Voor Gebruikersrespons opslaan als hernoemt u de variabele naar "organisatie".

   

Stroom maken

1. Selecteer het pictogram Knooppunt toevoegen onder een knooppunt en selecteer Een actie toevoegen.

2. Selecteer op het tabblad Basisacties de stroom Nieuwe Power Automate-stroom.

3. Selecteer in Power Automate de naam van de stroom en vervang deze door Account zoeken.

4. Selecteer de stroomtrigger Een stroom uitvoeren vanuit Copilot en voeg een invoerparameter Tekst toe met de naam Organisatie.

   

5. Selecteer het pictogram Toevoegen onder de stroomtrigger Een stroom uitvoeren vanuit Copilot.

6. Zoek in Een actie toevoegen naar 'Microsoft Dataverse' en selecteer de actie Rijen zoeken.

   Deze actie maakt gebruik van fuzzy overeenkomsten om relevante accounts in uw Dataverse-accounttabel te zoeken.

7. Voer in het vak Zoekterm een schuine streep (/) in, selecteer Dynamische inhoud invoegen en selecteer vervolgens de invoerparameter van uw Organisatie.

8. Voor Geavanceerde parameters selecteert u Alles weergeven en stelt u de volgende waarden in:

   • Tabelfilteritem: account
   • Sorteren op item - 1: search.score desc
   • Sorteren op item - 2: name asc

   

Resultaten indelen

De actie Rijen zoeken retourneert de variabele Lijst met rijen, die JSON-gegevens bevat. Voordat u de gegevens kunt gebruiken, moet u deze analyseren met de actie JSON parseren.

1. Selecteer het pictogram Toevoegen onder de actie Rijen zoeken.

2. Zoek in Een actie toevoegen naar 'Gegevensbewerking' en selecteer de actie JSON parseren.

3. Voer in het vak Inhoud een schuine streep (/) in, selecteer Dynamische inhoud invoegen en selecteer vervolgens Lijst met rijen.

4. Kopieer het volgende JSON-schema en plak deze in het vak Schema:

   {
       "type": "array",
       "items": {
           "type": "object",
           "properties": {
               "@@search.score": {
                   "type": "number"
               },
               "name": {
                   "type": "string"
               },
               "address1_city": {
                   "type": "string"
               },
               "accountnumber": {
                   "type": "string"
               }
           },
           "required": [
               "name"
           ]
       }
   }
   

   

5. Selecteer het pictogram Toevoegen onder de actie JSON parseren.

6. Zoek in Een actie toevoegen naar 'Variabele' en selecteer de actie Variabele initialiseren.

7. Typ in het vak Naam de tekst 'LijstMetAccounts'.

8. Selecteer bij Type de optie Tekenreeks.

   

9. Selecteer het pictogram Toevoegen onder de actie Variabele initialiseren.

10. Zoek in Een actie toevoegen naar 'Besturingselement' en selecteer de actie Toepassen op elke.

11. Voer in het vak Een uitvoer selecteren uit de vorige stappen een schuine streep (/) in, selecteer Dynamische inhoud invoegen en selecteer vervolgens de variabele Hoofdgedeelte onder JSON parseren.

12. Selecteer het pictogram Toevoegenbinnen de actie Toepassen op elk.

13. Zoek in Een actie toevoegen naar 'Variabele' en selecteer de actie Toevoegen aan tekenreeks-variabele.

14. Selecteer bij Naam de optie LijstMetAccounts.

15. Kopieer de volgende tekst en plak deze in het vak Waarde:

    - @{items('Apply_to_each')['accountnumber']}: @{items('Apply_to_each')['name']} - @{items('Apply_to_each')['address1_city']}
    

16. Voeg een regeleinde toe na het fragment om elk resultaat op een eigen regel te laten verschijnen.

    

17. Voeg in de actie Reageren op Copilot een Tekst-uitvoer toe.

18. Voer voor Naam 'GevondenAccounts' in.

19. Voer voor de waarde een schuine streep (/) in het vak in, selecteer Dynamische inhoud invoegen en selecteer vervolgens de variabele LijstMetRekeningen.

    

20. Sla uw stroom op en publiceer deze.

De stroom aanroepen vanuit Copilot Studio

1. Selecteer in Copilot Studio het pictogram Knooppunt toevoegen onder het knooppunt Vraag , selecteer Een actie toevoegen en selecteer vervolgens de stroom die u eerder hebt gemaakt, Account zoeken.

2. Stel de invoerparameter van de stroom in op de uitvoervariabele van het knooppunt Vraag: Organisatie (tekenreeks) haalt zijn waarde uit de variabele organisatie.

3. Voeg een Bericht-knooppunt toe en voer het bericht "Oké, dit is wat ik heb gevonden" in.

4. Voeg een tweede Bericht-knooppunt toe. Selecteer het pictogram Variabele invoegen en selecteer vervolgens GevondenAccounts.

   

5. Selecteer Opslaan.

6. Test uw agent.