Uruchom przepływ agenta

Dowiedz się, jak używać przepływu agenta w programie Copilot Studio, dając agentowi możliwość tworzenia prognozy pogody na żądanie.

Wymagania wstępne

Ten przykład zależy od poprzedniego przykładu, w którym utworzono przepływ agenta , który pobiera prognozę pogody.

Jeśli przepływ prognozy prognoza nie został jeszcze utworzony, należy to zrobić w tej chwili.

Wywołaj przepływ agenta z poziomu agenta

Tutaj pokazujemy, jak dodać proces przepływu prognozy pogody jako narzędzie agenta. Ta metoda umożliwia orkiestratorowi agenta wywołanie przepływu, kiedy jest to konieczne, aby przedstawić prognozę pogody.

1. W okienku nawigacji po lewej stronie w programie Copilot Studio wybierz pozycję Agenci i wybierz agenta, do którego chcesz dodać przepływ.

2. Przejdź do strony Narzędzia i wybierz pozycję Dodaj narzędzie.

3. Wybierz pozycję Flow, aby wyświetlić listę dostępnych opublikowanych przepływów.

4. Wybierz utworzony wcześniej przepływ Pobierz prognozę pogody .

5. Wybierz pozycję Dodaj i skonfiguruj.

   Przepływ jest dodawany do agenta i pojawia się w jego liście narzędzi. Zostanie otwarte okienko konfiguracji narzędzia używanego przez agenta. Za pomocą tego okienka można skonfigurować narzędzie dla agenta.

6. W polach Nazwa i Opis wprowadź wyświetlaną nazwę narzędzia i jasny opis, który pomoże orkiestratorowi agenta zrozumieć, kiedy należy użyć przepływu. Na przykład "Pobierz bieżącą prognozę pogody pod podaną nazwą miasta lub kodem pocztowym".

7. W obszarze Dane wejściowe wybierz sposób wypełniania wartości zmiennej przez agenta.

8. W obszarze Ukończenie wybierz elementy, które agent ma wykonać po zakończeniu korzystania z narzędzia.

9. Po zakończeniu pracy z konfiguracją wybierz pozycję Zapisz.

Wywołaj przepływ agenta z tematu

W tym miejscu pokazano, jak używać węzła Akcja w temacie w celu wywołania przepływu, gdy klient zapyta o pogodę.

1. W Copilot Studio przejdź do Tematy dla funkcji agenta.

2. Utwórz nowy temat i nadaj mu nazwę Pobieranie pogody.

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

   • czy będzie padać
   • dzisiejsza prognoza
   • pobieranie pogody
   • jaka jest pogoda

   

4. Wybierz ikonę Dodaj węzeł poniżej węzła Wyzwalacz i wybierz Wyślij wiadomość.

5. W węźle Wiadomość wprowadź Mogę Ci w tym pomóc. w polu tekstowym.

6. Wybierz ikonę Dodaj węzeł pod węzłem Wiadomość i wybierz Zadaj pytanie, aby dodać węzeł Pytanie dla pierwszej informacji dla przepływu, miasta.

7. W węźle Pytanie:

   1. Wpisz pytanie „Jakie jest Twoje miasto?” w polu tekstowym.
   2. W obszarze Identyfikuj wybierz pozycję Cała odpowiedź użytkownika.
   3. Zanotuj nazwę zmiennej skojarzonej z tą odpowiedzią Var1. Możesz pozostawić nazwę bez zmian lub zastąpić ją bardziej zrozumiałą nazwą, taką jak "Miasto" (w razie potrzeby zobacz Zmienianie nazwy zmiennej).

8. Postępuj w ten sam sposób, aby dodać kolejny węzeł Pytanie dla innej informacji dla przepływu, czyli kodu pocztowego:

   1. Wpisz pytanie „Jakie jest Twój kod pocztowy?” w polu tekstowym.
   2. W obszarze Identyfikuj wybierz Liczba.
   3. Zanotuj nazwę zmiennej skojarzonej z tą odpowiedzią Var2. Możesz pozostawić nazwę bez zmian lub zastąpić ją bardziej znaczącą nazwą (na przykład „ZIPcode”).

9. Wybierz ikonę Dodaj węzeł pod węzłem Pytanie dla kodu pocztowego, wybierz Dodaj narzędzia, a następnie wybierz przepływ utworzony wcześniej, Uzyskaj prognozę pogody.

10. Ustaw wejścia przepływu na zmienne wyjściowe z węzłów zapytania. Miasto (ciąg) otrzymuje swoją wartość z Var1 (lub City, jeśli zmieniono nazwę), a Kod pocztowy (numer) otrzymuje swoją wartość z Var2 (lub ZIPcode, jeśli zmieniono nazwę).

    

11. Pod węzłem Działanie dodaj węzeł Wiadomość i wprowadź komunikat, który wykorzystuje informacje wyjściowe z przepływu. Na przykład:

    "Dzisiejsza prognoza dla location:day_summary"
    "Szansa na deszcz to chance_of_rain%"
    Gdzie location,day_summary i chance_of_rain są parametrami wyjściowymi przepływu.

    

12. Wybierz pozycję Zapisz.

Zarządzanie przepływem agenta używanym w temacie

Gdy masz węzeł Akcja, który wywołuje przepływ, możesz użyć następujących opcji z menu węzła, aby zarządzać przepływem:

• Usunięcie trwale usuwa węzeł i usuwa przepływ z tematu.

• Odśwież ponownie ładuje przepływ do uzyskania wszelkich zmian wprowadzonych w Power Automate i weryfikuje go w temacie. Przed zapisaniem tematu należy rozwiązać wszelkie problemy z przepływem.

Jeśli chcesz wybrać lub utworzyć inny przepływ, użyj ikony Zmiana przepływu, która pojawia się po najechaniu kursorem na przepływ w węźle Działania.

Testowanie przepływu i tematu

Dobrym pomysłem jest przetestowanie przepływu i tematu, który go wywołuje.

W panelu Testowanie agenta wpisz jedną z fraz wyzwalających tematu, aby rozpocząć konwersację z agentem. Wpisz swoje miasto i kod pocztowy, gdy agent o nie poprosi. Sprawdź, czy agent zwraca dzisiejszą prognozę pogody dla Twojego miasta i czy komunikat wygląda zgodnie z oczekiwaniami.

Rozwiązywanie problemów z agentem

Zawsze przetestuj swojego agenta po wprowadzeniu zmian w tematach i przepływach, aby upewnić się, że wszystko nadal działa. Kiedy podczas konwersacji z agentem wystąpi problem, bot odpowie, wyświetlając komunikat o błędzie.

Większość problemów związanych z przepływem można znaleźć w narzędziu do sprawdzania przepływu w zakładce projektant przepływów. Narzędzie sprawdzanie tematów służy do identyfikowania problemów na kanwie tworzenia.