| Typ | Körs när |
|---|---|
schedule | Ett cron-uttryck matchar. |
heartbeat | Ett intervall passerar, eventuellt inom ett dagligt tidsfönster. |
event | En händelse med matchande källa skickas. |
watch | En pluginbevakare skriver en rad utdata. |
folder | Filer ändras i en mapp. |
manual | Ägaren eller en medarbetare kör det. |
call | En telefonlinje ringer. Bara i samtalsträd för telefon. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron är ett cron-uttryck med fem fält: minut, timme, dag i månaden, månad, veckodag. schedule är en valfri beskrivning för människor. Scheman körs i botens lokala tidszon. Nebo kontrollerar scheman var femte sekund. En körning som missades medan boten var avstängd tas igen en gång om den är mindre än en timme sen. En körning hoppas över medan den föregående fortfarande pågår.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval är ett tidsspann, till exempel 30m, 1h eller 2h30m. window, HH:MM-HH:MM, håller körningarna inom arbetstid. Nästa körning är den senaste plus intervallet, flyttad in i tidsfönstret; den första sker ett intervall efter att arbetsflödet laddats. Timrar överlever omstarter. En körning hoppas över medan den föregående fortfarande pågår, och ett ogiltigt intervall utlöses aldrig.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources listar händelsenamn som ska matchas exakt, eller med ett avslutande jokertecken .*. En tom lista är ett fel som gör att hela agent.json avvisas. Körningen får _event_source, _event_payload och _event_origin. Se Händelser för hur namn bildas.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } En bevakning håller en pluginprocess igång och startar en körning för varje rad den skriver. Varje rad kommer fram som _watch_payload. Identiska rader inom tio minuter tas bort.
| Fält | Standard | Betydelse |
|---|---|---|
plugin | obligatoriskt | En förmåga, till exempel mail, eller ett plugins slug. Ange en förmåga när det finns en som passar. |
event | inget | En händelse från pluginets events-lista. Nebo använder den händelsens kommando och skickar också varje rad som <plugin>.<event>. |
command | inget | Argument som startar bevakaren. Används när det är angivet; annars hämtas det från event. |
restart_delay_secs | 5 | Väntetid innan en bevakare som avslutas startas om. |
En förmåga löses upp till det installerade plugin som tillhandahåller den, i första hand ett som den här medarbetaren har ett konto på. Finns inget sådant plugin markeras arbetsflödet som nedsatt och ägaren får veta vad som ska anslutas. En bevakare som fortsätter att krascha startas om med en fördröjning som fördubblas upp till 300 sekunder och nollställs efter 30 sekunders drifttid.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} i command fylls i från ägarens svar på medarbetarens indata. Om en platshållare saknar svar startar inte bevakningen.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Fält | Standard | Betydelse |
|---|---|---|
path | obligatoriskt | Absolut sökväg till mappen. {{key}} fylls i från indata. |
extensions | alla filer | Filändelser att matcha, utan punkten. |
recursive | true | Inkludera undermappar. |
debounce_secs | 2 | Ändringar inom detta tidsfönster blir en körning. |
Körningen får de ändrade sökvägarna i _watch_payload.files.
manual
{ "type": "manual" } Ett manuellt arbetsflöde körs bara när ägaren kör det eller en medarbetare anropar run_workflow. Alla arbetsflöden, oavsett utlösare, kan också köras på det här sättet.
call
{"type": "call", "line": "..."} är bara giltig i ett arbetsflöde av typen "type": "call_tree", som konfigurerar hur en medarbetare svarar på en telefonlinje. En tom line gäller varje linje som medarbetaren svarar på och som inte har ett mer specifikt träd. Ett samtalsträd måste ha exakt en hälsning och minst en namngiven avsikt.
Webhooks
Ägaren kan också skapa en webhook för en medarbetare. En webhook som är kopplad till ett arbetsflöde kör det arbetsflödet; en utan arbetsflöde levererar sin nyttolast till medarbetarens chatt.