Task Flow to warstwa orkiestracji przepływów znajdująca się ponad zadaniami w tle. Zarządza trwałymi, wieloetapowymi przepływami z własnym stanem, śledzeniem rewizji i semantyką synchronizacji, podczas gdy poszczególne zadania pozostają jednostką odłączonej pracy.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Kiedy używać Task Flow
Używaj Task Flow, gdy praca obejmuje wiele sekwencyjnych lub rozgałęzionych kroków i potrzebujesz trwałego śledzenia postępu między restartami Gateway. W przypadku pojedynczych operacji w tle wystarczy zwykłe zadanie.| Scenariusz | Użycie |
|---|---|
| Pojedyncze zadanie w tle | Zwykłe zadanie |
| Wieloetapowy potok (A, potem B, potem C) | Task Flow (zarządzany) |
| Obserwowanie zadań utworzonych zewnętrznie | Task Flow (lustrzany) |
| Jednorazowe przypomnienie | Zadanie Cron |
Wzorzec niezawodnego zaplanowanego przepływu pracy
W przypadku cyklicznych przepływów pracy, takich jak briefingi z analizy rynku, traktuj harmonogram, orkiestrację i kontrole niezawodności jako oddzielne warstwy:- Użyj zaplanowanych zadań do obsługi czasu.
- Użyj trwałej sesji Cron, gdy przepływ pracy powinien bazować na wcześniejszym kontekście.
- Użyj Lobster do deterministycznych kroków, bramek zatwierdzania i tokenów wznowienia.
- Użyj Task Flow do śledzenia wieloetapowego przebiegu obejmującego zadania podrzędne, oczekiwania, ponowienia i restarty Gateway.
session:<id> zamiast isolated, gdy cykliczny przepływ pracy potrzebuje zamierzonej historii, podsumowań poprzednich uruchomień lub stałego kontekstu. Użyj isolated, gdy każde uruchomienie powinno zaczynać od nowa, a cały wymagany stan jest jawnie określony w przepływie pracy.
Wewnątrz przepływu pracy umieść kontrole niezawodności przed krokiem podsumowania LLM:
- Dostępność przeglądarki i wybór profilu, na przykład
openclawdla stanu zarządzanego albouser, gdy wymagana jest zalogowana sesja Chrome. Zobacz Przeglądarka. - Poświadczenia API i limity dla każdego źródła.
- Osiągalność sieciowa wymaganych punktów końcowych.
- Wymagane narzędzia włączone dla agenta, takie jak
lobster,browserillm-task. - Miejsce docelowe błędów skonfigurowane dla Cron, aby niepowodzenia kontroli wstępnych były widoczne. Zobacz Zaplanowane zadania.
sourceUrl, retrievedAt oraz asOf w swoim wyniku. Użyj LLM Task, gdy potrzebujesz kroku modelu z walidacją schematu wewnątrz przepływu pracy.
W przypadku przepływów pracy wielokrotnego użytku dla zespołu lub społeczności spakuj CLI, pliki .lobster oraz wszelkie notatki konfiguracyjne jako Skills lub plugin i opublikuj je przez ClawHub. Zachowaj zabezpieczenia specyficzne dla przepływu pracy w tym pakiecie, chyba że API pluginu nie ma potrzebnej ogólnej funkcji.
Tryby synchronizacji
Tryb zarządzany
Task Flow posiada cały cykl życia od początku do końca. Tworzy zadania jako kroki przepływu, doprowadza je do ukończenia i automatycznie przesuwa stan przepływu. Przykład: cotygodniowy przepływ raportu, który (1) zbiera dane, (2) generuje raport i (3) dostarcza go. Task Flow tworzy każdy krok jako zadanie w tle, czeka na ukończenie, a następnie przechodzi do następnego kroku.Tryb lustrzany
Task Flow obserwuje zadania utworzone zewnętrznie i utrzymuje stan przepływu w synchronizacji bez przejmowania odpowiedzialności za tworzenie zadań. Jest to przydatne, gdy zadania pochodzą z zadań Cron, poleceń CLI lub innych źródeł, a chcesz mieć ujednolicony widok ich postępu jako przepływu. Przykład: trzy niezależne zadania Cron, które razem tworzą rutynę „porannych operacji”. Przepływ lustrzany śledzi ich łączny postęp bez kontrolowania, kiedy ani jak działają.Trwały stan i śledzenie rewizji
Każdy przepływ utrwala własny stan i śledzi rewizje, aby postęp przetrwał restarty Gateway. Śledzenie rewizji umożliwia wykrywanie konfliktów, gdy wiele źródeł próbuje jednocześnie przesunąć ten sam przepływ. Rejestr przepływów używa SQLite z ograniczoną konserwacją dziennika write-ahead log, w tym okresowymi punktami kontrolnymi i punktami kontrolnymi przy zamykaniu, dzięki czemu długo działające Gateway nie przechowują nieograniczonych plików pomocniczychregistry.sqlite-wal.
Zachowanie anulowania
openclaw tasks flow cancel ustawia trwały zamiar anulowania w przepływie. Aktywne zadania w przepływie są anulowane i żadne nowe kroki nie są uruchamiane. Zamiar anulowania utrzymuje się między restartami, więc anulowany przepływ pozostaje anulowany nawet wtedy, gdy Gateway uruchomi się ponownie, zanim wszystkie zadania podrzędne zostaną zakończone.
Polecenia CLI
| Polecenie | Opis |
|---|---|
openclaw tasks flow list | Pokazuje śledzone przepływy ze statusem i trybem synchronizacji |
openclaw tasks flow show <id> | Sprawdza jeden przepływ według identyfikatora przepływu lub klucza wyszukiwania |
openclaw tasks flow cancel <id> | Anuluje działający przepływ i jego aktywne zadania |
Jak przepływy odnoszą się do zadań
Przepływy koordynują zadania, nie zastępują ich. Pojedynczy przepływ może uruchamiać wiele zadań w tle w ciągu swojego życia. Użyjopenclaw tasks, aby sprawdzić poszczególne rekordy zadań, oraz openclaw tasks flow, aby sprawdzić przepływ orkiestrujący.
Powiązane
- Zadania w tle — rejestr odłączonej pracy koordynowanej przez przepływy
- CLI: zadania — dokumentacja poleceń CLI dla
openclaw tasks flow - Przegląd automatyzacji — wszystkie mechanizmy automatyzacji w skrócie
- Zadania Cron — zaplanowane zadania, które mogą zasilać przepływy