Edytuj i zarządzaj swoim workflow w Designerze

Note

Funkcje opisane w tym artykule są zasilane przez szelkę GitHub Copilot, która wykorzystuje Copilot Credits do rozliczeń opartych na użytkowaniu. Dowiedz się więcej o kredytach Copilot w Przeglądzie rozliczeń dla agentów zasilanych przez GitHub Copilot harness.

Rozliczanie oparte na użytkowaniu dotyczy korzystania, budowania, testowania i oceny agentów. Te działania mogą pochłaniać kredyty Copilot.

Workflowy są tworzone i edytowane w przeprojektowanym visual designerze w Copilot Studio. Projektant udostępnia płótno, na którym możesz budować lub edytować automatyzację, dodawać i usuwać działania, sprawdzać błędy oraz publikować swój workflow bez opuszczania projektanta.

Wyświetlaj workflow w projektancie

Aby wyświetlić workflow w projektancie, otwórz Copilot Studio, wybierz Workflows, wybierz workflow, a następnie wybierz zakładkę Build.

Zrzut ekranu z Copilot Studio pokazujący opublikowany przepływ pracy z wyzwalaczem i kilkoma działaniami.

Zmień sposób wyświetlania swojego workflow

W zależności od wielkości i złożoności twojego workflow, możesz chcieć dostosować sposób wyświetlania, aby ułatwić pracę. Pasek narzędzi na dole po lewej stronie płótna kontroluje widok.

Zrzut ekranu paska narzędzi opcji widoku w projektancie Copilot Studio z objaśnieniami ponumerowanymi od 1 do 6.

Legenda:

  1. Powiększenie: zwiększ rozmiar przepływu pracy na kanwie.
  2. Pomniejszanie: zmniejsz rozmiar przepływu pracy na kanwie.
  3. Dopasuj widok: zmień rozmiar widoku, aby dopasować cały przepływ pracy na kanwie.
  4. Uporządkowanie: zreorganizowanie przepływu pracy i gałęzi w celu uzyskania czystszego widoku kompleksowego.
  5. Układ pionowy: przełącz się do pionowego widoku układu przepływu pracy.

Dodawanie i usuwanie akcji

  1. Na karcie, po której chcesz dodać akcję, wybierz pozycję Dodaj krok. Zostanie otwarte okienko Dodawanie .

  2. W sekcji Dodaj zacznij wpisywać akcję, którą chcesz, aby Twój workflow wykonał, lub konektor, który chcesz dodać, a następnie wybierz ją z listy. W zależności od dokonanego wyboru może być konieczne podanie dodatkowych informacji w celu wykonania akcji.

Jeśli uznasz, że akcja nie jest potrzebna, wybierz ikonę Usuń w prawym górnym rogu akcji.

Sprawdź parametry workflow

Aby wyświetlić parametry wyzwalacza lub akcji w przepływie pracy, wybierz jego kartę. Panel konfiguracji zostanie otwarty po prawej stronie. Aby wprowadzić wartość parametru, wybierz opcję z listy rozwijanej lub wprowadź wyrażenie w celu dynamicznego ustawienia wartości.

Sprawdź pod kątem błędów

Błędy w akcjach przepływu pracy są wskazywane na czerwono. Aby wyświetlić szczegóły błędu w jednej akcji, zaznacz błąd. Aby wypisać wszystkie błędy w całym procesie, otwórz baner centrum zdrowia . Aby wyświetlić szczegóły poszczególnych błędów, wybierz błąd.

Important

Nie możesz opublikować workflow, jeśli zawiera błędy. Musisz poprawić wszystkie błędy, zanim będziesz mógł go opublikować.

Publikowanie przepływu pracy

Jeśli przepływ pracy nie zawiera błędów, możesz go opublikować. W menu na górze płótna wybierz Opublikuj.

Testowanie przepływu pracy

Testy pozwalają zweryfikować krok lub cały workflow bez opuszczania projektanta, korzystając z prawdziwych danych upstream, wartości, które sam sobie mockujesz, lub wyników z poprzedniego uruchomienia.

Istnieją dwa sposoby uruchamiania testu:

