NeboAI
NeboAI
Começar

Fluxos de trabalho

Um fluxo de trabalho é um trabalho que um funcionário faz sem que ninguém peça: um resumo pela manhã, uma resposta a cada nova mensagem, um relatório semanal. Cada fluxo de trabalho combina um gatilho com as atividades que o funcionário realiza. Os fluxos de trabalho ficam no agent.json do funcionário, então acompanham a função.

Um primeiro fluxo de trabalho

Adicione um mapa workflows ao agent.json. Cada chave dá nome a um fluxo de trabalho; cada valor tem um gatilho e atividades.

{
  "workflows": {
    "morning-summary": {
      "trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
      "description": "Summarize yesterday's open conversations every weekday morning.",
      "activities": [
        { "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
      ]
    }
  }
}

Este fluxo de trabalho roda às 08:00 nos dias úteis, no horário local do bot. O funcionário realiza a atividade com a própria persona, as próprias skills e as próprias conexões.

Campos do fluxo de trabalho

CampoSignificado
triggerObrigatório. Quando o fluxo de trabalho roda. Veja Gatilhos.
descriptionPara que serve o fluxo de trabalho.
activitiesAs etapas. Veja Atividades.
connectionsArestas {from, to, label} que transformam as atividades em um grafo. __trigger__ é o início e __emit__, o fim.
emitEventos que este fluxo de trabalho anuncia ao terminar: uma lista ou uma única string separada por vírgulas. Veja Eventos.
inputsValores passados para toda execução.
budget{total_per_run, cost_estimate}. Em uma execução em grafo, total_per_run limita os tokens de saída; nos outros casos, ambos são estimativas.
caseTransforma o fluxo de trabalho em um caso de longa duração por pessoa ou coisa. Veja Casos.

Um fluxo de trabalho com um gatilho e sem atividades é válido. Um watch sem atividades apenas repassa os eventos dele para outros fluxos de trabalho.

Como uma execução acontece

Sem connections, as atividades rodam em ordem e o funcionário realiza cada uma. O resultado de cada atividade é passado para a próxima. Uma atividade sem saída encerra a execução.

Com connections, as atividades formam um grafo. Os ramos rodam em paralelo, e seis tipos de atividade rodam sem o modelo: condition, loop, wait, http, command e decide. Use um grafo quando o roteamento precisar ser exato.

{
  "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
  "activities": [
    { "id": "classify", "type": "decide",
      "params": {
        "questions": {
          "kind": {
            "type": "choice",
            "instructions": "What kind of message is this?",
            "criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
          }
        },
        "default": { "kind": "other" }
      } },
    { "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
    { "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
  ],
  "connections": [
    { "from": "__trigger__", "to": "classify" },
    { "from": "classify", "to": "is-invoice" },
    { "from": "is-invoice", "to": "record", "label": "True" },
    { "from": "record", "to": "__emit__" }
  ],
  "emit": ["invoice.recorded"]
}

O que uma execução recebe

O funcionário sempre tem a própria persona e as respostas do proprietário às perguntas de inputs dele. Uma execução também recebe estes valores, dependendo do gatilho.

EntradaPresente quando
_event_source, _event_payload, _event_originUm gatilho event disparou. Payloads de 8 KB ou mais são encurtados para os campos escalares, mantendo os cabeçalhos de e-mail e as referências a anexos.
_watch_payloadUm gatilho watch ou folder disparou. Uma linha da saída do observador, ou {files} para uma pasta.
inputsSempre. Os valores de inputs do próprio fluxo de trabalho.

Casos

Alguns trabalhos se estendem por dias: um lead que precisa de acompanhamento, um pedido aguardando documentos. Adicione case e o fluxo de trabalho mantém um caso aberto por pessoa ou coisa, em vez de começar do zero a cada vez.

CampoSignificado
keyObrigatório. Caminhos com pontos, separados por vírgulas, nos dados do gatilho que identificam o assunto, como contactEmail,email,phone.
typeO tipo de caso, como lead. Fluxos de trabalho com o mesmo tipo compartilham casos. O padrão é o nome do fluxo de trabalho.
default_waitQuanto esperar quando um turno não informa uma espera: 3d, 12h, 45m. Padrão de três dias.

Cada turno de um caso precisa terminar com um objeto JSON e nada depois dele. result é o estado do negócio; next diz ao motor para wait ou close. Um prazo é RFC 3339 ou um intervalo relativo. Qualquer outra coisa é um turno inválido.

{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
 "next":   {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}}

Limites e recuperação

  • Cada atividade pode usar até 50 turnos do modelo, a menos que params.maxIterations diga outra coisa.
  • Em um grafo, uma atividade pode rodar no máximo 10.000 vezes por execução.
  • O limite de gastos que o proprietário definiu para o funcionário interrompe uma execução quando é atingido. O token_budget de uma atividade é uma estimativa.
  • Uma execução interrompida por uma reinicialização é marcada como interrompida e retomada uma vez.
  • O funcionário pode encerrar uma execução antes com a ferramenta exit.

Executar e gerenciar fluxos de trabalho

O proprietário pode executar qualquer fluxo de trabalho manualmente. Os funcionários gerenciam fluxos de trabalho com run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled e as outras ferramentas de fluxo de trabalho listadas em Ajudantes e equipes.