Como faço para um workflow poder ser usado como sub-workflow?

Adicione a ele um nó “Entrada do sub-workflow” e um nó “Saída do sub-workflow”, pareie os dois com a mesma rota e dê conectores a eles. Um workflow com pelo menos um par aparece na lista “Workflow” do nó “Sub-workflow”.

Qual é a diferença entre “Criar sub-workflow vazio” e escolher um workflow existente?

“Criar sub-workflow vazio” cria um novo workflow filho que pertence a este nó. Ele fica oculto na lista de workflows do projeto e só abre a partir deste nó. Um workflow existente continua sendo um workflow normal, que qualquer outro workflow pode reutilizar.

Quantos níveis de sub-workflows posso aninhar?

Até 5 níveis. Um workflow não pode chamar a si mesmo pela mesma rota, nem diretamente nem por meio de outros workflows, mas pode chamar a si mesmo por uma rota diferente.

Um nó “Sub-workflow” custa créditos extras?

Não. O nó “Sub-workflow” em si é gratuito. Você paga pelos nós que são executados dentro dele, pelo preço normal de cada um, e só são executados os nós que a rota escolhida alcança.

Por que o nó mostra conectores antigos depois que eu mudei o workflow interno?

O nó guarda uma cópia das entradas e das saídas da rota. Clique em “Atualizar”, ao lado de “Interface”, no painel de configurações, para carregar os novos conectores.

Nó Sub-workflow: use um workflow inteiro como um único nó e edite-o ali mesmo

Coloque um workflow inteiro dentro de outro como um nó, com entradas e saídas tipadas. Crie um novo ali mesmo ou reutilize um existente, com até 5 níveis.

O nó Sub-workflow coloca um workflow inteiro dentro de outro como um único nó. Por fora, ele parece qualquer outro nó, com entradas, saídas e um status. Clique no ícone de expandir do nó para editar o workflow interno ali mesmo, e uma trilha de navegação no topo do editor mostra onde você está. Use-o para reutilizar um pipeline em vários workflows ou para manter um workflow grande fácil de ler.

Quando usar

Você usa o mesmo pipeline de composição de vídeo em vários workflows de conteúdo.
Você quer uma cadeia de processamento, como o Remover fundo (Remove Background) seguido do Upscale de imagem (Upscale Image), como um único nó reutilizável.
O seu workflow cresceu, e você quer dividi-lo em módulos.
Você quer reunir cada cena de um filme, com a imagem, a animação, a fala e a sincronização labial dela, em um só nó.

Início rápido

Adicionar o nó

Pressione Tab no canvas e escolha Automatizar › Workflows › Sub-workflow.

Criar ou escolher o workflow interno

Para começar do zero, salve o seu workflow e clique em Criar sub-workflow vazio no painel de configurações. O Nodaro cria um workflow filho com um nó Entrada do sub-workflow (Sub-Workflow Input) e um nó Saída do sub-workflow (Sub-Workflow Output) e o abre para edição. Se preferir reutilizar um workflow que você já tem, escolha-o em Workflow e depois escolha uma Rota.

Montar ou conferir o workflow interno

Dentro do workflow filho, conecte os nós entre a Entrada do sub-workflow e a Saída do sub-workflow e defina os conectores delas. Clique no nome do workflow pai na trilha de navegação para voltar.

Conectar e executar

Os conectores da rota aparecem como entradas e saídas no nó Sub-workflow. Conecte-os como os de qualquer outro nó, por exemplo um Enviar imagem (Upload Image) a uma entrada e uma saída ao Gerar vídeo (Generate Video). Clique em Executar.

No workflow pai, um único nó Sub-workflow representa um pipeline de limpeza inteiro entre o envio e o vídeo.

Dentro do Sub-workflow, o conector de entrada alimenta o Remover fundo e o Upscale de imagem, e o conector de saída devolve a foto limpa.

Entradas e saídas

As entradas e as saídas do nó vêm da rota escolhida. Cada conector da Entrada do sub-workflow da rota vira uma entrada, e cada conector da Saída do sub-workflow dela vira uma saída. Cada conector tem a cor do seu tipo: texto, imagem, vídeo, áudio ou qualquer tipo.

