# Sub-workflow

> 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.

Source: https://nodaro.ai/pt-BR/docs/nodes/automate/sub-workflow

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.

- Found in: Automate › Workflows
- Output: data
- API type: `sub-workflow`

## 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)](https://nodaro.ai/docs/nodes/image/remove-background) seguido do [**Upscale de imagem** (Upscale Image)](https://nodaro.ai/docs/nodes/image/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)](https://nodaro.ai/docs/nodes/automate/sub-workflow-input) e um nó [**Saída do sub-workflow** (Sub-Workflow Output)](https://nodaro.ai/docs/nodes/automate/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)](https://nodaro.ai/docs/nodes/image/upload-image) a uma entrada e uma saída ao [**Gerar vídeo** (Generate Video)](https://nodaro.ai/docs/nodes/video/generate-video). Clique em **Executar**.

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

- Enviar imagem → Sub-workflow (Foto do produto)
- Sub-workflow → Gerar vídeo (Foto limpa)

Workflow: 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.

- Entrada do sub-workflow → Remover fundo
- Remover fundo → Upscale de imagem
- Upscale de imagem → Saída do sub-workflow

## Entradas e saídas
As entradas e as saídas do nó vêm da rota escolhida. Cada conector da [Entrada do sub-workflow](https://nodaro.ai/docs/nodes/automate/sub-workflow-input) da rota vira uma entrada, e cada conector da [Saída do sub-workflow](https://nodaro.ai/docs/nodes/automate/sub-workflow-output) 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)](https://nodaro.ai/docs/nodes/automate/component).

## Frequently asked questions

### 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.