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 | Por omissão | Significado |
|---|---|---|
id | obrigatório | Único dentro do fluxo de trabalho. Usado em connections e nos caminhos de dados. |
type | custom | Um passo do funcionário, ou um de condition, loop, wait, http, command, decide. |
intent | nenhum | O que o funcionário deve conseguir. Um passo do funcionário precisa de intent ou de steps. |
steps | [] | Instruções ordenadas, quando uma frase não chega. |
label | nenhum | Nome apresentado ao proprietário. |
skills | [] | Skills a usar. As skills da loja indicadas aqui são instaladas com o funcionário. |
tools | [] | Quando definidas, as únicas ferramentas que o passo pode usar. |
requires_tools | [] | Ferramentas que têm de ter êxito para o passo contar como concluído. |
cmds | [] | Comandos de plugins indicados para o passo. |
mcps | [] | Servidores MCP indicados para o passo. |
model | nenhum | Um id de modelo para este passo. |
params | nenhum | Parâmetros das atividades tipadas e maxIterations dos passos do funcionário. |
min_iterations | nenhum | Número mínimo de turnos do modelo antes de o passo poder terminar. |
token_budget | nenhum | {max}. Uma estimativa. |
on_error | {retry: 1, fallback: notify_owner} | Novas tentativas e depois o recurso alternativo. Qualquer falha depois das novas tentativas termina a execução. |
Passos do funcionário
Um passo do funcionário corre como um turno do funcionário: aplicam-se a sua persona, memória e ligações, e pode usar até 50 turnos do modelo, ou params.maxIterations. Os resultados dos passos anteriores são passados em blocos [Activity 'id' result]. O passo que termina um fluxo de trabalho com uma lista emit recebe a indicação de chamar emit_event com esses eventos. A ferramenta exit está sempre disponível para terminar a execução.
O contexto de dados
As atividades tipadas leem valores por caminho com pontos a partir de um único 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 ciclo. 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 ligações de saída têm as etiquetas True e False. params.mode escolhe como é lida:
| Modo | Expressão |
|---|---|
expression | O valor por omissão. path op value com ==, !=, >=, <=, > ou <, comparados como números quando ambos os lados são números; ou um caminho simples, verdadeiro quando o seu valor é verdadeiro. |
exists | Um caminho; verdadeiro quando resolve para 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 ligação com a etiqueta Each item leva ao corpo, que corre uma vez por item com item definido; a ligação com a etiqueta Done corre depois de todos os itens. As iterações começam em simultâneo, a menos que defina concurrency. maxIterations e batchSize também são aceites.
"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 | Faz uma pausa durante um intervalo em s, m ou h. Não existe esperar até; para retomar com um evento, acione um segundo fluxo de trabalho com esse evento. |
http | params.url | Faz o pedido. method, headers e body são opcionais. |
command | params.command | Executa um comando de shell. O seu stdout é a saída da atividade. |
decide
Uma atividade decide faz perguntas tipadas sobre o trabalho feito até ao momento e regista respostas estruturadas que uma condição pode usar para encaminhar.
{
"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 se verificar. |
Encaminhe com base numa resposta através de uma condição, como nodes.triage.urgency.score >= 1.5. params.default dá a resposta segura para cada pergunta quando não é possível decidir; uma resposta por omissão tem confiança 0. Uma pergunta sem valor por omissão não recebe resposta, por isso as condições sobre ela seguem a aresta False.
Erros
on_error.retry define quantas vezes uma atividade que falhou é tentada de novo; por omissão, 1. Depois da última tentativa, a execução termina e, com o fallback por omissã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.