Uma rota é uma Entrada do sub-workflow pareada com uma Saída do sub-workflow pelo mesmo ID de rota. Um workflow pode ter várias rotas, e cada rota é um caminho separado dentro dele.

Configurações

Configuração	O que faz
Rótulo	O nome do nó neste workflow.
Criar sub-workflow vazio	Cria um novo workflow filho com um nó de entrada e um nó de saída, vinculado a este workflow, e o abre para edição. Fica desativado até que o workflow pai seja salvo.
Workflow	Reutiliza um workflow existente. A lista mostra todos os workflows que têm pelo menos uma rota, com o número de rotas de cada um. Os workflows filhos que pertencem a outros nós ficam ocultos.
Todos os projetos	Desativado por padrão, então a lista mostra só o projeto atual. Ative para ver os workflows de todos os projetos.
Rota	A rota a usar, quando o workflow tem mais de uma. Cada rota mostra o número de entradas e de saídas dela.
Interface	As entradas e as saídas da rota escolhida. Atualizar as recarrega depois que você muda o workflow interno.
Ver workflow	Abre o workflow interno em um visualizador somente leitura, sem sair da página.
Abrir workflow	Abre o workflow interno para edição, como o ícone de expandir no nó.
Modo de exibição	Como o nó aparece no canvas. Conectores mostra as entradas, as saídas, o status e uma prévia do resultado.

Editar o workflow interno ali mesmo

Clique no ícone de expandir do nó, com o rótulo Editar workflow referenciado, ou clique em Abrir workflow no painel de configurações. O editor abre o workflow interno, e uma trilha de navegação no topo mostra o caminho, por exemplo Vídeo de lançamento › Foto limpa do produto. Clique em qualquer parte da trilha para ir até aquele nível. A trilha desaparece quando você volta ao primeiro workflow.

Se o workflow atual tiver alterações não salvas, o editor pergunta se você quer salvá-las ou descartá-las antes de abrir o workflow interno.

Regras para workflows que podem ser chamados

Quando você salva um workflow que contém nós Entrada do sub-workflow ou Saída do sub-workflow, o Nodaro verifica três regras:

Cada Entrada do sub-workflow tem uma Saída do sub-workflow com o mesmo ID de rota.
Cada Saída do sub-workflow tem pelo menos um conector.
Dois nós Entrada do sub-workflow nunca compartilham um ID de rota, e dois nós Saída do sub-workflow também não.

Um salvamento que viola uma regra é recusado, e cada problema é listado.

Como é executado

Só a rota é executada. Os nós conectados depois da Entrada do sub-workflow da rota são executados. Os outros nós do workflow interno não são executados.
Até 5 níveis de profundidade. Um sub-workflow pode conter sub-workflows, até 5 níveis.
Sem loops. Um workflow não pode chamar a si mesmo pela mesma rota, nem diretamente nem por meio de outros workflows. O mesmo workflow ainda pode ser chamado por uma rota diferente.

Créditos

O nó Sub-workflow é gratuito. Cada nó executado dentro dele é cobrado pelo preço normal.

Dicas

Mantenha o aninhamento raso. O limite é de 5 níveis, e workflows muito aninhados são mais difíceis de depurar.
Crie um sub-workflow vazio para módulos de uso único. Um workflow filho criado com Criar sub-workflow vazio pertence só ao workflow pai e não polui a lista de workflows do projeto.
Escolha um workflow existente para blocos compartilhados. Um workflow normal continua na lista, e qualquer workflow pai pode reutilizá-lo.
Atualize depois de mudar. Quando você adiciona, remove ou muda o tipo de conectores no workflow interno, clique em Atualizar no workflow pai.
Dê a cada nó o nome da função dele. Um rótulo como “Foto limpa do produto” explica o papel do nó no workflow pai.
Publique em vez de compartilhar. Para oferecer um pipeline a outras pessoas como um nó com versões, publique-o como Componente (Component).

Sub-workflow