Docs do Nodaro
DocumentaçãoReferência de nósModelosAgentes de IA (MCP)DesenvolvedoresSelf-hostingPesquisa
Conceitos básicos

Componentes e sub-workflows

Junte um grupo de nós em um nó reutilizável: um sub-workflow editável ali mesmo ou um componente publicado com entradas, configurações e preço próprios.

Um sub-workflow é um workflow colocado dentro de outro workflow como um único nó. Um componente é um workflow publicado e com versões que qualquer pessoa pode colocar nos próprios workflows da mesma forma. Os dois transformam um grupo de nós em um nó com entradas e saídas nomeadas. Use-os para reutilizar uma sequência já testada, como “remover o fundo e depois aumentar a resolução”, e para manter legível um workflow grande.

Sub-workflow ou componente

Sub-workflowComponente
NóSub-workflowComponente (Component)
O que contémUm dos seus workflowsUm workflow que alguém publicou como componente, ou um que você publicou
Dá para ver e editar o interior?Sim. Abra ali mesmo, a partir do nó.Não. Você define só as entradas e as configurações que o autor expôs.
Entradas e saídasOs conectores que você declara com os nós Entrada do sub-workflow (Sub-Workflow Input) e Saída do sub-workflow (Sub-Workflow Output)As entradas e as saídas que o autor escolheu ao publicar
AlteraçõesSegue o workflow para o qual aponta. Clique em Atualizar depois de mudar os conectores dele.Mantém a versão com que foi adicionado até você atualizá-lo
PreçoOs nós de dentro cobram o preço normalUm preço estimado, que pode incluir o acréscimo do autor
Ideal paraEstruturar os seus workflows grandesCompartilhar uma etapa pronta com outras pessoas

Criar um sub-workflow

Adicionar o nó Sub-workflow

Salve o workflow primeiro. Depois, abra o menu Adicionar nó e escolha Automatizar › Workflows › Sub-workflow.

Criar ou escolher o workflow interno

No painel de configurações, clique em Criar sub-workflow vazio. O Nodaro cria um novo workflow interno com um nó de entrada e um nó de saída e o abre para edição. Para reutilizar um workflow que você já tem, escolha-o na lista Workflow. Ative Todos os projetos para ver workflows dos seus outros projetos.

Declarar as entradas e as saídas

Dentro do workflow interno, o nó Entrada do sub-workflow lista os conectores que o workflow pai pode alimentar. Cada conector tem um nome e um tipo de mídia: texto, imagem, vídeo, áudio ou qualquer um. O nó Saída do sub-workflow lista os conectores que devolvem resultados. No nó de saída, escolha em Saída visível qual conector tem o resultado que o workflow pai mostra como prévia do nó.

Conectar no workflow pai

Volte ao workflow pai pela trilha de navegação no topo do editor. Agora o nó Sub-workflow tem uma entrada e uma saída para cada conector. Conecte-o como qualquer outro nó e execute o workflow pai.

imagemreferênciasquadro inicialEnviar imagemFoto do produtoSub-workflowRemove o fundo, faz upscaleGerar imagemCena de estúdioGerar vídeo
Uma sequência de limpeza em duas etapas fica dentro de um único nó “Sub-workflow”, então o canvas do workflow pai continua enxuto.

Abrir, visualizar e navegar

  • Expandir, no nó, abre o workflow interno para edição. Uma trilha de navegação no topo do editor mostra o caminho, como seu workflow › o sub-workflow › um sub-workflow aninhado. Clique em qualquer parte do caminho para ir até ela.
  • Ver workflow abre o workflow interno em uma janela somente leitura, sem sair do workflow pai.
  • Se você tiver alterações não salvas ao expandir um nó, o editor pede que você as salve ou descarte antes.

Um sub-workflow criado com Criar sub-workflow vazio pertence ao workflow pai. Ele não aparece na lista de workflows do seu projeto, e você só chega a ele pelo nó. Um workflow que você escolhe na lista Workflow continua sendo um workflow normal, que outros workflows pais também podem usar.

