| Tipo | Se ejecuta cuando |
|---|---|
schedule | Coincide una expresión cron. |
heartbeat | Pasa un intervalo, opcionalmente dentro de una franja diaria. |
event | Se emite un evento con una fuente que coincide. |
watch | Un observador de un plugin escribe una línea de salida. |
folder | Cambian archivos en una carpeta. |
manual | El propietario o un empleado lo ejecuta. |
call | Suena una línea de teléfono. Solo en árboles de llamadas telefónicas. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron es una expresión cron de cinco campos: minuto, hora, día del mes, mes, día de la semana. schedule es una descripción opcional para las personas. Las programaciones se ejecutan en la zona horaria local del bot. Nebo comprueba las programaciones cada cinco segundos. Una activación perdida mientras el bot estaba apagado se recupera una vez si lleva menos de una hora de retraso. Una activación se omite mientras la ejecución anterior sigue en curso.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval es un intervalo como 30m, 1h o 2h30m. window, HH:MM-HH:MM, mantiene las activaciones dentro del horario laboral. La siguiente activación es la última más el intervalo, desplazada dentro de la franja; la primera es un intervalo después de que se cargue el flujo de trabajo. Los temporizadores se mantienen tras los reinicios. Una activación se omite mientras la ejecución anterior sigue en curso, y un intervalo no válido nunca se activa.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources enumera los nombres de eventos que deben coincidir exactamente o con un comodín .* final. Una lista vacía es un error que invalida todo el agent.json. La ejecución recibe _event_source, _event_payload y _event_origin. Consulta Eventos para ver cómo se forman los nombres.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Un watch mantiene un proceso del plugin en ejecución e inicia una ejecución por cada línea que escribe. Cada línea llega como _watch_payload. Las líneas idénticas en un plazo de diez minutos se descartan.
| Campo | Por defecto | Significado |
|---|---|---|
plugin | obligatorio | Una capacidad, como mail, o el slug de un plugin. Indica una capacidad siempre que haya una adecuada. |
event | ninguno | Un evento de la lista events del plugin. Nebo usa el comando de ese evento y además emite cada línea como <plugin>.<event>. |
command | ninguno | Argumentos que inician el observador. Se usan si están definidos; si no, se toman de event. |
restart_delay_secs | 5 | Espera antes de reiniciar un observador que termina. |
Una capacidad se resuelve en el plugin instalado que la ofrece, con preferencia por uno en el que este empleado tenga cuenta. Si no hay ningún plugin así, el flujo de trabajo se marca como degradado y se le dice al propietario qué conectar. Un observador que falla una y otra vez se reinicia con una espera que se duplica hasta 300 segundos y se restablece tras 30 segundos en funcionamiento.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} en command se rellena con las respuestas del propietario a las entradas del empleado. Si un marcador no tiene respuesta, la vigilancia no se inicia.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Campo | Por defecto | Significado |
|---|---|---|
path | obligatorio | Ruta absoluta de la carpeta. {{key}} se rellena con las entradas. |
extensions | todos los archivos | Extensiones de archivo que deben coincidir, sin el punto. |
recursive | true | Incluir subcarpetas. |
debounce_secs | 2 | Los cambios dentro de esta franja se agrupan en una sola ejecución. |
La ejecución recibe las rutas modificadas en _watch_payload.files.
manual
{ "type": "manual" } Un flujo de trabajo manual solo se ejecuta cuando lo ejecuta el propietario o cuando un empleado llama a run_workflow. Cualquier flujo de trabajo, sea cual sea su disparador, también puede ejecutarse así.
call
{"type": "call", "line": "..."} solo es válido en un flujo de trabajo de "type": "call_tree", que configura cómo responde un empleado a una línea telefónica. Un line vacío se aplica a todas las líneas que atiende el empleado y que no tienen un árbol más específico. Un árbol de llamadas debe tener exactamente un saludo y al menos una intención con nombre.
Webhooks
El propietario también puede crear un webhook para un empleado. Un webhook vinculado a un flujo de trabajo ejecuta ese flujo; uno sin flujo de trabajo entrega su carga útil en el chat del empleado.