NeboAI
NeboAI
Comenzar

Disparadores

Un disparador decide cuándo se ejecuta un flujo de trabajo. Nebo tiene siete tipos de disparadores. Cada uno es un objeto con un campo de tipo y los campos 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 plugin escribe una línea de salida.
folderCambian archivos en una carpeta.
manualEl dueño o un empleado lo ejecuta.
callSuena una línea telefónica. 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 revisa las programaciones cada cinco segundos. Una activación que se perdió 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 lapso 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, movida dentro de la franja; la primera ocurre un intervalo después de que se carga el flujo de trabajo. Los temporizadores se conservan 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 nombres de eventos que deben coincidir exactamente o con un comodín .* al final. Una lista vacía es un error que rechaza 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 dentro de diez minutos se descartan.

CampoPredeterminadoSignificado
pluginobligatorioUna capacidad, como mail, o el slug de un plugin. Nombra una capacidad siempre que haya una adecuada.
eventningunoUn evento de la lista events del plugin. Nebo usa el comando de ese evento y también emite cada línea como <plugin>.<event>.
commandningunoArgumentos que inician el observador. Se usan cuando están definidos; si no, se toman de event.
restart_delay_secs5Espera antes de reiniciar un observador que termina.

Una capacidad se resuelve al plugin instalado que la ofrece, con preferencia por uno en el que este empleado tenga una cuenta. Si no hay un plugin así, el flujo de trabajo se marca como degradado y se le indica al dueño qué conectar. Un observador que sigue fallando se reinicia con una demora que se duplica hasta 300 segundos y se restablece tras 30 segundos de funcionamiento.

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

{{key}} en command se completa con las respuestas del dueño a los datos de entrada del empleado. Si un marcador no tiene respuesta, la vigilancia no se inicia.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
CampoPredeterminadoSignificado
pathobligatorioRuta absoluta de la carpeta. {{key}} se completa con las entradas.
extensionstodos los archivosExtensiones de archivo que deben coincidir, sin el punto.
recursivetrueIncluir subcarpetas.
debounce_secs2Los cambios dentro de este lapso se convierten 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 el dueño lo ejecuta o un empleado llama a run_workflow. Cualquier flujo de trabajo, sea cual sea su disparador, también se puede ejecutar así.

call

{"type": "call", "line": "..."} solo es válido en un flujo de trabajo de "type": "call_tree", que configura cómo un empleado contesta una línea telefónica. Un line vacío se aplica a todas las líneas que contesta el empleado que no tengan 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 dueño también puede crear un webhook para un empleado. Un webhook vinculado a un flujo de trabajo ejecuta ese flujo de trabajo; uno sin flujo de trabajo entrega su carga al chat del empleado.