Essenciais
Os três cards de todo workflow: Início (variáveis), Agent (modelo + prompt + tools) e Fim.
Atualizado em 01 de set. de 2026
Todo workflow tem um Início, pelo menos um Agent e normalmente um Fim. O Início é fixo no canvas — não se arrasta nem se apaga.
start · nó fixo do canvasDeclara as variáveis do workflow. É por elas que dados entram pela API (campo variables do run), que estado persiste entre turnos e que os nós multi-agente encontram coleções dinâmicas.
variables[].namestringobrigatórioNome usado nas referências `{{nome}}` em prompts, condições e templates.
variables[].typefixed | input | collectionobrigatório`fixed` = valor constante · `input` = vem do request (`variables`) · `collection` = tabela de itens com schema.
variables[].valueanyO valor, quando `fixed`. Pode ser texto, número ou objeto (`{"culpado": 0, "inocente": 0}`).
variables[].requiredbooleanpadrão: truePara `input`: sem o valor no request, o run falha com `502 Variáveis obrigatórias não informadas`.
variables[].persistbooleanpadrão: falseO valor sobrevive entre turnos do mesmo `thread_id` (ex.: contador de rodadas).
variables[].descriptionstringDocumentação da variável para quem integra.
variables[].schema.fields[]{name, type, required}[]Para `collection`: o schema de cada item (ex.: `id`, `name`, `role`, `alive`).
variables[].items[]object[]Para `collection`: os itens iniciais.
Referências que funcionam em condições e fontes
{{var}} valor simples · {{objeto.chave}} acesso a dict ({{votos.culpado}}) · {{colecao.* | campo=valor}} filtra itens de uma coleção · sufixos .count e .exists para contar/testar.
agent · o coração do workflowUm agente de IA: modelo + prompt + ferramentas. As ferramentas chegam pelos slots à direita — conecte qualquer card de ferramenta e o modelo passa a poder chamá-lo. Encaminhamentos para outros agentes (delegate-*) ganham uma aba própria de prompt no modal.
namestringobrigatórioNome do agente (sanitizado: letras, números e `_`). Vira o identificador em roteadores e delegações.
modelstringobrigatórioModelo de linguagem (`input_name` do catálogo, ex.: `deepseek-ai/deepseek-v4-flash`).
system_promptstringO prompt de sistema. Aceita `{{variaveis}}` do Início.
delegate_descriptionsobjectDescrição por encaminhamento (`delegate-*`): quando delegar para cada agente conectado.
config.temperaturenumberpadrão: 0.7Criatividade da amostragem (0–2).
config.max_tokensnumberpadrão: 4096Teto de tokens da resposta.
config.max_tool_loopsnumberpadrão: 10Máximo de rodadas de ferramenta por turno (proteção contra loop infinito).
config.timeoutnumberpadrão: 120Timeout em segundos de cada chamada ao modelo.
config.capture_flowbooleanpadrão: falseSe o turno termina com pergunta pendente, o próximo turno volta direto para este agente (pin), sem passar pelo roteador.
config.widget_formsbooleanpadrão: falsePermite ao agente emitir formulários e botões no widget.
config.advertise_capabilitiesbooleanpadrão: trueAnuncia as ferramentas disponíveis no prompt do agente.
config.tools_filterstring[]padrão: [] (todas)Restringe as tools visíveis a esta lista de nomes — útil quando várias ferramentas dividem o mesmo canvas.
end · encerra o fluxoMarca o fim de um caminho. A entrada de cima aceita qualquer nó; a entrada da esquerda aceita só ferramentas (fim de um pipeline). O status ajuda a ler execuções nas estatísticas.
labelstringpadrão: 'End'Rótulo visual do nó.
statussuccess | failure | neutral | custompadrão: neutralComo esta saída conta nas métricas do agente.
custom_statusstringO texto do status quando `custom`.
output_messagestringMensagem final opcional emitida ao chegar aqui.