| Tipo | Corre quando |
|---|---|
schedule | Uma expressão cron corresponde. |
heartbeat | Passa um intervalo, opcionalmente dentro de uma janela diária. |
event | É emitido um evento com uma fonte correspondente. |
watch | Um observador de plugin escreve uma linha de saída. |
folder | Ficheiros mudam numa pasta. |
manual | O proprietário ou um funcionário o executa. |
call | Uma linha telefónica toca. Só em árvores de chamadas telefónicas. |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron é uma expressão cron de cinco campos: minuto, hora, dia do mês, mês, dia da semana. schedule é uma descrição opcional para pessoas. Os agendamentos correm no fuso horário local do bot. O Nebo verifica os agendamentos a cada cinco segundos. Um disparo perdido enquanto o bot estava desligado é recuperado uma vez se tiver menos de uma hora de atraso. Um disparo é ignorado enquanto a execução anterior ainda está a decorrer.
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval é um intervalo como 30m, 1h ou 2h30m. window, HH:MM-HH:MM, mantém os disparos dentro do horário de trabalho. O próximo disparo é o último disparo mais o intervalo, ajustado para dentro da janela; o primeiro ocorre um intervalo depois de o fluxo de trabalho ser carregado. Os temporizadores sobrevivem a reinícios. Um disparo é ignorado enquanto a execução anterior ainda está a decorrer, e um intervalo inválido nunca dispara.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources lista os nomes de eventos a corresponder exatamente, ou com um caráter universal .* no fim. Uma lista vazia é um erro que rejeita o agent.json inteiro. A execução recebe _event_source, _event_payload e _event_origin. Consulte Eventos para saber como se formam os nomes.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Um watch mantém um processo de plugin em execução e inicia uma execução por cada linha que ele escreve. Cada linha chega como _watch_payload. As linhas idênticas num intervalo de dez minutos são descartadas.
| Campo | Por omissão | Significado |
|---|---|---|
plugin | obrigatório | Uma capacidade, como mail, ou o slug de um plugin. Indique uma capacidade sempre que houver uma adequada. |
event | nenhum | Um evento da lista events do plugin. O Nebo usa o comando desse evento e também emite cada linha como <plugin>.<event>. |
command | nenhum | Argumentos que iniciam o observador. Usados quando definidos; caso contrário, obtidos de event. |
restart_delay_secs | 5 | Espera antes de reiniciar um observador que termina. |
Uma capacidade resolve para o plugin instalado que a fornece, dando preferência a um em que este funcionário tenha conta. Sem um plugin assim, o fluxo de trabalho fica marcado como degradado e o proprietário é informado do que deve ligar. Um observador que continua a falhar reinicia com um atraso que duplica até 300 segundos e é reposto após 30 segundos de funcionamento.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} em command é preenchido com as respostas do proprietário aos inputs do funcionário. Se um marcador não tiver resposta, a vigilância não arranca.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Campo | Por omissão | Significado |
|---|---|---|
path | obrigatório | Caminho absoluto da pasta. {{key}} é preenchido a partir das entradas. |
extensions | todos os ficheiros | Extensões de ficheiro a corresponder, sem o ponto. |
recursive | true | Incluir subpastas. |
debounce_secs | 2 | As alterações dentro desta janela tornam-se uma única execução. |
A execução recebe os caminhos alterados em _watch_payload.files.
manual
{ "type": "manual" } Um fluxo de trabalho manual só corre quando o proprietário o executa ou quando um funcionário chama run_workflow. Qualquer fluxo de trabalho, seja qual for o acionador, também pode ser executado desta forma.
call
{"type": "call", "line": "..."} só é válido num workflow de "type": "call_tree", que configura como um funcionário atende uma linha telefónica. Um line vazio aplica-se a todas as linhas que o funcionário atende que não tenham uma árvore mais específica. Uma árvore de chamadas tem de ter exatamente uma saudação e pelo menos uma intenção com nome.
Webhooks
O proprietário também pode criar um webhook para um funcionário. Um webhook associado a um fluxo de trabalho executa esse fluxo de trabalho; um sem fluxo de trabalho entrega o seu payload no chat do funcionário.