NeboAI
NeboAI
Zacznij

Wyzwalacze

Wyzwalacz decyduje, kiedy uruchamia się przepływ pracy. Nebo ma siedem typów wyzwalaczy. Każdy to obiekt z polem typu i polami właściwymi dla tego typu.

TypUruchamia się, gdy
schedulePasuje wyrażenie cron.
heartbeatMija określony odstęp czasu, opcjonalnie w obrębie dziennego okna.
eventZostaje wyemitowane zdarzenie o pasującym źródle.
watchObserwator wtyczki zapisuje wiersz danych wyjściowych.
folderZmieniają się pliki w folderze.
manualUruchamia go właściciel lub pracownik.
callDzwoni linia telefoniczna. Tylko w drzewach połączeń telefonicznych.

schedule

{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" }

cron to pięciopolowe wyrażenie cron: minuta, godzina, dzień miesiąca, miesiąc, dzień tygodnia. schedule to opcjonalny opis dla ludzi. Harmonogramy działają w lokalnej strefie czasowej bota. Nebo sprawdza harmonogramy co pięć sekund. Uruchomienie pominięte, gdy bot był wyłączony, jest nadrabiane raz, jeśli opóźnienie wynosi mniej niż godzinę. Uruchomienie jest pomijane, dopóki trwa poprzednie.

heartbeat

{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" }

interval to okres, np. 30m, 1h lub 2h30m. window, HH:MM-HH:MM, utrzymuje uruchomienia w godzinach pracy. Następne uruchomienie to ostatnie uruchomienie plus odstęp, przesunięte do okna; pierwsze następuje jeden odstęp po załadowaniu przepływu pracy. Liczniki czasu przetrwają restarty. Uruchomienie jest pomijane, dopóki trwa poprzednie, a nieprawidłowy odstęp nigdy się nie uruchamia.

event

{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] }

sources wymienia nazwy zdarzeń do dopasowania dokładnie albo z symbolem wieloznacznym .* na końcu. Pusta lista to błąd, który powoduje odrzucenie całego agent.json. Uruchomienie otrzymuje _event_source, _event_payload i _event_origin. Zobacz Zdarzenia, aby dowiedzieć się, jak tworzone są nazwy.

watch

{ "type": "watch", "plugin": "mail", "event": "email.new" }

Obserwacja utrzymuje działający proces wtyczki i uruchamia przepływ dla każdego zapisanego przez niego wiersza. Każdy wiersz trafia jako _watch_payload. Identyczne wiersze w ciągu dziesięciu minut są odrzucane.

PoleDomyślnieZnaczenie
pluginwymaganeMożliwość, np. mail, albo slug wtyczki. Podawaj możliwość zawsze, gdy któraś pasuje.
eventbrakZdarzenie z listy events wtyczki. Nebo używa polecenia tego zdarzenia i dodatkowo emituje każdy wiersz jako <plugin>.<event>.
commandbrakArgumenty uruchamiające obserwatora. Używane, gdy są ustawione; w przeciwnym razie pobierane z event.
restart_delay_secs5Czas oczekiwania przed ponownym uruchomieniem obserwatora, który się zakończył.

Możliwość wskazuje zainstalowaną wtyczkę, która ją zapewnia, preferując taką, w której ten pracownik ma konto. Jeśli takiej wtyczki nie ma, przepływ pracy zostaje oznaczony jako ograniczony, a właściciel dowiaduje się, co połączyć. Obserwator, który ciągle ulega awarii, uruchamia się ponownie z opóźnieniem podwajanym aż do 300 sekund i resetowanym po 30 sekundach działania.

{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" }

{{key}} w command jest wypełniany odpowiedziami właściciela na pola wejściowe pracownika. Jeśli symbol zastępczy nie ma odpowiedzi, obserwowanie się nie uruchamia.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
PoleDomyślnieZnaczenie
pathwymaganeŚcieżka bezwzględna folderu. {{key}} jest wypełniane z danych wejściowych.
extensionswszystkie plikiRozszerzenia plików do dopasowania, bez kropki.
recursivetrueUwzględnij podfoldery.
debounce_secs2Zmiany w tym oknie czasowym stają się jednym uruchomieniem.

Uruchomienie otrzymuje zmienione ścieżki w _watch_payload.files.

manual

{ "type": "manual" }

Ręczny przepływ pracy uruchamia się tylko wtedy, gdy uruchomi go właściciel albo pracownik wywoła run_workflow. W ten sposób można też uruchomić każdy przepływ pracy, niezależnie od jego wyzwalacza.

call

{"type": "call", "line": "..."} jest prawidłowe tylko w przepływie pracy typu "type": "call_tree", który określa, jak pracownik odbiera połączenia na linii telefonicznej. Puste line dotyczy każdej linii obsługiwanej przez pracownika, która nie ma bardziej szczegółowego drzewa. Drzewo połączeń musi mieć dokładnie jedno powitanie i co najmniej jedną nazwaną intencję.

Webhooki

Właściciel może też utworzyć webhook dla pracownika. Webhook powiązany z przepływem pracy uruchamia ten przepływ; webhook bez przepływu pracy dostarcza swoje dane do czatu pracownika.