NeboAI
NeboAI
Kom igång

Utlösare

En utlösare bestämmer när ett arbetsflöde körs. Nebo har sju typer av utlösare. Var och en är ett objekt med ett typfält och fälten för den typen.

TypKörs när
scheduleEtt cron-uttryck matchar.
heartbeatEtt intervall passerar, eventuellt inom ett dagligt tidsfönster.
eventEn händelse med matchande källa skickas.
watchEn pluginbevakare skriver en rad utdata.
folderFiler ändras i en mapp.
manualÄgaren eller en medarbetare kör det.
callEn 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ältStandardBetydelse
pluginobligatorisktEn förmåga, till exempel mail, eller ett plugins slug. Ange en förmåga när det finns en som passar.
eventingetEn händelse från pluginets events-lista. Nebo använder den händelsens kommando och skickar också varje rad som <plugin>.<event>.
commandingetArgument som startar bevakaren. Används när det är angivet; annars hämtas det från event.
restart_delay_secs5Vä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ältStandardBetydelse
pathobligatorisktAbsolut sökväg till mappen. {{key}} fylls i från indata.
extensionsalla filerFiländelser att matcha, utan punkten.
recursivetrueInkludera undermappar.
debounce_secs2Ä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.