NeboAI
NeboAI
Aan de slag

Triggers

Een trigger bepaalt wanneer een workflow draait. Nebo heeft zeven triggertypen. Elk is een object met een veld type en de velden voor dat type.

TypeDraait wanneer
scheduleEen cron-expressie komt overeen.
heartbeatEr verstrijkt een interval, eventueel binnen een dagelijks tijdvenster.
eventEr wordt een event met een overeenkomende bron afgegeven.
watchEen pluginwatcher schrijft een regel uitvoer.
folderBestanden in een map veranderen.
manualDe eigenaar of een medewerker voert hem uit.
callEen telefoonlijn gaat over. Alleen in belbomen.

schedule

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

cron is een cron-expressie met vijf velden: minuut, uur, dag van de maand, maand, dag van de week. schedule is een optionele beschrijving voor mensen. Schema's draaien in de lokale tijdzone van de bot. Nebo controleert schema's elke vijf seconden. Een moment dat werd gemist terwijl de bot uit stond, wordt één keer ingehaald als het minder dan een uur te laat is. Een moment wordt overgeslagen zolang de vorige uitvoering nog loopt.

heartbeat

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

interval is een tijdsduur zoals 30m, 1h of 2h30m. window, HH:MM-HH:MM, houdt de momenten binnen werktijd. Het volgende moment is het laatste moment plus het interval, verschoven naar het tijdvenster; het eerste is één interval nadat de workflow is geladen. Timers overleven herstarts. Een moment wordt overgeslagen zolang de vorige uitvoering nog loopt, en een ongeldig interval gaat nooit af.

event

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

sources noemt eventnamen die exact moeten overeenkomen, of met een afsluitend jokerteken .*. Een lege lijst is een fout waardoor de hele agent.json wordt geweigerd. De uitvoering ontvangt _event_source, _event_payload en _event_origin. Zie Events voor hoe namen worden gevormd.

watch

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

Een watch houdt een pluginproces draaiende en start een uitvoering voor elke regel die het schrijft. Elke regel komt binnen als _watch_payload. Identieke regels binnen tien minuten worden genegeerd.

VeldStandaardBetekenis
pluginverplichtEen capability, zoals mail, of een pluginslug. Noem een capability wanneer er een past.
eventgeenEen event uit de events-lijst van de plugin. Nebo gebruikt de opdracht van dat event en geeft ook elke regel af als <plugin>.<event>.
commandgeenArgumenten die de watcher starten. Gebruikt als ze zijn ingesteld; anders overgenomen van event.
restart_delay_secs5Wachttijd voordat een watcher die stopt opnieuw wordt gestart.

Een capability verwijst naar de geïnstalleerde plugin die hem levert, bij voorkeur een waarop deze medewerker een account heeft. Is er zo'n plugin niet, dan wordt de workflow gemarkeerd als beperkt en hoort de eigenaar wat hij moet verbinden. Een watcher die blijft crashen, start opnieuw met een vertraging die verdubbelt tot 300 seconden en wordt teruggezet na 30 seconden zonder onderbreking.

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

{{key}} in command wordt ingevuld met de antwoorden van de eigenaar op de invoervragen van de medewerker. Heeft een placeholder geen antwoord, dan start de watch niet.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
VeldStandaardBetekenis
pathverplichtAbsoluut mappad. {{key}} wordt ingevuld vanuit de invoer.
extensionsalle bestandenBestandsextensies om op te filteren, zonder de punt.
recursivetrueSubmappen meenemen.
debounce_secs2Wijzigingen binnen dit tijdvenster worden één uitvoering.

De uitvoering ontvangt de gewijzigde paden in _watch_payload.files.

manual

{ "type": "manual" }

Een handmatige workflow draait alleen als de eigenaar hem uitvoert of een medewerker run_workflow aanroept. Elke workflow kan, ongeacht de trigger, ook op deze manier worden uitgevoerd.

call

{"type": "call", "line": "..."} is alleen geldig in een workflow van "type": "call_tree", die bepaalt hoe een medewerker een telefoonlijn beantwoordt. Een lege line geldt voor elke lijn die de medewerker beantwoordt en waarvoor geen specifiekere boom bestaat. Een belboom moet precies één begroeting en minstens één benoemde intentie hebben.

Webhooks

De eigenaar kan ook een webhook voor een medewerker aanmaken. Een webhook die aan een workflow is gekoppeld, voert die workflow uit; een webhook zonder workflow levert zijn payload af in de chat van de medewerker.