NeboAI
NeboAI
Começar

Atividades

Uma atividade é uma etapa de um fluxo de trabalho. A maioria das atividades é realizada pelo funcionário: você declara a intenção e ele faz o trabalho com as próprias skills e conexões. Seis tipos rodam sem o modelo, para que o roteamento e o tempo continuem exatos.

Campos

{
  "id": "draft-reply",
  "label": "Draft the reply",
  "intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
  "skills": ["reply-drafting"],
  "requires_tools": ["mail_message_send"],
  "on_error": { "retry": 1, "fallback": "notify_owner" }
}
CampoPadrãoSignificado
idobrigatórioÚnico dentro do fluxo de trabalho. Usado em connections e nos caminhos de dados.
typecustomUma etapa do funcionário ou um destes: condition, loop, wait, http, command, decide.
intentnenhumO que o funcionário deve realizar. Uma etapa do funcionário precisa de intent ou steps.
steps[]Instruções ordenadas, quando uma frase não basta.
labelnenhumNome exibido ao proprietário.
skills[]Skills a usar. As skills da loja listadas aqui são instaladas junto com o funcionário.
tools[]Quando definido, as únicas ferramentas que a etapa pode usar.
requires_tools[]Ferramentas que precisam ter sucesso para que a etapa conte como concluída.
cmds[]Comandos de plugin indicados para a etapa.
mcps[]Servidores MCP indicados para a etapa.
modelnenhumUm id de modelo para esta etapa.
paramsnenhumParâmetros das atividades tipadas e maxIterations para as etapas do funcionário.
min_iterationsnenhumMínimo de turnos do modelo antes que a etapa possa terminar.
token_budgetnenhum{max}. Uma estimativa.
on_error{retry: 1, fallback: notify_owner}Novas tentativas e, depois, o plano alternativo. Qualquer falha depois das novas tentativas encerra a execução.

Etapas do funcionário

Uma etapa do funcionário roda como um turno do funcionário: a persona, a memória e as conexões dele se aplicam, e ela pode usar até 50 turnos do modelo, ou params.maxIterations. Os resultados das etapas anteriores são passados como blocos [Activity 'id' result]. A etapa que encerra um fluxo de trabalho com uma lista emit recebe a instrução de chamar emit_event com esses eventos. A ferramenta exit está sempre disponível para encerrar a execução.

O contexto de dados

As atividades tipadas leem valores por caminho com pontos a partir de um objeto: inputs contém as entradas da execução, nodes.<id> contém a saída de cada atividade concluída (interpretada como JSON quando é JSON) e item contém o item atual dentro de um loop. Um caminho simples procura em inputs e depois em nodes.

condition

{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } }

params.expression é obrigatório. As conexões de saída são rotuladas True e False. params.mode escolhe como ela é interpretada:

ModoExpressão
expressionO padrão. path op value com ==, !=, >=, <=, > ou <, comparados como números quando os dois lados são números; ou um caminho simples, verdadeiro quando o valor dele é verdadeiro.
existsUm caminho; verdadeiro quando resulta em um valor verdadeiro.
containspath contains text, ou texto simples comparado com a saída anterior.
regexUm padrão comparado com a saída anterior.

loop

{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } }

params.source é o caminho de uma lista. A conexão rotulada Each item leva ao corpo, que roda uma vez por item com item definido; a rotulada Done roda depois de todos os itens. As iterações começam juntas, a menos que você defina concurrency. maxIterations e batchSize também são aceitos.

"connections": [
  { "from": "__trigger__", "to": "fetch" },
  { "from": "fetch", "to": "each-invoice" },
  { "from": "each-invoice", "to": "check", "label": "Each item" },
  { "from": "each-invoice", "to": "report", "label": "Done" }
]

wait, http e command

{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } }
TipoObrigatórioComportamento
waitparams.durationPausa por um intervalo em s, m ou h. Não existe espera até um horário específico; para retomar quando um evento acontecer, dispare um segundo fluxo de trabalho com ele.
httpparams.urlFaz a requisição. method, headers e body são opcionais.
commandparams.commandExecuta um comando de shell. O stdout dele é a saída da atividade.

decide

Uma atividade decide faz perguntas tipadas sobre o trabalho até agora e registra respostas estruturadas que uma condition pode usar para rotear.

{
  "id": "triage",
  "type": "decide",
  "params": {
    "questions": {
      "urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
      "refund": { "type": "noul", "instructions": "The customer is asking for money back." }
    },
    "default": { "urgency": "normal", "refund": false }
  }
}
Tipo de perguntacriteriaResposta
choiceObjeto de opção para descrição, de 2 a 255 opções.choice, confidence e probabilities.
scoreLista de 2 a 10 níveis ordenados.score a partir de 0 (primeiro nível), para cima, e confidence.
noulNenhum.noul, a probabilidade de a afirmação ser verdadeira.

Roteie com base em uma resposta usando uma condition, como nodes.triage.urgency.score >= 1.5. params.default dá a resposta segura para cada pergunta quando nenhuma decisão pode ser tomada; uma resposta padrão tem confiança 0. Uma pergunta sem padrão fica sem resposta, então as condições sobre ela seguem a aresta False.

Erros

on_error.retry define quantas vezes uma atividade com falha é tentada de novo; o padrão é 1. Depois da última tentativa, a execução termina e, com o fallback padrão notify_owner, o proprietário é avisado. O Nebo verifica os parâmetros obrigatórios de cada atividade tipada quando a execução começa e rejeita um ramo que aponte para uma atividade desconhecida.