NeboAI
NeboAI
Começar

Fluxos de trabalho

Um fluxo de trabalho é trabalho que um funcionário faz sem que lho peçam: um resumo matinal, uma resposta a cada nova mensagem, um relatório semanal. Cada fluxo de trabalho junta um acionador às atividades que o funcionário realiza. Os fluxos de trabalho ficam no agent.json do funcionário, por isso acompanham a função.

Um primeiro fluxo de trabalho

Acrescente um mapa workflows ao agent.json. Cada chave dá nome a um fluxo de trabalho; cada valor tem um acionador 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 corre às 08:00 nos dias úteis, na hora local do bot. O funcionário realiza a atividade com a sua própria persona, skills e ligações.

Campos do fluxo de trabalho

CampoSignificado
triggerObrigatório. Quando o fluxo de trabalho corre. Consulte Acionadores.
descriptionPara que serve o fluxo de trabalho.
activitiesOs passos. Consulte Atividades.
connectionsArestas {from, to, label} que tornam as atividades um grafo. __trigger__ é o início e __emit__ o fim.
emitEventos que este fluxo de trabalho anuncia quando termina: uma lista ou uma cadeia de texto separada por vírgulas. Consulte Eventos.
inputsValores passados a todas as execuções.
budget{total_per_run, cost_estimate}. Numa execução em grafo, total_per_run limita os tokens de saída; caso contrário, ambos são estimativas.
caseFaz do fluxo de trabalho um caso de longa duração por pessoa ou coisa. Consulte Casos.

Um fluxo de trabalho com um acionador e sem atividades é válido. Um watch sem atividades apenas retransmite os seus eventos para outros fluxos de trabalho.

Como uma execução decorre

Sem connections, as atividades correm por ordem e o funcionário realiza cada uma. O resultado de cada atividade é passado à seguinte. Uma atividade sem saída termina a execução.

Com connections, as atividades formam um grafo. Os ramos correm em paralelo, e seis tipos de atividade correm sem o modelo: condition, loop, wait, http, command e decide. Use um grafo quando o encaminhamento tem de 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 tem sempre a sua persona e as respostas do proprietário às perguntas de inputs. Uma execução recebe também estes valores, consoante o acionador.

EntradaPresente quando
_event_source, _event_payload, _event_originDisparou um acionador de evento. Os payloads de 8 KB ou mais são reduzidos aos seus campos escalares, mantendo os cabeçalhos de email e as referências a anexos.
_watch_payloadDisparou um acionador watch ou folder. Uma linha da saída do observador, ou {files} no caso de uma pasta.
inputsSempre. Os valores de inputs do próprio fluxo de trabalho.

Casos

Há trabalho que se estende por dias: um contacto comercial que precisa de seguimento, um pedido à espera de documentos. Acrescente case e o fluxo de trabalho mantém um caso aberto por pessoa ou coisa, em vez de recomeçar do zero de cada vez.

CampoSignificado
keyObrigatório. Caminhos com pontos, separados por vírgulas, nos dados do acionador que identificam o sujeito, como contactEmail,email,phone.
typeO tipo de caso, como lead. Os fluxos de trabalho com o mesmo tipo partilham casos. Por omissão, o nome do fluxo de trabalho.
default_waitQuanto tempo esperar quando um turno não indica espera: 3d, 12h, 45m. Por omissão, três dias.

Cada turno de um caso tem de terminar com um objeto JSON e nada a seguir. result é o estado do negócio; next diz ao motor para fazer 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 indique outra coisa.
  • Num grafo, uma atividade pode correr 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 um reinício é marcada como interrompida e retomada uma vez.
  • O funcionário pode terminar uma execução mais cedo com a ferramenta exit.

Executar e gerir fluxos de trabalho

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