NeboAI
NeboAI
Zacznij

Aktywności

Czynność to jeden krok przepływu pracy. Większość czynności wykonuje pracownik: określasz zamiar, a on wykonuje pracę za pomocą swoich umiejętności i połączeń. Sześć typów działa bez modelu, więc kierowanie i czas pozostają dokładne.

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" }
}
PoleDomyślnieZnaczenie
idwymaganeUnikalny w obrębie przepływu pracy. Używany w connections i ścieżkach danych.
typecustomKrok pracownika albo jeden z typów: condition, loop, wait, http, command, decide.
intentbrakCo pracownik ma osiągnąć. Krok pracownika wymaga intent lub steps.
steps[]Uporządkowane instrukcje, gdy jedno zdanie nie wystarcza.
labelbrakNazwa 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.
modelbrakIdentyfikator modelu dla tego kroku.
paramsbrakParametry dla czynności typowanych oraz maxIterations dla kroków pracownika.
min_iterationsbrakMinimalna liczba tur modelu, zanim krok może się zakończyć.
token_budgetbrak{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:

TrybWyrażenie
expressionDomyś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ą.
containspath contains text albo sam tekst dopasowywany do poprzednich danych wyjściowych.
regexWzorzec 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" } }
TypWymaganeDziałanie
waitparams.durationWstrzymuje 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.
httpparams.urlWysyła żądanie. method, headers i body są opcjonalne.
commandparams.commandUruchamia 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 pytaniacriteriaOdpowiedź
choiceObiekt przypisujący opcjom opisy, od 2 do 255 opcji.choice, confidence i probabilities.
scoreLista od 2 do 10 uporządkowanych poziomów.score od 0 (pierwszy poziom) w górę oraz confidence.
noulBrak.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ść.