Vrácení seznamu výsledků

Je běžné požádat agenta, aby vyhledal data v externím systému a vrátil seznam výsledků. Za tímto účelem může agent volat tok Power Automate k provedení následujících akcí:

1. Ověření a připojení se k externímu řešení.
2. Spuštění dotazu na základě vstupu uživatele.
3. Formátování výsledků.
4. Vrácení výsledků agentovi.

V tomto příkladu se konektor Dataverse v Power Automate používá k vyhledání účtů. Konektor vrátí vašemu agentovi seznam výsledků, který obsahuje název účtu, město a číslo účtu.

Předpoklady

• Pochopte, jak vytvořit nový tok z plátna pro vytváření obsahu Copilot Studio
• Použití proměnných vstupu a výstupu k předávání informací
• Konfigurovat vyhledávání Dataverse pro vaše prostředí

Nastavení tabulky účtu Dataverse

Tabulka účtu je standardní tabulka, která je ve výchozím nastavení dostupná v prostředích Power Platform. Neobsahuje však údaje účtu. Než bude moci agent vyhledávat účty, musíte vyplnit tabulku účtu.

Pokud již máte tabulku účtů s daty, přeskočte tento krok a přejděte k vytvoření tématu. Nezapomeňte však při testování agenta v pozdějších krocích použít hledané výrazy relevantní pro vaše data.

1. Přejděte na portál Power Apps.

2. V levém navigačním podokně vyberte Tabulky.

3. Vyberte tabulku Účet a poté na stránce vlastností tabulky vyberte Upravit.

4. Do tabulky zadejte následující údaje:

   Adresa 1: Město	Název účtu	Číslo účtu
   Seattle	Contoso Inc	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso Meal Delivery	AC0035

Vytvoření tématu

1. V Copilot Studio přejděte na stránku Témata pro vašeho agenta.

2. Vytvořte téma s názvem Hledání účtu.

3. Přidejte následující spouštěcí fráze:

   • Hledám zákazníka
   • Hledám účet
   • hledat účet
   • hledat zákazníka

4. Přidejte uzel Zpráva a zadejte zprávu „To zní, jako byste hledali účet. Mohu to udělat za vás.“

5. Přidejte uzel Otázka a zadejte zprávu „Jak se jmenuje zákazník, kterého hledáte?“

6. V poli Identifikovat vyberte Organizace.

   Celá odpověď uživatele by šla také použít. Výběrem entity Organizace ale využijete možnosti porozumění jazyku agenta k extrakci názvu organizace z odpovědi.

7. V části Uložit odpověď uživatele jako přejmenujte proměnnou na „organizace“.

   

Vytvoření toku

1. Vyberte ikonu Přidat uzel pod libovolným uzlem a vyberte Přidat nástroj.

2. Na kartě Základní akce vyberte Nový tok agenta. Otevře se karta Návrhář toku agenta s počáteční šablonou pro tok agenta, který volá agent. Tok obsahuje dvě akce: Když agent volá tok a reaguje na agenta.

3. Zvolte Uložit koncept.

4. Na kartě Přehled toku upravte podrobnosti toku a nahraďte název účtem Search. Vyberte Uložit.

5. Vraťte se na kartu Návrhář . Vyberte možnost Když agent zavolá trigger toku toku a přidá parametr textového vstupu s názvem Organizace.

   

6. Vyberte ikonu Přidat pod triggerem toku toku při volání agenta .

7. V části Přidání akce vyhledejte „Microsoft Dataverse“ a vyberte akci Hledat řádky.

   Tato akce používá přibližnou shodu k nalezení relevantních účtů v tabulce účtů Dataverse.

8. Do pole Hledaný termín zadejte lomítko (/), vyberte Vložit dynamický obsah a pak vyberte vstupní parametr Organizace.

9. V části Rozšířené parametry vyberte Zobrazit vše a nastavte následující hodnoty:

   • Položka filtru tabulky: account
   • Seřadit podle položky – 1: search.score desc
   • Seřadit podle položky – 2: name asc

   

Formátování výsledků

Akce Prohledat řádky vrátí proměnnou Seznam řádků, která obsahuje data JSON. Než budete moct data použít, musíte je analyzovat pomocí akce Analyzovat JSON.

1. Vyberte ikonu Přidat pod akcí Hledat řádky.

2. V sekci Přidání akce vyhledejte „Operace s daty“ a vyberte akci Analyzovat JSON.

3. Do pole Obsah zadejte lomítko (/), vyberte Vložit dynamický obsah a pak vyberte Seznam řádků.

4. Zkopírujte následující schéma JSON a vložte ho do pole Schéma:

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

   

5. Vyberte ikonu Přidat pod akcí Analyzovat JSON.

6. V sekci Přidání akce vyhledejte „Proměnná“ a vyberte akci Inicializovat proměnnou.

7. Do pole Název zadejte „SeznamÚčtů“.

8. Jako Typ vyberte Řetězec.

   

9. Vyberte ikonu Přidat pod akcí Inicializovat proměnnou.

10. V sekci Přidání akce vyhledejte „Ovládací prvek“ a vyberte akci Použít na každý.

11. Do pole Vybrat výstup z předchozích kroků zadejte lomítko (/), vyberte Vložit dynamický obsah a pak v části Analýza JSON vyberte proměnnou Tělo.

12. Vyberte ikonu Přidatuvnitř akce Použít na každý action.

13. V sekci Přidání akce vyhledejte „Proměnná“ a vyberte akci Připojit k proměnné řetězce.

14. Jako Název vyberte ListOfAccounts.

15. Zkopírujte následující text a vložte ho do pole Hodnota:

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

16. Přidejte zalomení řádku za fragment, aby se každý výsledek zobrazil na samostatném řádku.

    

17. V akci Odpovědět na agenta přidejte textový výstup.

18. Jako Název zadejte „NalezenéÚčty“.

19. Jako hodnotu zadejte do pole lomítko (/), vyberte Vložit dynamický obsah a pak vyberte proměnnou SeznamÚčtů.

    

20. Uložte a publikujte tok. Copilot Studio vás informuje o publikování toku agenta.

21. Výběrem možnosti Přejít zpět k agentu se vraťte do editoru témat agenta. Do tématu se přidá nový tok akce.

Zavolání toku z Copilot Studio

1. Vyberte nový uzel akce.

2. Nastavte vstupní parametr toku na výstupní proměnnou z uzlu Otázka: Organizace (řetězec) získá svou hodnotu z proměnné organizace.

3. Přidejte uzel Zpráva a zadejte zprávu „Tohle jsem našel.“

4. Přidejte druhý uzel Zpráva. Vyberte ikonu Vložit proměnnou a potom vyberte NalezenéÚčty.

   

5. Zvolte Uložit.

6. Otestujte svého agenta.