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" }
} | Campo | Padrão | Significado |
|---|---|---|
id | obrigatório | Único dentro do fluxo de trabalho. Usado em connections e nos caminhos de dados. |
type | custom | Uma etapa do funcionário ou um destes: condition, loop, wait, http, command, decide. |
intent | nenhum | O 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. |
label | nenhum | Nome 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. |
model | nenhum | Um id de modelo para esta etapa. |
params | nenhum | Parâmetros das atividades tipadas e maxIterations para as etapas do funcionário. |
min_iterations | nenhum | Mínimo de turnos do modelo antes que a etapa possa terminar. |
token_budget | nenhum | {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:
| Modo | Expressão |
|---|---|
expression | O 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. |
exists | Um caminho; verdadeiro quando resulta em um valor verdadeiro. |
contains | path contains text, ou texto simples comparado com a saída anterior. |
regex | Um 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" } } | Tipo | Obrigatório | Comportamento |
|---|---|---|
wait | params.duration | Pausa 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. |
http | params.url | Faz a requisição. method, headers e body são opcionais. |
command | params.command | Executa 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 pergunta | criteria | Resposta |
|---|---|---|
choice | Objeto de opção para descrição, de 2 a 255 opções. | choice, confidence e probabilities. |
score | Lista de 2 a 10 níveis ordenados. | score a partir de 0 (primeiro nível), para cima, e confidence. |
noul | Nenhum. | 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.