Zwracanie listy wyników
Często zdarza się, że agent jest proszony o wyszukanie danych w systemie zewnętrznym i zwrócenie listy wyników. Aby to zrobić, agent może wywołać przepływ Power Automate do:
- Uwierzytelnić i połączyć się z rozwiązaniem zewnętrznym.
- Uruchomić zapytanie na podstawie danych wejściowych użytkownika.
- Sformatować wyniki.
- Zwrócić wyniki do agenta.
W tym przykładzie użyto łącznika Dataverse w Power Automate w celu wyszukania kont. Łącznik zwraca listę wyników, która zawiera nazwę konta, miasto i numer konta dla agenta.
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 Konto jest standardową tabelą dostępną domyślnie w środowiskach Power Platform. Jednakże dane konta nie są uwzględnione. Aby agent mógł wyszukiwać konta, należy wypełnić tabelę Konto.
Jeśli już istnieje tabela Klient z danymi, pomiń ten krok i przejdź do tworzenia tematu. Pamiętaj jednak, aby podczas testowania agenta w późniejszych krokach używać terminów wyszukiwania związanych z danymi.
Przejdź do portalu Power Apps.
W lewym okienku nawigacji wybierz Tabele.
Wybierz tabelę Klient, a następnie na stronie właściwości tabeli wybierz Edytuj.
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
W Copilot Studio przejdź do Tematy dla swojej funkcji agenta.
Utwórz nowy temat o nazwie Wyszukiwanie klienta.
Dodaj następujące frazy wyzwalające:
- Szukam klienta
- Szukam konta
- wyszukiwanie kont
- wyszukiwanie klientów
Dodaj węzeł Wiadomość i wprowadź komunikat "Wygląda na to, że szukasz konta. Mogę to dla ciebie sprawdzić.
Dodaj węzeł Pytanie i wprowadź komunikat "Jaka jest nazwa poszukiwanego klienta?".
Dla Identyfikuje wybierz Organizacja.
Cała odpowiedź użytkownika również by zadziałała. Jednak wybierając encję Organizacja, można skorzystać z możliwości rozumienia języka agenta w celu wyodrębnienia nazwy organizacji z odpowiedzi.
W polu Zapisz odpowiedź użytkownika jako zmień nazwę zmiennej na "organizacja".
Tworzenie przepływu
Wybierz ikonę Dodaj węzeł
poniżej dowolnego węzła i wybierz Dodaj akcję.Na karcie Akcje podstawowe wybierz pozycję Nowy przepływ Power Automate.
W obszarze Power Automate wybierz nazwę przepływu i zastąp ją ciągiem Wyszukaj konto.
Wybierz wyzwalacz Uruchom przepływ z przepływu Copilot i dodaj następujące parametry wejściowe Tekst oraz Organizacja.
Wybierz ikonę Dodaj poniżej wyzwalacza przepływu Uruchom przepływ z Copilot.
W obszarze Dodaj akcję wyszukaj ciąg "Microsoft Dataverse" i wybierz akcję Wyszukaj wiersze.
Ta akcja używa dopasowania rozmytego w celu znalezienia odpowiednich klientów w tabeli klientów Dataverse.
W polu Wyszukiwany termin wprowadź ukośnik (
/), wybierz pozycję Wstaw zawartość dynamiczną, a następnie wybierz Parametr wejściowy organizacji .W polu Zaawansowane parametry wybierz pozycję Pokaż wszystko i ustaw następujące wartości:
-
Element filtrowania tabeli:
account -
Sortowanie według elementu — 1:
search.score desc -
Sortowanie według elementu — 2:
name asc
-
Element filtrowania tabeli:
Formatuj wyniki
Akcja Wyszukaj wiersze zwraca zmienną Lista wierszy, która zawiera dane JSON. Aby można było użyć danych, należy je przeanalizować za pomocą akcji Przeanalizuj JSON.
Wybierz ikonę Dodaj poniżej akcji Wyszukaj wiersze.
W Dodaj działanie wyszukaj „Data Operation” i wybierz akcję Analizuj JSON.
W polu Zawartość wprowadź ukośnik (
/), wybierz pozycję Wstaw zawartość dynamiczną, a następnie wybierz pozycję Lista wierszy.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" ] } }
Wybierz ikonę Dodaj poniżej akcji Analizj JSON.
W Dodaj działanie wyszukaj „Zmienna” i wybierz akcję Inicjalizuj zmienną.
W polu Nazwa wprowadź "ListOfAccounts".
W polu Typ wybierz pozycję Ciąg.
Wybierz ikonę Dodaj poniżej akcji Inicjalizuj zmienną.
W Dodaj działanie wyszukaj „Kontrola” i wybierz akcję Zastosuj do każdego.
W polu Wybierz dane wyjściowe z poprzednich kroków wprowadź ukośnik (
/), wybierz Wstaw dynamiczną treść, a następnie wybierz zmienną Treść w sekcji Analizuj JSON.Wybierz ikonę Dodajwewnątrz akcji Zastosuj do każdej.
W Dodaj działanie wyszukaj „Zmienna” i wybierz akcję Dołącz do zmiennej łańcuchowej.
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']}Dodaj podział wiersza po wstawce, aby każdy wynik był wyświetlany we własnym wierszu.
W akcji Odpowiedz na Copilot dodaj dane wyjściowe Tekst.
Dla Nazwa wpisz "FoundAccounts".
Jako wartość wprowadź ukośnik (
/) w polu, wybierz pozycję Wstaw zawartość dynamiczną, a następnie wybierz zmienną ListOfAccounts.
Zapisz i opublikuj przepływ.
Wywołaj przepływ z Copilot Studio
W Copilot Studio wybierz ikonę Dodaj węzeł
pod węzłem Pytanie, wybierz Dodaj akcję, a następnie wybierz przepływ utworzony wcześniej, Wyszukaj konto.Ustaw parametr wejściowy przepływu na zmienną wyjściową z węzła Pytanie: Organizacja (Ciąg) otrzymuje swoją wartość ze zmiennej organizacja.
Dodaj węzeł Komunikat i wprowadź komunikat Dobrze, oto, co udało mi się znaleźć.
Dodaj drugi węzeł Komunikat. Wybierz ikonę Wstaw zmienną, a następnie wybierz pozycję FoundAccounts.
Wybierz pozycję Zapisz.
Przetestuj swojego agenta.