Co chcesz zweryfikować Jak przetestować Gdzie go znaleźć
Pojedyncza akcja lub krok sztucznej inteligencji w izolacji Testowanie tego węzła Karta testu w panelu bocznym węzła
Pełny przepływ pracy, od początku do końca Uruchamianie testu przepływu Przycisk Odtwórz na górnym pasku poleceń

Oba interfejsy opierają się na tej samej koncepcji: wprowadź dane wejściowe (rzeczywiste lub symulowane), uruchom działanie, a następnie sprawdź dane wyjściowe.

Testowanie pojedynczego węzła w przepływie pracy

Otwórz dowolną akcję lub węzeł w przepływie pracy i wybierz przycisk Play lub Test. Istnieją trzy sekcje:

  1. Uruchom/Resetuj test: uruchamia krok na żądanie lub czyści bieżące dane wejściowe i wyjściowe.

    Zrzut ekranu przedstawiający panel testowy węzła przedstawiający sekcje Dane wejściowe, Konfigurowanie i Dane wyjściowe z wyróżnionym przyciskiem Test.

  2. Wartości ładowania z poprzednich rozgrywek: rozwijane menu ostatnich uruchomieni tego workflow. Wybranie jednego pobiera dane wyjściowe z kroku nadrzędnego z tego uruchomienia do poniższych pól wejściowych.

  3. Dane wejściowe: jedno edytowalne pole na krok nadrzędny zwraca odwołania do węzła. Odznaka po prawej stronie każdego wiersza pokazuje oczekiwany typ pola (ciąg tekstów, e-mail, data-godzina, numer itd.).

  4. Wyjście: Żywy wynik najnowszego testu, sformatowany pod kątem typu węzła.

Przykładowe dane wejściowe

Domyślnie pola wejściowe są puste. Masz następujące możliwości:

  • Wpisz dowolną wartość bezpośrednio w polu. Pole akceptuje typ wyświetlany na prawej plakietce.
  • Pozostaw pole puste, jeśli Twój krok nie zależy od niego.

Zrzut ekranu przedstawiający panel testowy węzła z pustymi polami wejściowymi z wskaźnikami typu po prawej stronie.

Wskazówka

Karta Test automatycznie wyświetla dane wyjściowe kroku nadrzędnego, do których odwołują się wyrażenia tego węzła. Jeśli dodasz nowy token do węzła, odpowiednie pole pojawi się przy następnym otwarciu testu.

Wczytaj wartości z poprzedniego przebiegu

Zrzut ekranu przedstawiający listę rozwijaną

Jeśli Twój workflow działał wcześniej, możesz odtwarzać prawdziwe dane zamiast ich wpisywać:

  1. Na liście rozwijanej Załaduj wartości z poprzedniego uruchomienia wybierz uruchomienie.

  2. Projektant systemowy pobiera dane wyjściowe kroków z bieżącego uruchomienia i przepuszcza je przez schemat wejściowy węzła. Pasujące wartości są zapisywane w polach wejściowych.

  3. Następnie zmodyfikuj dowolne pole, jeśli chcesz dostosować scenariusz.

Lista rozwijana pokazuje 10 najnowszych uruchomień o dowolnym statusie. Jeśli uruchomienie nie zawiera wyjść dla jednego z twoich kroków upstream, ponieważ ten krok został pominięty lub ścieżka nie została wybrana, wypełniane są tylko dostępne pola. Reszta pozostaje taka, jaka była.

Jeśli workflow nie działał wcześniej, wyświetlane są żadne wcześniejsze uruchomienia i rozwijane menu jest ukryte.

Uruchamianie testu

Wybierz Uruchom test. Przycisk pokazuje stan zajętości, gdy połączenie jest w toku; W sekcji Wynik jest wyświetlane wirujące kółko, a następnie wynik lub błąd.

  • Test resetuj czyści zarówno dane wejściowe, jak i ostatnie dane wyjściowe.
  • Test uruchamia węzeł w izolacji od interfejsu API łącznika. Test nie uruchamia reszty workflow.

Przetestuj cały workflow

Na górnym pasku poleceń wybierz przycisk odtwarzania (Testuj). Test wykonuje Twój workflow end-to-end względem live runtime.

Przed rozpoczęciem działania projektant:

  1. Zapisuje i publikuje workflow, jeśli masz niezapisane zmiany lub jeśli to pierwszy raz.
  2. Instaluje wszystkie nowe połączenia w pierwszym uruchomieniu.
  3. Wyzwala uruchomienie. Ścieżka zależy od typu wyzwalacza.
