NeboAI
NeboAI
Kezdés

Indítók

Az indító határozza meg, mikor fut egy munkafolyamat. A Nebónak hét indítótípusa van. Mindegyik egy objektum, amely egy type mezőt és az adott típushoz tartozó mezőket tartalmazza.

TípusMikor fut
scheduleEgy cron-kifejezés egyezik.
heartbeatEltelik egy időköz, opcionálisan egy napi időablakon belül.
eventEgyező forrású esemény bocsátódik ki.
watchEgy bővítményfigyelő kiír egy kimeneti sort.
folderFájlok változnak egy mappában.
manualA tulajdonos vagy egy munkatárs futtatja.
callMegcsörren egy telefonvonal. Csak telefonos hívásfákban.

schedule

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

A cron egy ötmezős cron-kifejezés: perc, óra, hónap napja, hónap, hét napja. A schedule opcionális leírás az embereknek. Az ütemezések a bot helyi időzónájában futnak. A Nebo ötmásodpercenként ellenőrzi az ütemezéseket. Az az indítás, amely a bot kikapcsolt állapota alatt maradt el, egyszer pótlódik, ha egy óránál kevesebbet késett. Egy indítás kimarad, amíg az előző futás még tart.

heartbeat

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

Az interval egy időtartam, például 30m, 1h vagy 2h30m. A window (HH:MM-HH:MM) a munkaidőn belül tartja az indításokat. A következő indítás az utolsó indítás plusz az időköz, az időablakba tolva; az első egy időközzel a munkafolyamat betöltése után történik. Az időzítők túlélik az újraindításokat. Egy indítás kimarad, amíg az előző futás még tart, az érvénytelen időköz pedig soha nem indít.

event

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

A sources felsorolja a pontosan, vagy záró .* helyettesítő karakterrel illesztendő eseményneveket. Az üres lista hiba, amely miatt az egész agent.json elutasításra kerül. A futás megkapja az _event_source, az _event_payload és az _event_origin értéket. A nevek kialakulásáról lásd: Események.

watch

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

A watch egy bővítményfolyamatot tart futásban, és minden általa kiírt sorhoz elindít egy futást. Minden sor _watch_payload formában érkezik. A tíz percen belüli azonos sorokat elveti.

MezőAlapértékJelentés
pluginkötelezőEgy képesség, például mail, vagy egy bővítmény slugja. Nevezzen meg képességet, valahányszor van megfelelő.
eventnincsEgy esemény a bővítmény events listájából. A Nebo az adott esemény parancsát használja, és minden sort <plugin>.<event> néven is kibocsát.
commandnincsA figyelőt elindító argumentumok. Ha meg vannak adva, ezeket használja; egyébként az event alapján veszi.
restart_delay_secs5Várakozás egy leálló figyelő újraindítása előtt.

A képesség az azt nyújtó telepített bővítményre oldódik fel, előnyben részesítve azt, amelyben ennek a munkatársnak van fiókja. Ha nincs ilyen bővítmény, a munkafolyamat korlátozottként jelölődik meg, és a tulajdonos értesítést kap arról, mit csatlakoztasson. Az ismételten összeomló figyelő egyre hosszabb, legfeljebb 300 másodpercig duplázódó késleltetéssel indul újra, amely 30 másodperc üzemidő után visszaáll.

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

A command mezőben lévő {{key}} a tulajdonosnak a munkatárs bemeneteire adott válaszaiból töltődik ki. Ha egy helyőrzőre nincs válasz, a figyelés nem indul el.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
MezőAlapértékJelentés
pathkötelezőAbszolút mappaútvonal. A {{key}} a bemenetekből töltődik ki.
extensionsminden fájlIllesztendő fájlkiterjesztések, pont nélkül.
recursivetrueAlmappák bevonása.
debounce_secs2Az ezen az időablakon belüli változások egy futássá válnak.

A futás a módosult útvonalakat a _watch_payload.files mezőben kapja meg.

manual

{ "type": "manual" }

A manuális munkafolyamat csak akkor fut, amikor a tulajdonos futtatja, vagy egy munkatárs meghívja a run_workflow eszközt. Minden munkafolyamat, indítójától függetlenül, így is futtatható.

call

A {"type": "call", "line": "..."} csak "type": "call_tree" típusú munkafolyamatban érvényes, amely azt állítja be, hogyan válaszol egy munkatárs egy telefonvonalon. Az üres line minden olyan vonalra vonatkozik, amelyet a munkatárs fogad, és amelyhez nincs pontosabb fa. Egy hívásfának pontosan egy üdvözléssel és legalább egy elnevezett szándékkal kell rendelkeznie.

Webhookok

A tulajdonos egy munkatárshoz webhookot is létrehozhat. A munkafolyamathoz kötött webhook az adott munkafolyamatot futtatja; a munkafolyamat nélküli webhook a munkatárs csevegésébe kézbesíti az adattartalmát.