NeboAI
NeboAI
Kom i gang

Utløsere

En utløser bestemmer når en arbeidsflyt kjører. Nebo har sju typer utløsere. Hver er et objekt med et type-felt og feltene for den typen.

TypeKjører når
scheduleEt cron-uttrykk samsvarer.
heartbeatEt intervall går, eventuelt innenfor et daglig tidsvindu.
eventEn hendelse med samsvarende kilde sendes ut.
watchEn overvåker i et tillegg skriver en linje med utdata.
folderFiler endres i en mappe.
manualEieren eller en ansatt kjører den.
callEn telefonlinje ringer. Bare i telefonsamtaletrær.

schedule

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

cron er et cron-uttrykk med fem felt: minutt, time, dag i måneden, måned, ukedag. schedule er en valgfri beskrivelse for mennesker. Tidsplaner kjører i botens lokale tidssone. Nebo kontrollerer tidsplaner hvert femte sekund. En utløsning som ble gått glipp av mens boten var av, tas igjen én gang hvis den er mindre enn en time forsinket. En utløsning hoppes over mens den forrige kjøringen fortsatt pågår.

heartbeat

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

interval er et tidsrom som 30m, 1h eller 2h30m. window, HH:MM-HH:MM, holder utløsningene innenfor arbeidstiden. Neste utløsning er den forrige pluss intervallet, flyttet inn i vinduet; den første er ett intervall etter at arbeidsflyten er lastet. Tidtakere overlever omstarter. En utløsning hoppes over mens den forrige kjøringen fortsatt pågår, og et ugyldig intervall utløses aldri.

event

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

sources lister hendelsesnavn som skal samsvare eksakt, eller med jokertegnet .* til slutt. En tom liste er en feil som avviser hele agent.json. Kjøringen mottar _event_source, _event_payload og _event_origin. Se Hendelser for hvordan navn dannes.

watch

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

En overvåking holder en tilleggsprosess i gang og starter en kjøring for hver linje den skriver. Hver linje kommer som _watch_payload. Identiske linjer innen ti minutter forkastes.

FeltStandardBetydning
pluginobligatoriskEn funksjon, for eksempel mail, eller sluggen til et tillegg. Oppgi en funksjon når en passer.
eventingenEn hendelse fra tilleggets events-liste. Nebo bruker kommandoen til den hendelsen og sender også ut hver linje som <plugin>.<event>.
commandingenArgumenter som starter overvåkeren. Brukes når angitt; ellers hentet fra event.
restart_delay_secs5Ventetid før en overvåker som avslutter, startes på nytt.

En funksjon peker til det installerte tillegget som tilbyr den, fortrinnsvis et som denne ansatte har en konto på. Uten et slikt tillegg merkes arbeidsflyten som redusert, og eieren får beskjed om hva som må kobles til. En overvåker som stadig krasjer, startes på nytt med en forsinkelse som dobles opptil 300 sekunder og nullstilles etter 30 sekunders oppetid.

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

{{key}} i command fylles ut fra eierens svar på den ansattes inndata. Hvis en plassholder ikke har noe svar, starter ikke overvåkingen.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
FeltStandardBetydning
pathobligatoriskAbsolutt mappesti. {{key}} fylles ut fra inndataene.
extensionsalle filerFiltyper som skal samsvare, uten punktum.
recursivetrueTa med undermapper.
debounce_secs2Endringer innenfor dette vinduet blir én kjøring.

Kjøringen mottar de endrede stiene i _watch_payload.files.

manual

{ "type": "manual" }

En manuell arbeidsflyt kjører bare når eieren kjører den eller en ansatt kaller run_workflow. Alle arbeidsflyter, uansett utløser, kan også kjøres på denne måten.

call

{"type": "call", "line": "..."} er bare gyldig i en arbeidsflyt av typen "type": "call_tree", som konfigurerer hvordan en ansatt svarer på en telefonlinje. En tom line gjelder for alle linjer den ansatte svarer på som ikke har et mer spesifikt tre. Et samtaletre må ha nøyaktig én hilsen og minst én navngitt intensjon.

Webhooks

Eieren kan også opprette en webhook for en ansatt. En webhook som er knyttet til en arbeidsflyt, kjører den arbeidsflyten; en uten arbeidsflyt leverer nyttelasten til den ansattes chat.