Zwracanie listy wyników

Często żąda się od pomocnika, aby poszukał danych w systemie zewnętrznym i zwrócił listę wyników. W tym celu Microsoft Copilot Studio może wywołać przepływ Power Automate, aby:

• Uwierzytelnić i połączyć się z rozwiązaniem zewnętrznym
• Uruchomić zapytania oparte na danych wejściowych użytkownika
• Sformatować wyniki
• Zwrócić wyniki do pomocnika

W tym przykładzie do wyszukania kont użyjesz łącznika Dataverse w Power Automate. Następnie zostanie zwrócona lista wyników z nazwą konta, miejscowością i numerem konta do Microsoft Copilot Studio.

Wymagania wstępne

• Rozumienie tworzenia przepływu z poziomu kanwy tworzenia usługi Copilot Studio
• Użyj zmiennych wejściowych i wyjściowych do przekazania informacji
• Konfigurowanie wyszukiwania Dataverse dla środowiska

Konfigurowanie tabeli konta Dataverse

Tabela Klient to standardowa tabela, która jest dołączona automatycznie do środowisk Power Platform. Jednakże dane konta nie są uwzględnione. Aby pomocnik mógł wyszukiwać klientów, należy najpierw wypełnić tabelę Klient.

Jeśli już istnieje tabela Klient z danymi, pomiń ten krok i przejdź do tworzenia tematu. Podczas testowania pomocnika w kolejnych krokach należy jednak użyć innych terminów wyszukiwania.

1. Przejdź do portalu Power Apps.

2. W okienku bocznym pod Dataverse wybierz Tabele.

3. Wybierz tabelę Klient, a następnie na stronie właściwości tabeli wybierz Edytuj.

4. Dodaj w odpowiednich wierszach do tabeli:

   Adres 1: miejscowość	Nazwa klienta	Numer klienta
   Seattle	Contoso Inc	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso Meal Delivery	AC0035

Tworzenie tematu

1. Przejdź do strony Tematy swojego pomocnika.

2. Utwórz nowy temat o nazwie Wyszukiwanie klienta.

3. Dodaj następujące frazy wyzwalające:

   • Szukam klienta
   • Szukam konta
   • wyszukiwanie kont
   • wyszukiwanie klientów

4. Dodaj węzeł Wiadomość i wprowadź komunikat Wygląda na to, że szukasz konta. Mogę je dla Ciebie znaleźć.

5. Dodaj węzeł Pytanie i wprowadź komunikat Jaka jest nazwa poszukiwanego klienta?.

6. Dla Identyfikuje wybierz Organizacja.

   Zadziała także cała odpowiedź użytkownika. Jednak wybranie encji Organizacja pozwala wykorzystać możliwości rozumienia języka przez pomocnika w celu wyodrębnienia nazwy organizacji z odpowiedzi.

   

7. Aby Zapisać odpowiedź jako, zmień zmienną na Organizację.

Utwórz przepływ

1. Na kanwie tworzenia wybierz Dodaj węzeł (+). Wybierz Wywołaj akcję, a następnie wybierz Utwórz przepływ.

2. W portalu Power Automate nazwij przepływ Wyszukiwanie klienta.

3. Dodaj dane wejściowe Tekst o nazwie Organizacja.

   

4. Wybierz Wstaw nowy krok (+), a następnie wybierz pozycję Dodaj akcję.

5. Wybierz łącze Microsoft Dataverse, a następnie wybierz akcję Wyszukaj wiersze.

   Ta akcja używa dopasowania rozmytego w celu znalezienia odpowiednich klientów w tabeli klientów Dataverse.

   

6. Dla Termin wyszukiwania wybierz zmienną Organizacja.

7. Wybierz opcję Pokaż opcje zaawansowane i ustaw następujące elementy:

   • Element filtrowania tabeli: account
   • Sortowanie według elementu — 1: @search.score desc
   • Sortowanie według elementu — 2: name asc

   

Formatuj wyniki

Akcja Wyszukaj wiersze zwraca zmienną Lista wierszy, która zawiera dane JSON. Przed użyciem danych należy je przeanalizować przy użyciu akcji JSON analizy.

1. Wybierz Wstaw nowy krok (+), a następnie wybierz pozycję Dodaj akcję.

2. Wybierz łącznik Operacje na danych, a następnie wybierz akcję JSON analizy.

3. W polu Zawartość w obszarze Wyszukaj wiersze wybierz zmienną Lista wierszy.

4. Skopiuj następujący schemat JSON i wklej go w polu Schemat:

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

   

5. Wybierz Wstaw nowy krok (+), a następnie wybierz pozycję Dodaj akcję. Wybierz łącznik Zmienna, a następnie wybierz akcję Inicjuj zmienną.

6. Dla Nazwa wpisz ListOfAccounts. W polu Typ wybierz pozycję Ciąg.

   

7. Wybierz Wstaw nowy krok (+), a następnie wybierz pozycję Dodaj akcję. Wybierz łącznik Kontrolka, a następnie wybierz akcję Zastosuj do każdej.

8. Wybierz pole Wybierz dane wyjściowe z poprzednich kroków, by otworzyć menu Zawartość dynamiczna. Wyszukaj treść, a następnie w obszarze Analizuj JSON wybierz zmienną Treść.

9. Wybierz Wstaw nowy krok (+), a następnie wybierz pozycję Dodaj akcję. Wybierz łącznik Zmienna, a następnie wybierz akcję Dołącz do zmiennej ciągu.

10. Dla Nazwa wybierz ListOfAccounts. Skopiuj następujący tekst i wklej go w polu Wartość:

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

11. Dodaj podział wiersza po wstawce, aby każdy wynik był wyświetlany we własnym wierszu.

    

12. W akcji Zwróć wartości do Microsoft Copilot Studio dodaj wartość wyjściową Tekst. Dla Nazwa wpisz FoundAccounts. Dla Wartość wybierz ListOfAccounts.

    

13. Wybierz pozycję Zapisz.

Wywołaj przepływ z Microsoft Copilot Studio

1. Na kanwie tworzenia Microsoft Copilot Studio wybierz opcję Dodaj węzeł (+), a następnie wybierz opcję Wywołaj akcję.

2. Wybierz utworzony wcześniej przepływ pracy, Wyszukaj klienta.

3. W przypadku Organizacja pobiera wartość z wybierz zmienną organizacja.

4. Dodaj węzeł Komunikat i wprowadź komunikat Dobrze, oto, co udało mi się znaleźć.

5. Dodaj drugi węzeł Komunikat. Wybierz Wstaw zmienną, a następnie wybierz opcję FoundAccounts.

   

6. Wybierz pozycję Zapisz.

7. Przetestuj swojego pomocnika w okienku Test pomocnika.