Een lijst met resultaten retourneren

Het is gebruikelijk om een copilot te vragen naar gegevens in een extern systeem te zoeken en een lijst met resultaten terug te sturen. Om dat te doen, kan Microsoft Copilot Studio een Power Automate-stroom aanroepen om:

• Een externe oplossing te verifiëren en hiermee verbinding te maken
• Een query uit te voeren op basis van de invoer van de gebruiker
• De resultaten op te maken
• De resultaten naar de copilot terug te sturen

In dit voorbeeld gebruikt u de Dataverse-connector in Power Automate om accounts te zoeken. Vervolgens stuurt u een lijst met resultaten met de accountnaam, de stad en het accountnummer terug naar Microsoft Copilot Studio.

Vereisten

• 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 automatisch wordt opgenomen in Power Platform-omgevingen. De tabel bevat echter nog geen accountgegevens. Voordat uw copilot naar accounts kan zoeken, moet u de accounttabel invullen.

Als u al een Accounttabel met gegevens hebt, slaat u deze stap over en gaat u verder met Een onderwerp maken. Wanneer u uw copilot in latere stappen test, moet u echter andere zoektermen gebruiken.

1. Ga naar de Power Apps-portal.

2. Selecteer in het deelvenster aan de zijkant, onder Dataverse de optie Tabellen.

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 naar de pagina Onderwerpen voor uw copilot.

2. Maak een onderwerp met de naam Accounts zoeken.

3. Voeg de volgende triggerzinnen toe:

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

4. Voeg een Bericht-knooppunt toe en voer het bericht Zo te zien bent u op zoek naar een account. Dat kan ik voor u opzoeken. in.

5. Voeg een Vraag-knooppunt toe en voer het bericht Wat is de naam van de klant die u zoek? in.

6. Selecteer bij Identificeren de optie Organisatie.

   Volledige respons van gebruiker werkt ook. Als u echter de entiteit Organisatie selecteert, wordt gebruik gemaakt van het taalbegrip van de copilot om de naam van de organisatie uit het antwoord te halen.

   

7. Wijzig bij Respons opslaan als de naam van de variabele in organisatie.

Stroom maken

1. Selecteer Knooppunt toevoegen (+) op het ontwerpcanvas. Selecteer Een actie aanroepen en daarna Een stroom maken.

2. In de Power Automate-portal geeft u de stroom de naam Account zoeken.

3. Voeg een Tekst-invoer toe met de naam Organisatie.

   

4. Selecteer Voeg een nieuwe stap in (+) en selecteer Een actie toevoegen.

5. Selecteer de Microsoft Dataverse-connector en de actie Rijen zoeken.

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

   

6. Selecteer bij Zoekterm de variabele Organisatie.

7. Selecteer Geavanceerde opties weergeven en stel de volgende items in als opgegeven:

   • 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 Voeg een nieuwe stap in (+) en selecteer Een actie toevoegen.

2. Selecteer de Gegevensbewerking-connector en de actie JSON parseren.

3. Selecteer in het vak Inhoud, onder Rijen zoeken, de variabele 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 Voeg een nieuwe stap in (+) en selecteer Een actie toevoegen. Selecteer de Variabele-connector en de actie Variabele initialiseren.

6. Voer bij Naam LijstMetAccounts in. Selecteer bij Type de optie Tekenreeks.

   

7. Selecteer Voeg een nieuwe stap in (+) en selecteer Een actie toevoegen. Selecteer de Besturingselement-connector en de actie Toepassen op elke.

8. Selecteer het vak Een uitvoer selecteren uit de vorige stappen om het menu Dynamische inhoud te openen. Zoek naar hoofdtekst en selecteer onder JSON parseren de variabele Hoofdtekst.

9. Selecteer Voeg een nieuwe stap in (+) en selecteer Een actie toevoegen. Selecteer de Variabele-connector en de actie Toevoegen aan tekenreeks-variabele.

10. Selecteer bij Naam de optie LijstMetAccounts. 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']}
    

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

    

12. Voeg in de actie Waarde(n) retourneren naar Microsoft Copilot Studio een Tekst-uitvoer toe. Voer voor Naam GevondenAccounts in. Selecteer bij Waarde de optie LijstMetAccounts.

    

13. Selecteer Save.

De stroom aanroepen vanuit Microsoft Copilot Studio

1. Op het Microsoft Copilot Studio-ontwerpcanvas selecteert u Knooppunt toevoegen (+) en vervolgens Een actie aanroepen.

2. Selecteer de stroom die u eerder hebt gemaakt, Account zoeken.

3. Selecteer bij Organisatie krijgt waarde van de variabele organisatie.

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

5. Voeg een tweede Bericht-knooppunt toe. Selecteer Variabele invoegen en daarna GevondenAccounts.

   

6. Selecteer Opslaan.

7. Test uw copilot in het deelvenster Copilot testen.