NeboAI
NeboAI
Começar

Acionadores

Um acionador decide quando um fluxo de trabalho corre. O Nebo tem sete tipos de acionador. Cada um é um objeto com um campo type e os campos desse tipo.

TipoCorre quando
scheduleUma expressão cron corresponde.
heartbeatPassa um intervalo, opcionalmente dentro de uma janela diária.
eventÉ emitido um evento com uma fonte correspondente.
watchUm observador de plugin escreve uma linha de saída.
folderFicheiros mudam numa pasta.
manualO proprietário ou um funcionário o executa.
callUma 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.

CampoPor omissãoSignificado
pluginobrigatórioUma capacidade, como mail, ou o slug de um plugin. Indique uma capacidade sempre que houver uma adequada.
eventnenhumUm evento da lista events do plugin. O Nebo usa o comando desse evento e também emite cada linha como <plugin>.<event>.
commandnenhumArgumentos que iniciam o observador. Usados quando definidos; caso contrário, obtidos de event.
restart_delay_secs5Espera 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 }
CampoPor omissãoSignificado
pathobrigatórioCaminho absoluto da pasta. {{key}} é preenchido a partir das entradas.
extensionstodos os ficheirosExtensões de ficheiro a corresponder, sem o ponto.
recursivetrueIncluir subpastas.
debounce_secs2As 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.