Uruchamianie i debugowanie scenariusza
Uruchamianie
Section titled “Uruchamianie”Służy do tego przycisk uruchomienia w edytorze. Jest nieaktywny, dopóki pozostają błędy walidacji.
Jeśli scenariusz deklaruje parametry bez wartości, Restorm pyta o nie w chwili, gdy wykonanie do nich dotrze.
Śledzenie wykonania
Section titled “Śledzenie wykonania”Dziennik wykonania zapełnia się na bieżąco. Każdy wpis ma poziom (debug,
info, warn, error), znacznik czasu z dokładnością do milisekundy,
komunikat, a niekiedy również dane strukturalne.
Dwa poziomy szczegółowości:
- domyślnie wyświetlane są wyłącznie wpisy własne — te wytworzone przez akcję Log;
- widok pełny dodaje wpisy silnika: start i koniec każdego bloku, wartości przechodzące przez połączenia, błędy.
Przycisk kopiowania dziennika wytwarza dokładnie ten sam tekst, co wyjście wiersza poleceń: to, co zostaje wklejone do zgłoszenia, jest identyczne z tym, co wytworzy CI.
Historia uruchomień
Section titled “Historia uruchomień”Wykonania są archiwizowane obok projektu, w tym samym pliku co historia odpowiedzi. Domyślnie: 50 ostatnich wykonań, 2 000 wpisów dziennika na wykonanie, z czasem życia 30 minut.
Zatrzymywanie
Section titled “Zatrzymywanie”Przycisk zatrzymania przerywa wykonanie. Trwające oczekiwania (Czekaj, Czekaj do, Czasomierz) przerywają się czysto, otwarte połączenia zostają zamknięte, a trwające akcje kodu — porzucone.
Uruchamianie pojedynczego bloku
Section titled “Uruchamianie pojedynczego bloku”Bloki typu żądanie można wykonywać osobno, bez uruchamiania całego scenariusza: to szybki sposób na sprawdzenie, że wywołanie faktycznie wychodzi, przed podłączeniem pozostałej części.
Debugowanie
Section titled “Debugowanie”Dziennik jako pierwszy odruch
Section titled “Dziennik jako pierwszy odruch”Warto dodać akcje Log w strategicznych miejscach: to console.log grafu,
i to samo pojawi się w CI.
Powiadomienia
Section titled “Powiadomienia”Akcja Toast wyświetla komunikat w interfejsie. Przydaje się podczas budowania — bez efektu w trybie headless, gdzie wykonanie przebiega dalej normalnie.
Inspektor krok po kroku
Section titled “Inspektor krok po kroku”Edycja Pro daje dostęp do debugowania krok po kroku: punkty przerwania na blokach, kontrolowane przechodzenie, badanie przesyłanych wartości. Zob. Plany i możliwości.
Każdy blok (poza Output, Teraz i Retry) ma port error. Blok, który
zawodzi, a jego port error nie jest podłączony, powoduje niepowodzenie
wykonania.
Dwa przydatne wzorce:
- Retry — otacza granicę błędu: niepowodzenia w dół grafu są przechwytywane
i ponawiane zgodnie ze skonfigurowaną strategią (stała, liniowa, wykładnicza),
z wyjściem
exhausted, gdy próby zostaną wyczerpane. - Throw — zawodzi celowo, wraz z komunikatem. To właściwe narzędzie, aby zadanie CI zakończyło się niepowodzeniem na warunku biznesowym.
Sterowanie przez MCP
Section titled “Sterowanie przez MCP”Agent AI może uruchamiać i nadzorować scenariusz (edycja Pro): run_scenario
(z params, interactive, blocking), get_scenario_run_status (który zwraca
dziennik, oczekujące prośby o wprowadzenie danych oraz drzewo podrzędnych
uruchomień), list_scenario_runs, stop_scenario_run oraz
answer_scenario_input. Zob. Narzędzia MCP.