NeboAI
NeboAI
Começar

Atividades

Uma atividade é um passo de um fluxo de trabalho. A maioria das atividades é realizada pelo funcionário: indica a intenção e ele faz o trabalho com as suas skills e ligações. Seis tipos correm sem o modelo, para que o encaminhamento e os tempos se mantenham 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" }
}
CampoPor omissãoSignificado
idobrigatórioÚnico dentro do fluxo de trabalho. Usado em connections e nos caminhos de dados.
typecustomUm passo do funcionário, ou um de condition, loop, wait, http, command, decide.
intentnenhumO 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.
labelnenhumNome 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.
modelnenhumUm id de modelo para este passo.
paramsnenhumParâmetros das atividades tipadas e maxIterations dos passos do funcionário.
min_iterationsnenhumNúmero mínimo de turnos do modelo antes de o passo poder terminar.
token_budgetnenhum{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:

ModoExpressão
expressionO 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.
existsUm caminho; verdadeiro quando resolve para 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 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" } }
TipoObrigatórioComportamento
waitparams.durationFaz 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.
httpparams.urlFaz o pedido. method, headers e body são opcionais.
commandparams.commandExecuta 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 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 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.