Pola
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | Pole | Domyślnie | Znaczenie |
|---|---|---|
id | wymagane | Unikalny w obrębie przepływu pracy. Używany w connections i ścieżkach danych. |
type | custom | Krok pracownika albo jeden z typów: condition, loop, wait, http, command, decide. |
intent | brak | Co pracownik ma osiągnąć. Krok pracownika wymaga intent lub steps. |
steps | [] | Uporządkowane instrukcje, gdy jedno zdanie nie wystarcza. |
label | brak | Nazwa wyświetlana właścicielowi. |
skills | [] | Umiejętności do użycia. Wymienione tu umiejętności ze sklepu są instalowane razem z pracownikiem. |
tools | [] | Gdy ustawione — jedyne narzędzia, których krok może używać. |
requires_tools | [] | Narzędzia, które muszą zakończyć się powodzeniem, aby krok uznano za wykonany. |
cmds | [] | Polecenia wtyczek wskazane dla kroku. |
mcps | [] | Serwery MCP wskazane dla kroku. |
model | brak | Identyfikator modelu dla tego kroku. |
params | brak | Parametry dla czynności typowanych oraz maxIterations dla kroków pracownika. |
min_iterations | brak | Minimalna liczba tur modelu, zanim krok może się zakończyć. |
token_budget | brak | {max}. Szacunek. |
on_error | {retry: 1, fallback: notify_owner} | Ponowne próby, potem działanie zastępcze. Każda awaria po ponownych próbach kończy uruchomienie. |
Kroki pracownika
Krok pracownika działa jako tura pracownika: obowiązują jego persona, pamięć i połączenia, a może on wykorzystać maksymalnie 50 tur modelu lub params.maxIterations. Wyniki wcześniejszych kroków są przekazywane jako bloki [Activity 'id' result]. Krok, który kończy przepływ pracy z listą emit, dostaje polecenie wywołania emit_event z tymi zdarzeniami. Narzędzie exit jest zawsze dostępne, aby zakończyć uruchomienie.
Kontekst danych
Czynności typowane odczytują wartości według ścieżki z kropkami z jednego obiektu: inputs zawiera dane wejściowe uruchomienia, nodes.<id> zawiera dane wyjściowe każdej zakończonej czynności (przetworzone jako JSON, jeśli są w formacie JSON), a item zawiera bieżący element wewnątrz pętli. Sama ścieżka jest szukana najpierw w inputs, potem w nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression jest wymagane. Wychodzące połączenia mają etykiety True i False. params.mode określa sposób odczytu:
| Tryb | Wyrażenie |
|---|---|
expression | Domyślny. path op value z ==, !=, >=, <=, > lub <, porównywane jako liczby, gdy obie strony są liczbami; albo sama ścieżka — prawda, gdy jej wartość jest prawdziwa. |
exists | Ścieżka; prawda, gdy wskazuje wartość prawdziwą. |
contains | path contains text albo sam tekst dopasowywany do poprzednich danych wyjściowych. |
regex | Wzorzec dopasowywany do poprzednich danych wyjściowych. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source to ścieżka listy. Połączenie z etykietą Each item prowadzi do treści pętli, która uruchamia się raz dla każdego elementu z ustawionym item; połączenie z etykietą Done uruchamia się po wszystkich elementach. Iteracje startują jednocześnie, chyba że ustawisz concurrency. Akceptowane są też maxIterations i batchSize.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait, http i command
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | Typ | Wymagane | Działanie |
|---|---|---|
wait | params.duration | Wstrzymuje na okres podany w s, m lub h. Nie ma oczekiwania do określonej chwili; aby wznowić po zdarzeniu, uruchom nim drugi przepływ pracy. |
http | params.url | Wysyła żądanie. method, headers i body są opcjonalne. |
command | params.command | Uruchamia polecenie powłoki. Jego stdout to dane wyjściowe czynności. |
decide
Czynność decide zadaje typowane pytania o dotychczasową pracę i zapisuje ustrukturyzowane odpowiedzi, według których może kierować warunek.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | Typ pytania | criteria | Odpowiedź |
|---|---|---|
choice | Obiekt przypisujący opcjom opisy, od 2 do 255 opcji. | choice, confidence i probabilities. |
score | Lista od 2 do 10 uporządkowanych poziomów. | score od 0 (pierwszy poziom) w górę oraz confidence. |
noul | Brak. | noul, prawdopodobieństwo, że stwierdzenie jest prawdziwe. |
Kieruj według odpowiedzi za pomocą warunku, np. nodes.triage.urgency.score >= 1.5. params.default podaje bezpieczną odpowiedź na każde pytanie, gdy nie da się podjąć decyzji; odpowiedź domyślna ma pewność 0. Pytanie bez wartości domyślnej nie dostaje odpowiedzi, więc oparte na nim warunki idą krawędzią False.
Błędy
on_error.retry określa, ile razy ponawiana jest czynność, która się nie powiodła; domyślnie 1. Po ostatniej próbie uruchomienie się kończy, a przy domyślnym fallback o wartości notify_owner właściciel dostaje powiadomienie. Nebo sprawdza wymagane parametry każdej czynności typowanej na początku uruchomienia i odrzuca gałąź wskazującą nieznaną czynność.