NeboAI
NeboAI
Empezar

Disparadores

Un disparador decide cuándo se ejecuta un flujo de trabajo. Nebo tiene siete tipos de disparador. Cada uno es un objeto con un campo de tipo y los campos propios de ese tipo.

TipoSe ejecuta cuando
scheduleCoincide una expresión cron.
heartbeatPasa un intervalo, opcionalmente dentro de una franja diaria.
eventSe emite un evento con una fuente que coincide.
watchUn observador de un plugin escribe una línea de salida.
folderCambian archivos en una carpeta.
manualEl propietario o un empleado lo ejecuta.
callSuena 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.

CampoPor defectoSignificado
pluginobligatorioUna capacidad, como mail, o el slug de un plugin. Indica una capacidad siempre que haya una adecuada.
eventningunoUn evento de la lista events del plugin. Nebo usa el comando de ese evento y además emite cada línea como <plugin>.<event>.
commandningunoArgumentos que inician el observador. Se usan si están definidos; si no, se toman de event.
restart_delay_secs5Espera 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 }
CampoPor defectoSignificado
pathobligatorioRuta absoluta de la carpeta. {{key}} se rellena con las entradas.
extensionstodos los archivosExtensiones de archivo que deben coincidir, sin el punto.
recursivetrueIncluir subcarpetas.
debounce_secs2Los 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.