Typ wyzwalacza Co się stanie po wybraniu pozycji Testuj
Żądanie ręczne/http Otwiera się okno dialogowe, w którym możesz wprowadzić trigger input, a workflow uruchamia się natychmiast.
Cykl/przesuwane okno/sondowanie Albo harmonogram się zaczyna, a pierwszy uruchomienie uruchamia się automatycznie, albo, jeśli jest już zainstalowany, workflow uruchamia się raz.
Zdarzenie łącznika (na przykład po nadejściu wiadomości e-mail) Workflow jest publikowany i czeka. Możesz zobaczyć Waiting for trigger.... Wykonaj akcję w systemie źródłowym, aby uruchomić przebieg.
Webhook HTTP Workflow jest publikowany; Uruchamiaj go z zewnętrznego systemu, jak zwykle.

Symulacja wejść (ręczne wyzwalanie)

W przypadku manualnych wyzwalaczy, dialog Enter z ręcznym wyzwalaczem renderuje jedno pole na każde zdefiniowane przez Ciebie wejście na wyzwalaczu:

  • Tekst/numer/wiadomość e-mail/data: Odpowiedni element kontroli wejścia.
  • Wartość logiczna: przełącznik dwupozycyjny.
  • Wybór pojedynczy (typ wyliczeniowy): lista rozwijana.
  • Wybór wielokrotny: lista rozwijana wyboru wielokrotnego.
  • Plik: Przegląd plików. Zawartość jest przesyłana w ramach serii.
  • Obiekt/tablica: wielowierszowy obszar tekstowy, w którym można wkleić kod JSON.

Wybierz Uruchom, aby rozpocząć workflow z tymi wejściami, lub Anuluj , aby zwolnić bez uruchomienia. Wymagane pola są oznaczone gwiazdką. Jeśli brakuje wartości lub są one nieprawidłowe, wyświetlane są wbudowane komunikaty sprawdzania poprawności i uruchomienie zostanie zablokowane do momentu ich naprawienia.

Dialog pojawia się za każdym razem, gdy wybierzesz Test. Wartości nie są zapisywane między przebiegami, więc możesz szybko wypróbować różne scenariusze.

Obejrzyj przebieg

Gdy przebieg będzie uruchamiany w locie:

  • Na pasku poleceń jest wyświetlany przycisk Anuluj , gdy przebieg jest aktywny.
  • Panel Aktywności po prawej stronie wyświetla aktualny przebieg na górze wraz ze statusem: Biegnie, Czekanie, Sukces,Niepowodzenie lub Anulowanie. Wybierz dowolny przebieg, aby otworzyć go na kanwie i zbadać dane wejściowe i wyjściowe poszczególnych kroków.

Wybierz poprzednie przebiegi

Panel Aktywności pełni również funkcję historii uruchomienia Twojego workflow:

  • Filtruj według wszystkich/Sukces/Nieudanych/Działających, korzystając z rozwijanego menu na górze.
  • Wybierz pozycję Odśwież , aby ponownie pobrać listę.
  • Wybierz pozycję Załaduj więcej u dołu, aby wrócić do dalszej strony.
  • Wybranie przebiegu powoduje załadowanie go na kanwę, gdzie każdy węzeł wyświetla odebrane dane wejściowe i dane wyjściowe utworzone dla tego przebiegu. Dane są takie same jak te używane w zakładce Test na poziomie węzła, gdy wybierasz przebieg z listy rozwijanej.

Kiedy należy używać każdego typu testu

  • Iteracja na jednym kroku AI lub akcji złącza? Użyj Test tego węzła. Jest szybszy, nie publikuje i pozwala mockować tylko te wartości upstream, które się liczą.
  • Weryfikacja zachowań end-to-end lub logiki wyzwalaczy? Użyj Uruchom test przepływu. Testuje cały wykres względem rzeczywistego czasu działania.
  • Odtwarzanie problemu produkcyjnego? Otwórz nieudane uruchomienie w panelu Aktywności, następnie otwórz uszkodzony węzeł i użyj wartości ładowania z poprzedniego uruchomienia w zakładce Test, aby odtworzyć dokładne dane upstream do akcji.