Rotas: vários pontos de entrada em um workflow

Uma rota é um par formado por um nó Entrada do sub-workflow e um nó Saída do sub-workflow correspondentes. Um workflow pode ter várias rotas, e cada rota é um caminho separado dentro dele. No nó Sub-workflow, escolha a rota em Rota. A Interface mostra as entradas e as saídas dessa rota.

Só são executados os nós que a rota escolhida alcança. O resto do workflow interno fica como está.

Regras e limites

  • Até 5 níveis. Sub-workflows podem conter sub-workflows, com até 5 níveis de profundidade. Mantenha o aninhamento raso, porque cadeias profundas são mais difíceis de depurar.
  • Sem loops. Um workflow não pode chamar a si mesmo, nem diretamente nem por meio de outro workflow. Mesmo assim, o mesmo workflow pode ser usado duas vezes por duas rotas diferentes.
  • Toda rota precisa estar completa. Quando você salva, o Nodaro verifica três coisas. Cada nó de entrada tem um nó de saída correspondente. Cada nó de saída tem pelo menos um conector. Dois nós de entrada nunca compartilham uma rota, e dois nós de saída também não.
  • Atualize depois de alterar. Quando você muda os conectores de um workflow que outros workflows usam, clique em Atualizar em cada nó Sub-workflow que o usa.

Usar um componente

Adicionar um nó Componente

Abra o menu Adicionar nó e escolha Automatizar › Workflows › Componente. Em vez de um nó vazio, abre-se o catálogo de componentes, com três abas: Explorar, Meus componentes e Favoritos. Pesquise pelo nome e ordene por Mais populares, Mais recentes ou Mais favoritados.

Escolher um componente

Clique no cartão de um componente. O nó chega ao canvas já configurado, com as entradas e as saídas do componente.

Definir as entradas e as configurações

O painel de configurações tem três partes:

  • Entradas: uma entrada conectada mostra que vem de um nó anterior. Você pode digitar ali mesmo uma entrada de texto não conectada. As entradas de imagem, vídeo e áudio precisam de uma conexão.
  • Configurações: as opções que o autor deixou ajustáveis, como uma qualidade ou uma proporção.
  • Saídas: o nome e o tipo de cada saída, para ajudar você a conectar os próximos nós.

Conferir o preço e executar

O painel de configurações mostra um preço estimado em créditos, que é atualizado conforme você muda as configurações. Execute o nó, ou o workflow inteiro, como de costume.

Um nó Componente mantém a versão com que foi adicionado, então uma nova versão do autor nunca muda o seu workflow de surpresa. Clique no ícone de atualizar no painel de configurações para passar para a versão mais recente e a nova estimativa de preço dela.

Publicar o seu próprio componente

Um componente começa como um workflow normal. Publique-o pela aba Apresentar do editor:

  1. Na aba Apresentar, adicione os nós que devem virar as entradas e as saídas do componente.
  2. Clique em Publicar e escolha Componente. Insira um Nome do componente e uma descrição.
  3. Em Conectores do componente, dê um nome a cada entrada e saída. Marque as entradas obrigatórias e escolha uma saída como a prévia que o nó mostra no canvas.
  4. Escolha se quer listá-lo no catálogo de componentes e publique.

No Nodaro Cloud, você pode cobrar um acréscimo quando outras pessoas usam o seu componente: uma taxa fixa em créditos, uma porcentagem ou as duas. As configurações mostram o custo base e quanto os usuários vão pagar. Os seus componentes aparecem em Meus componentes, onde você pode editá-los, listá-los, deixar de listá-los ou arquivá-los.

Um workflow pode ser publicado tanto como componente quanto como miniapp. O miniapp dá às pessoas um formulário para preencher, e o componente dá a elas um nó para conectar.

Perguntas frequentes

Última atualização

Nesta página