| Tipo | Roda quando |
|---|---|
schedule | Uma expressão cron corresponde. |
heartbeat | Um intervalo passa, opcionalmente dentro de uma janela diária. |
event | Um evento com uma fonte correspondente é emitido. |
watch | Um observador de plugin escreve uma linha de saída. |
folder | Arquivos mudam em uma pasta. |
manual | O proprietário ou um funcionário o executa. |
call | Uma linha telefônica toca. Só em árvores de atendimento telefônico. |
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 rodam 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 estiver menos de uma hora atrasado. Um disparo é pulado enquanto a execução anterior ainda está em andamento.
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 acontece um intervalo depois que o fluxo de trabalho é carregado. Os timers sobrevivem a reinicializações. Um disparo é pulado enquanto a execução anterior ainda está em andamento, e um intervalo inválido nunca dispara.
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources lista nomes de eventos para corresponder exatamente ou com um curinga .* no final. Uma lista vazia é um erro que rejeita o agent.json inteiro. A execução recebe _event_source, _event_payload e _event_origin. Veja em Eventos como os nomes são formados.
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } Um watch mantém um processo de plugin rodando e inicia uma execução para cada linha que ele escreve. Cada linha chega como _watch_payload. Linhas idênticas dentro de dez minutos são descartadas.
| Campo | Padrã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, vêm de event. |
restart_delay_secs | 5 | Espera antes de reiniciar um observador que encerra. |
Uma capacidade é resolvida para o plugin instalado que a oferece, dando preferência a um em que este funcionário tenha uma conta. Se não houver um plugin assim, o fluxo de trabalho é marcado como degradado e o proprietário fica sabendo o que conectar. Um observador que continua falhando é reiniciado com um atraso que dobra até 300 segundos e é zerado depois de 30 segundos em funcionamento.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} em command é preenchido com as respostas do dono às entradas do funcionário. Se um marcador não tiver resposta, o monitoramento não começa.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | Campo | Padrão | Significado |
|---|---|---|
path | obrigatório | Caminho absoluto da pasta. {{key}} é preenchido com as entradas. |
extensions | todos os arquivos | Extensões de arquivo a corresponder, sem o ponto. |
recursive | true | Incluir subpastas. |
debounce_secs | 2 | As mudanças dentro desta janela viram uma única execução. |
A execução recebe os caminhos alterados em _watch_payload.files.
manual
{ "type": "manual" } Um fluxo de trabalho manual só roda quando o proprietário o executa ou quando um funcionário chama run_workflow. Todo fluxo de trabalho, qualquer que seja o gatilho, também pode ser executado dessa forma.
call
{"type": "call", "line": "..."} só é válido em um fluxo de trabalho de "type": "call_tree", que configura como um funcionário atende uma linha telefônica. Uma line vazia vale para toda linha que o funcionário atende e que não tem uma árvore mais específica. Uma árvore de chamadas precisa ter exatamente uma saudação e pelo menos uma intenção nomeada.
Webhooks
O proprietário também pode criar um webhook para um funcionário. Um webhook ligado a um fluxo de trabalho executa esse fluxo; um sem fluxo de trabalho entrega o payload no chat do funcionário.