| Type | Draait wanneer |
|---|---|
schedule | Een cron-expressie komt overeen. |
heartbeat | Er verstrijkt een interval, eventueel binnen een dagelijks tijdvenster. |
event | Er wordt een event met een overeenkomende bron afgegeven. |
watch | Een pluginwatcher schrijft een regel uitvoer. |
folder | Bestanden in een map veranderen. |
manual | De eigenaar of een medewerker voert hem uit. |
call | Een 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.
| Veld | Standaard | Betekenis |
|---|---|---|
plugin | verplicht | Een capability, zoals mail, of een pluginslug. Noem een capability wanneer er een past. |
event | geen | Een event uit de events-lijst van de plugin. Nebo gebruikt de opdracht van dat event en geeft ook elke regel af als <plugin>.<event>. |
command | geen | Argumenten die de watcher starten. Gebruikt als ze zijn ingesteld; anders overgenomen van event. |
restart_delay_secs | 5 | Wachttijd 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 } | Veld | Standaard | Betekenis |
|---|---|---|
path | verplicht | Absoluut mappad. {{key}} wordt ingevuld vanuit de invoer. |
extensions | alle bestanden | Bestandsextensies om op te filteren, zonder de punt. |
recursive | true | Submappen meenemen. |
debounce_secs | 2 | Wijzigingen 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.