Zbuduj pierwszy potok

Co zbudujesz

Po ukończeniu tego samouczka będziesz mieć:

• Zapisany szablon potoku, który wysyła agenta z promptem
• Włączone ręczne uruchomienia, dzięki którym szablon da się uruchomić z ręki
• Jedno ukończone uruchomienie, z widocznym wejściem i wyjściem kroku

Wymagania wstępne: ukończony Wyślij pierwszego agenta, czyli agent z adapterem i modelem.

Potok to DAG kroków. Szablony definiują graf, a uruchomienia to wykonania. Model, który za tym stoi, opisuje Potoki i automatyzacja; pełne słownictwo kroków znajdziesz w Rodzajach kroków potoku.

Krok 1: Utwórz szablon

1. Przejdź do Ustawienia → Obszar roboczy → Szablony potoków
2. Kliknij Nowy szablon

Edytor otwiera się na przygotowanym szkielecie o nazwie Nowy potok (id pipeline_N). Kliknij tytuł w nagłówku i zmień nazwę — w tym samouczku dobrze sprawdzi się code_quality_check. Nie ma okna dialogowego z identyfikatorem ani pola opisu.

Kanwa nie jest pusta. Nowy szablon jest od razu podłączony jako Trigger → Step → wartownik, gdzie „Step” to węzeł agenta promptowego, a wartownik to niewidzialny element, który edytor przepina na każde osiągalne ujście.

Konfigurujesz ten Step, który już tam jest.

Krok 2: Skonfiguruj krok

1. Kliknij węzeł Step na kanwie
2. W panelu Konfiguracja węzła po prawej ustaw:
   • Agent: swojego agenta z poprzedniego samouczka
   • Szablon promptu: „Przejrzyj kod na bieżącej gałęzi pod kątem problemów z jakością. Wypisz, co znajdziesz.”
3. Pozostaw Triggers from bez zmian — węzeł jest już podłączony tak, aby uruchamiał się po Trigger

Krok 3: Zapisz

Naciśnij Zapisz w nagłówku edytora.

Punkt kontrolny. Podpis „Niezapisane zmiany” znika.

Krok 4: Zezwól na ręczne uruchomienia

1. Kliknij przerywany kafelek Dodaj wyzwalacz na kanwie (albo przeciągnij Uruchomienie ręczne z sekcji Wyzwalacze biblioteki węzłów) i wybierz Uruchomienie ręczne.
2. Wybierz ten węzeł. W inspektorze po prawej włącz Włączone — „Pokaż na stronie uruchomienia i startuj ręcznie.”

To nie jest opcjonalne i łatwo to przeoczyć. Nowy szablon powstaje bez żadnego wiersza wyzwalacza, więc dopóki tego nie włączysz, strona uruchamiania nie będzie go wyświetlać i nie będzie czego uruchomić. Przełącznik zapisuje wyzwalacz od razu; nie czeka na kolejne zapisanie.

Ten sam przełącznik kryje się za Ręczne uruchamianie w nagłówku edytora, obok zadeklarowanych danych wejściowych szablonu.

Krok 5: Uruchom go

1. Kliknij Potoki na pasku bocznym
2. Kliknij Uruchom potok w nagłówku
3. Wybierz code_quality_check na lewej szynie
4. Kliknij Uruchom potok w formularzu — Twój szablon nie deklaruje żadnych danych wejściowych, więc nie ma czego wypełniać

Punkt kontrolny. Powiadomienie typu toast potwierdza rozpoczęcie uruchomienia, a Control Center otwiera szczegóły uruchomienia.

Silnik tworzy rekord uruchomienia, kończy wyzwalacz, planuje krok, wysyła agenta i kończy uruchomienie, gdy zakończy się gałąź wchodząca do wartownika.

Krok 6: Sprawdź wynik

Kliknij krok w uruchomieniu, aby otworzyć jego panel szczegółów:

• Znaczniki czasu Rozpoczęto i Zakończono oraz Czas trwania
• Wejście: stan przekazany do kroku
• Wyjście: to, co krok wygenerował — tutaj odpowiedź agenta
• Aktywność agenta, z odsyłaczem do rozmowy, którą poprowadził krok

Punkt kontrolny. Krok widnieje jako ukończony, a jego wyjście zawiera recenzję agenta.

Dodawanie kolejnych kroków

Węzły dodaje się, przeciągając pozycję z biblioteki węzłów po lewej na kanwę, albo naciskając Dodaj krok (+) tuż za węzłem. Przeciągnij z portu wyjściowego węzła na inny węzeł, aby je połączyć, albo wybierz nowy węzeł i zaznacz jego krok nadrzędny pod Triggers from.

Węzeł wartownika nie jest rysowany i nie można go wybrać. Edytor przepina go na każde osiągalne ujście, więc węzeł dodany po początkowym Step i tak się wykona.

Podsumowanie

Utworzyłeś szablon, skonfigurowałeś węzeł agenta promptowego z przygotowanego szkieletu, zapisałeś go, uczyniłeś go uruchamialnym ręcznie, rozpocząłeś uruchomienie i odczytałeś wejście oraz wyjście kroku.

Potoki bywają znacznie większe — routery warunkowe, równoległe gałęzie, węzły złączeń, rozgałęzienia for-each, bramki dla człowieka — ale ich kształt nigdy się nie zmienia: kroki w DAG, przekazujące stan.

Dalej: Połącz Slack z obszarem roboczym, ostatni samouczek w tej serii.

• Skonfiguruj wyzwalacze potoków, aby uruchamiać potoki na podstawie zdarzeń lub harmonogramu
• Potoki i automatyzacja — model, który za tym stoi
• Rodzaje kroków potoku — każdy typ kroku