NeboAI
NeboAI
Começar

Gatilhos

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

TipoRoda quando
scheduleUma expressão cron corresponde.
heartbeatUm intervalo passa, opcionalmente dentro de uma janela diária.
eventUm evento com uma fonte correspondente é emitido.
watchUm observador de plugin escreve uma linha de saída.
folderArquivos mudam em uma pasta.
manualO proprietário ou um funcionário o executa.
callUma 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.

CampoPadrã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, vêm de event.
restart_delay_secs5Espera 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 }
CampoPadrãoSignificado
pathobrigatórioCaminho absoluto da pasta. {{key}} é preenchido com as entradas.
extensionstodos os arquivosExtensões de arquivo a corresponder, sem o ponto.
recursivetrueIncluir subpastas.
debounce_secs2As 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.