Tworzenie przepływu
Dowiedz się, jak korzystać z przepływu Copilot Studio w chmurze, 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 tematu , aby agent mógł odpowiedzieć prognozą, gdy klient zapyta o pogodę.
Aby pracować z agentami, przepływ Power Automate wymaga specjalnego wyzwalacza przepływu.
Wyzwalacz przepływu: Uruchom przepływ z Copilot
Akcja odpowiedzi: Odpowiadanie do Copilot
W przypadku tworzenia przepływu z Copilot Studio, wyzwolenie i akcja są dodawane dla użytkownika. 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 niestandardowych w Copilot Studio, 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 swojego agenta.
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 korzysta z 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ć tak, aby używały poświadczeń użytkownika, gdy są uruchamiane w ramach planu aranżacji generatywnej lub wywoływane z tematu. Użycie przepływu w obsługiwanym kanałie nie wymaga specjalnej konfiguracji w oknie dialogowym agenta, a użytkownicy końcowi mogą zarządzać połączeniami podczas używania agenta.
Przepływy w chmurze w środowiskach korzystających z kluczy zarządzanych przez klienta (CMK) nie mogą być jeszcze uruchamiane przy użyciu poświadczeń klienta 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 w celu użycia z agentem
Jeśli przepływ ma przepływ z innym wyzwoleniem, który ma być uruchamiany razem z agentem, można zmienić przepływ, tak aby użycie przepływu z wyzwalania Copilot i odpowiedzi na Copilot było możliwe, a także upewnić się, że rozwiązanie działa w tym samym środowisku, co agent niestandardowy.
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 akcji wyzwalacza i odpowiedzi Copilot, musisz je dodać, aby można było 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órych chcesz użyć w agent, muszą zwracać wartości w czasie rzeczywistym lub synchronicznie. Przepływy uruchamiane w tle lub asynchronicznie mogą powodować błąd, gdy agent próbuje je uruchomić. Zamiast uruchamiania przepływu agent powie: „Wystąpiło nieoczekiwane zdarzenie. 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 Odpowiadanie 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 pracy były dostępne dla agentów w tym samym środowisku, przepływy muszą być przechowywane w rozwiązaniu w Power Platform. 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.