NeboAI
NeboAI
Inizia

Attivatori

Un trigger decide quando viene eseguito un flusso di lavoro. Nebo ha sette tipi di trigger. Ognuno è un oggetto con un campo type e i campi propri di quel tipo.

TipoViene eseguito quando
scheduleUn'espressione cron corrisponde.
heartbeatTrascorre un intervallo, facoltativamente all'interno di una fascia giornaliera.
eventViene emesso un evento con una fonte corrispondente.
watchUn osservatore di un plugin scrive una riga di output.
folderCambiano dei file in una cartella.
manualIl proprietario o un dipendente lo esegue.
callSquilla una linea telefonica. Solo negli alberi di chiamata telefonica.

schedule

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

cron è un'espressione cron a cinque campi: minuto, ora, giorno del mese, mese, giorno della settimana. schedule è una descrizione facoltativa per le persone. Le pianificazioni seguono il fuso orario locale del bot. Nebo controlla le pianificazioni ogni cinque secondi. Un'attivazione persa mentre il bot era spento viene recuperata una volta se il ritardo è inferiore a un'ora. Un'attivazione viene saltata mentre l'esecuzione precedente è ancora in corso.

heartbeat

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

interval è un intervallo come 30m, 1h o 2h30m. window, HH:MM-HH:MM, mantiene le attivazioni entro l'orario di lavoro. L'attivazione successiva è l'ultima attivazione più l'intervallo, spostata dentro la fascia; la prima avviene un intervallo dopo il caricamento del flusso di lavoro. I timer sopravvivono ai riavvii. Un'attivazione viene saltata mentre l'esecuzione precedente è ancora in corso, e un intervallo non valido non si attiva mai.

event

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

sources elenca i nomi degli eventi da far corrispondere esattamente, oppure con un carattere jolly .* finale. Un elenco vuoto è un errore che fa rifiutare l'intero agent.json. L'esecuzione riceve _event_source, _event_payload e _event_origin. Vedi Eventi per come si formano i nomi.

watch

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

Un watch mantiene in esecuzione un processo del plugin e avvia un'esecuzione per ogni riga che scrive. Ogni riga arriva come _watch_payload. Le righe identiche entro dieci minuti vengono scartate.

CampoPredefinitoSignificato
pluginobbligatorioUna capacità, come mail, oppure lo slug di un plugin. Indica una capacità ogni volta che ce n'è una adatta.
eventnessunoUn evento dall'elenco events del plugin. Nebo usa il comando di quell'evento ed emette anche ogni riga come <plugin>.<event>.
commandnessunoArgomenti che avviano l'osservatore. Usati se impostati; altrimenti presi da event.
restart_delay_secs5Attesa prima di riavviare un osservatore che termina.

Una capacità si risolve nel plugin installato che la fornisce, preferendo uno su cui questo dipendente ha un account. Se non c'è un plugin del genere, il flusso di lavoro viene contrassegnato come ridotto e al proprietario viene detto cosa collegare. Un osservatore che continua ad arrestarsi si riavvia con un ritardo che raddoppia fino a 300 secondi e si azzera dopo 30 secondi di funzionamento.

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

{{key}} in command viene riempito con le risposte del proprietario agli input del dipendente. Se un segnaposto non ha risposta, il monitoraggio non parte.

folder

{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false }
CampoPredefinitoSignificato
pathobbligatorioPercorso assoluto della cartella. {{key}} viene compilato dagli input.
extensionstutti i fileEstensioni dei file da far corrispondere, senza il punto.
recursivetrueIncludi le sottocartelle.
debounce_secs2Le modifiche entro questa finestra diventano un'unica esecuzione.

L'esecuzione riceve i percorsi modificati in _watch_payload.files.

manual

{ "type": "manual" }

Un flusso di lavoro manuale viene eseguito solo quando il proprietario lo esegue o un dipendente chiama run_workflow. Ogni flusso di lavoro, qualunque sia il suo trigger, può essere eseguito anche in questo modo.

call

{"type": "call", "line": "..."} è valido solo in un workflow di tipo "type": "call_tree", che configura come un dipendente risponde a una linea telefonica. Una line vuota si applica a ogni linea a cui il dipendente risponde e che non ha un albero più specifico. Un albero di chiamata deve avere esattamente un saluto e almeno un intento con nome.

Webhook

Il proprietario può anche creare un webhook per un dipendente. Un webhook legato a un flusso di lavoro esegue quel flusso di lavoro; uno senza flusso di lavoro consegna il suo payload alla chat del dipendente.