Vrácení seznamu výsledků

Je běžné požádat agent, aby vyhledal data v externím systému a vrátil seznam výsledků. K tomu může Microsoft Copilot Studio zavolat tok Power Automate k:

• Ověření a připojení se k externímu řešení
• Spuštění dotazu na základě vstupů uživatele
• Formátování výsledků
• Vraťte výsledky do agent

V tomto příkladu použijete konektor Dataverse v Power Automate k vyhledání účtů. Poté vrátíte seznam výsledků, který obsahuje název účtu, město a číslo účtu, do Microsoft Copilot Studio.

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 účtů je standardní tabulka, která je automaticky součástí prostředí Power Platform. Neobsahuje však údaje účtu. Než bude váš agent moci vyhledávat účty, budete muset vyplnit tabulku účtů.

Pokud již máte tabulku účtů s daty, přeskočte tento krok a přejděte k vytvoření tématu. Při testování agent v pozdějších krocích však budete muset použít jiné hledané výrazy.

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

2. V bočním podokně v části Dataverse 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. Přejděte na stránku Témata pro svůj agent.

2. Vytvořte téma s názvem Vyhledává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 Zní to, jako byste hledali účet. Můžu vám ho vyhledat.

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 bude také fungovat. Výběr entity Organizace však využívá schopnosti agent rozumět jazyku k extrahování názvu organizace z odpověď.

   

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

Vytvoření toku

1. Na plátně pro vytváření obsahu vyberte Přidat uzel (+). Vyberte Vyvolat akci a pak vyberte Vytvořit tok.

2. Na portálu Power Automate pojmenujte tok Vyhledat účet.

3. Zadejte vstup Text s názvem Organizace.

   

4. Vyberte Vložit nový krok (+) a pak vyberte Přidat akci.

5. Vyberte konektor Microsoft Dataverse a poté vyberte akci Vyhledat řádky.

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

   

6. Jako Hledaný termín vyberte proměnnou Organizace.

7. Vyberte Zobrazit pokročilé možnosti a nastavte následující položky, jak je uvedeno:

   • 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 moci data použít, musíte je analyzovat pomocí akce Analyzovat JSON.

1. Vyberte Vložit nový krok (+) a pak vyberte Přidat akci.

2. Vyberte konektor Operace s daty a potom vyberte akci Analyzovat JSON.

3. V poli Obsah v části Prohledat řádky vyberte proměnnou 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 Vložit nový krok (+) a pak vyberte Přidat akci. Vyberte konektor Proměnná a potom vyberte akci Inicializovat proměnnou.

6. Jako Název zadejte ListOfAccounts. Jako Typ vyberte Řetězec.

   

7. Vyberte Vložit nový krok (+) a pak vyberte Přidat akci. Vyberte konektor Ovládací prvek a poté vyberte akci Použít na všechny.

8. Vyberte pole Vybrat výstup z předchozích kroků k otevření nabídky Dynamický obsah. Vyhledejte tělo a poté v části Analyzovat JSON vyberte proměnnou Tělo.

9. Vyberte Vložit nový krok (+) a pak vyberte Přidat akci. Vyberte konektor Proměnná a potom vyberte akci Připojit k řetězcové proměnné.

10. Jako Název vyberte ListOfAccounts. 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']}
    

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

    

12. V akci Vrátit hodnoty do Microsoft Copilot Studio přidejte výstup Text. Jako Název zadejte FoundAccounts. Jako Hodnota vyberte ListOfAccounts.

    

13. Vyberte Uložit.

Zavolání toku z Microsoft Copilot Studio

1. Na plátnu pro vytváření obsahu Microsoft Copilot Studio vyberte Přidat uzel (+) a poté vyberte Zavolat akci.

2. Vyberte tok, který jste vytvořili dříve, Vyhledat účet.

3. V poli Organizace získává hodnotu zvyberte proměnnou organizace.

4. Přidejte uzel Zpráva a zadejte zprávu Dobře, tohle jsem našel.

5. Přidejte druhý uzel Zpráva. Vyberte Vložit proměnnou a poté vyberte FoundAccounts.

   

6. Zvolte Uložit.

7. Otestujte svůj agent v podokně Test agent .