Tworzenie przepływu
Dowiedz się, jak korzystać z przepływ w chmurze Copilot Studio , dając agent możliwość tworzenia prognozy pogody na żądanie. W pierwszym przykładzie zostanie utworzony przepływ, który pobiera prognozy pogody. W następnym przykładzie wywołasz przepływ jako akcję z temat aby agent mógł odpowiedzieć prognozą, gdy klient zapyta o pogodę.
Aby pracować z agentami Power Automate , przepływ wymaga określonego wyzwalacza przepływu i akcji odpowiedzi.
Wyzwalacz przepływu: Uruchom przepływ z Copilot
Akcja odpowiedzi: Odpowiadanie do Copilot
Podczas tworzenia przepływu na podstawie Copilot Studio wyzwalacz i akcja są dodawane za Ciebie. Istniejący przepływ można zmodyfikować do użycia z agentami, zmieniając go tak, aby korzystał z tych akcji.
Ważne
Aby można było używać przepływów w chmurze w agentach Copilot Studio niestandardowych, przepływy muszą:
- Wyzwól Uruchom przepływ z Copilot.
- Znajdować się w rozwiązaniu w tym samym środowisku co agent. Istniejące przepływy można dodać do rozwiązania , aby były dostępne podczas dodawania akcji do agent.
- Zwraca odpowiedź synchronicznie z akcją Odpowiadanie dla Copilot w zakresie limitu 100 sekund. W celu uniknięcia limitów czasu należy zoptymalizować logikę przepływu, zapytania i ilość zwróconych danych, tak aby podczas typowego uruchomienia nie było to ograniczenie. Akcje, które muszą trwać dłużej, można umieścić po akcji Odpowiedź dla Copilot, aby kontynuować wykonywanie przez limit czasu trwania przepływu pracy (zazwyczaj 30 dni).
Wymagania wstępne
- Dostęp do Copilot Studio licencji, która obejmuje korzystanie z przepływów w kontekście tworzenia Copilot Studio.
Tworzenie przepływu do użycia z agent
Przejdź do strony Tematy dla swojego agent.
Otwórz temat, z którego chcesz wywołać przepływ.
Wybierz przycisk Dodaj węzeł (+) pod istniejącym węzłem, aby dodać nowy węzeł.
W oknie wybierania węzła wybierz opcję Wywołaj akcję, Akcja podstawowa, a następnie wybierz pozycję Utwórz przepływ.
Portal Power Automate jest otwierany na nowej karcie z szablonem przepływu startowego otwartym do edycji. Portal jest otwierany w tym samym środowisku co agent i używa tych samych poświadczeń użytkownika.
Porada
Zmień nazwy węzłów, aby ułatwić ich identyfikację. Zaznacz pole nazwy węzła, aby bezpośrednio zaktualizować nazwę lub wybierz ikonę Więcej (…) w węźle i w menu wybierz polecenie Zmień nazwę. Możesz także zmienić nazwy węzłów w edytorze kodu.
Nie można zmienić nazw węzłów Wyzwalacz i Przejdź do kroku.
Długość nazwy węzła nie może przekraczać 500 znaków.
Teraz dodaj akcje do swojego przepływu. W tym przykładzie dodasz akcję pobieraną z bieżącej prognozy z witryny MSN Weather.
Wybierz nazwę przepływu i zmień jego nazwę na Pobierz prognozę pogody.
Dodaj następujące parametry wejściowe do wyzwalania uruchamiania przepływu z Copilot:
- Miejscowość (tekst)
- Kod pocztowy (liczba)
Wybierz Dodaj akcję, aby utworzyć nową akcję poniżej wyzwalacza przepływu Uruchom przepływ z Copilot.
Wyszukaj MSN weather i wybierz akcję Pobierz prognozę na dzisiaj.
W akcji Pobierz prognozę na dzisiaj, w polu Lokalizacja wybierz opcję Dodaj zawartość dynamiczną, a następnie wybierz opcję Miejscowość i Kod pocztowy.
W akcji Odpowiadaj na Copilot dodaj następujące parametry wyjściowe i zmienne:
Parametr wyjściowy Type Zmienna day_summary
String Podsumowanie dzienne location
String Lokalizacja chance_of_rain
telefonu Możliwość opadów w ciągu dnia Wybierz pozycję Zapisz.
Zarządzanie połączeniami używanymi przez przepływ
W obsługiwanym uwierzytelnionym agent przepływy w chmurze można skonfigurować do używania poświadczeń użytkownika, gdy są uruchamiane w ramach planu orkiestracji generatywnej lub wywoływane z temat. Jeśli używasz przepływu w obsługiwanym kanale, nie wymaga to specjalnej konfiguracji w oknie dialogowym agent, a użytkownicy będą mogli zarządzać swoimi połączeniami podczas korzystania z agent.
Przepływy w chmurze w środowiskach korzystających z kluczy zarządzanych przez klienta (CMK) nie mogą być jeszcze uruchamiane z poświadczeniami użytkownika końcowego w ramach planów aranżacji generatywnej lub z tematów. Należy się upewnić, że ustawienia oparte tylko na uruchomieniu przepływów chmury w środowiskach CMK mają ustawioną konkretną nazwę połączenia, a nie połączenia dostępne tylko dla użytkownika do uruchamiania.
Modyfikowanie istniejącego przepływu do użycia z agent
Jeśli masz przepływ z innym wyzwalaczem, którego chcesz użyć z agent, możesz zmienić przepływ tak, aby używał akcji Uruchom przepływ z Copilot i Odpowiedz na Copilot odpowiedź i upewnij się, że znajduje się w rozwiązaniu w tym samym środowisku co niestandardowy agent.
Przejdź do portalu Power Automate i użyj selektora środowiska w prawym górnym rogu, aby wybrać środowisko, w którym przechowywany jest przepływ.
Przejdź do mojego przepływu po lewej stronie i wyszukaj przepływ.
Wybierz przepływ.
Dodawanie akcji wyzwalania i odpowiedzi Copilot
Jeśli przepływ nie zawiera jeszcze wyzwalacza Copilot i akcji odpowiedź, musisz je dodać, zanim będzie można używać przepływu z agent.
Wybierz pozycję Nowy krok.
Wyszukaj Copilot i wybierz Uruchom przepływ z Copilot.
Wybierz pozycję Nowy krok.
Wyszukaj łącznik Copilot i wybierz opcję Odpowiadaj na Copilot. Akcja odpowiedzi może być używana na wielu odgałęzieniach w przepływie, ale musi mieć te same wyniki wyjściowe przy każdym użyciu.
Zapisz i opublikuj przepływ.
Upewninie się, że akcja odpowiedzi jest ustawiona w czasie rzeczywistym
Przepływy, które mają być używane w agent muszą zwracać wartości w czasie rzeczywistym lub synchronicznie. Przepływy, które działają w tle lub asynchronicznie, mogą spowodować błąd, gdy agent próbuje je uruchomić. Zamiast uruchamiać przepływ, agent powie: "Stało się coś nieoczekiwanego. Trwa sprawdzanie. Kod błędu: 3000”.
W przypadku tworzenia przepływu z rozwiązania Copilot Studio odpowiedzi asynchroniczne są domyślnie wyłączone. Jeśli zmodyfikował istniejący przepływ, który ma włączone odpowiedzi asynchroniczne, wykonaj poniższe kroki, aby sprawdzić ustawienie i upewnić się, że jest ono wyłączone:
Otwórz przepływ i znajdź akcje Odpowiedz na Copilot .
Wybierz kartę Ustawienia.
Ustaw opcję Odpowiedź asynchroniczna na Wył., a następnie wybierz przycisk Gotowe.
Dodawanie przepływu do rozwiązania
Aby przepływy były dostępne dla agentów , muszą być przechowywane w rozwiązaniu w tym samym Power Platform środowisku. Jeśli przepływ znajduje się w rozwiązaniu, na stronie szczegółów przepływu będzie widoczny kafelek Rozwiązania z listą rozwiązań, w których znajduje się przepływ. Przepływy można dodać do rozwiązania domyślnego do użycia z agentami lub przenieść do innego rozwiązania, wykonując poniższe kroki:
Przejdź do portalu Power Automate.
Wybierz opcję Rozwiązania i wybierz istniejące rozwiązanie lub utwórz rozwiązanie dla przepływów.
Aby utworzyć rozwiązanie, wybierz pozycję Nowe rozwiązanie.
Nadaj nowemu rozwiązaniu nazwę, wybierz pozycję Domyślny wydawca CDS w polu Wydawca, wprowadź numer wersji, a następnie wybierz opcję Utwórz.
Na karcie Rozwiązania wybierz rozwiązanie, którego chcesz użyć. Wybierz pozycję Dodaj istniejące, aby dodać do niego przepływ.
Na stronie Dodawanie istniejącego przepływu wybierz kartę Z rozwiązań, następnie wybierz przepływ i wybierz Dodaj.
Aby przenieść przepływ z karty Moje przepływy do rozwiązania, wybierz Rozwiązania zewnętrzne, a następnie wybierz opcję Dodaj, aby dodać przepływ do rozwiązania.