NeboAI
NeboAI
Kom i gang

Udløsere

En udløser bestemmer, hvornår en arbejdsgang kører. Nebo har syv udløsertyper. Hver er et objekt med et type-felt og felterne for den type.

TypeKører, når
scheduleEt cron-udtryk matcher.
heartbeatEt interval går, eventuelt inden for et dagligt tidsvindue.
eventEn hændelse med en matchende kilde udsendes.
watchEn pluginovervåger skriver en linje output.
folderFiler ændres i en mappe.
manualEjeren eller en medarbejder kører den.
callEn telefonlinje ringer. Kun i telefonopkaldstræer.

schedule

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

cron er et cron-udtryk med fem felter: minut, time, dag i måneden, måned, ugedag. schedule er en valgfri beskrivelse til mennesker. Tidsplaner kører i bottens lokale tidszone. Nebo tjekker tidsplaner hvert femte sekund. En udløsning, der blev misset, mens botten var slukket, indhentes én gang, hvis den er mindre end en time forsinket. En udløsning springes over, mens den forrige kørsel stadig er i gang.

heartbeat

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

interval er et tidsrum som 30m, 1h eller 2h30m. window, HH:MM-HH:MM, holder udløsninger inden for arbejdstiden. Den næste udløsning er den sidste udløsning plus intervallet, flyttet ind i tidsvinduet; den første er ét interval efter, at arbejdsgangen er indlæst. Timere overlever genstarter. En udløsning springes over, mens den forrige kørsel stadig er i gang, og et ugyldigt interval udløses aldrig.

event

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

sources angiver hændelsesnavne, der skal matches præcist eller med et afsluttende .*-jokertegn. En tom liste er en fejl, der afviser hele agent.json. Kørslen modtager _event_source, _event_payload og _event_origin. Se Hændelser for, hvordan navne dannes.

watch

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

En watch holder en pluginproces kørende og starter en kørsel for hver linje, den skriver. Hver linje kommer frem som _watch_payload. Identiske linjer inden for ti minutter kasseres.

FeltStandardBetydning
pluginpåkrævetEn kapabilitet, f.eks. mail, eller en plugin-slug. Nævn en kapabilitet, når der findes en passende.
eventingenEn hændelse fra pluginets events-liste. Nebo bruger den hændelses kommando og udsender også hver linje som <plugin>.<event>.
commandingenArgumenter, der starter overvågeren. Bruges, når de er angivet; ellers hentes de fra event.
restart_delay_secs5Ventetid før genstart af en overvåger, der afslutter.

En kapabilitet peger på det installerede plugin, der leverer den, og foretrækker et, som denne medarbejder har en konto på. Uden et sådant plugin markeres arbejdsgangen som nedsat, og ejeren får at vide, hvad der skal tilsluttes. En overvåger, der bliver ved med at gå ned, genstarter med en forsinkelse, der fordobles op til 300 sekunder og nulstilles efter 30 sekunders oppetid.

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

{{key}} i command udfyldes med ejerens svar på medarbejderens inputs. Hvis en pladsholder ikke har noget svar, starter overvågningen ikke.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
FeltStandardBetydning
pathpåkrævetAbsolut mappesti. {{key}} udfyldes fra input.
extensionsalle filerFiltypenavne, der skal matches, uden punktum.
recursivetrueMedtag undermapper.
debounce_secs2Ændringer inden for dette tidsvindue bliver til én kørsel.

Kørslen modtager de ændrede stier i _watch_payload.files.

manual

{ "type": "manual" }

En manuel arbejdsgang kører kun, når ejeren kører den, eller en medarbejder kalder run_workflow. Alle arbejdsgange kan, uanset udløser, også køres på denne måde.

call

{"type": "call", "line": "..."} er kun gyldig i et workflow af typen "type": "call_tree", som konfigurerer, hvordan en medarbejder besvarer en telefonlinje. En tom line gælder for alle linjer, medarbejderen besvarer, som ikke har et mere specifikt træ. Et opkaldstræ skal have præcis én hilsen og mindst én navngivet hensigt.

Webhooks

Ejeren kan også oprette en webhook til en medarbejder. En webhook, der er knyttet til en arbejdsgang, kører den arbejdsgang; en uden arbejdsgang leverer sit indhold til medarbejderens chat.