Números de etapa

Cada etapa de um fluxo de trabalho tem um número automático — o selo no canto superior esquerdo de cada etapa na tela visual, a coluna inicial na grade de etapas e a “Etapa 7” que você vê nos logs de execução, nos relatórios de documentação do fluxo de trabalho e nas respostas do assistente de IA. O número oferece uma forma curta e inequívoca de apontar para uma etapa: “a junção na etapa 7 está descartando linhas” funciona em uma mensagem de chat, em um ticket de suporte ou em uma instrução para um agente de IA.

Como a ordem é decidida

As etapas são numeradas por fluxo primeiro, posição depois:

1. O fluxo sempre vence. Uma etapa é sempre numerada depois de todas as etapas das quais ela depende. Se a Etapa A alimenta a Etapa B, o número de A é menor — sem exceções.
2. A posição desempata. As etapas executadas em paralelo (sem dependência entre elas) são ordenadas pela posição na tela: da esquerda para a direita, depois de cima para baixo.

Em uma tela organizada, os números simplesmente crescem conforme você lê o diagrama da esquerda para a direita — use o botão de organização automática para desembaraçar um fluxo de trabalho importado e a numeração acompanhará o desenho.

Os fluxos de trabalho padrão (seriais) são numerados pela ordem das etapas — a mesma ordem que a grade de etapas sempre exibiu.

Os números são atualizados conforme o fluxo de trabalho muda

Os números de etapa são derivados do fluxo de trabalho atual, não armazenados. Insira uma etapa, exclua uma, redesenhe uma dependência ou arraste uma etapa paralela para o outro lado da tela, e os números se ajustam — para todos que estão vendo o fluxo de trabalho, imediatamente. Um breve destaque no selo da tela mostra quais etapas acabaram de receber um novo número.

Use nomes ou IDs para referências duráveis

Como os números seguem o fluxo, eles podem mudar quando o fluxo de trabalho é editado. São perfeitos para falar sobre o fluxo de trabalho como ele está agora — em uma chamada, em um log de execução que você está depurando, em uma conversa com IA sobre o grafo atual. Para referências que precisam sobreviver a edições futuras — documentação, favoritos, automação — use o nome da etapa ou seu ID exclusivo.

Os logs de execução registram os números como eram quando a execução começou, de modo que o log de uma execução sempre corresponde ao que a tela mostrava na época — mesmo que o fluxo de trabalho tenha sido editado depois.

Copiar uma referência de etapa

Clique com o botão direito em uma etapa na tela e escolha Copiar referência da etapa (ou clique no próprio selo de número) para copiar uma referência pronta para colar, como Step 7 — Clean Customer Names. Colar o número e o nome significa que a referência continua identificando a etapa mesmo que a numeração mude depois.

Números de etapa e agentes de IA

Os assistentes de IA conectados por MCP veem os mesmos números que você: workflow_describe lista as etapas de um fluxo de trabalho com seu step_number em ordem numérica, então você pode dizer a um agente “olhe a etapa 7” e ele identificará a mesma etapa que você está vendo. Os números são apenas informativos — nenhuma ferramenta aceita um número de etapa como entrada, então um agente sempre age sobre o ID estável da etapa depois de resolver o número.

Onde o mesmo número aparece

• O selo em cada etapa da tela (passe o mouse sobre ele para ver a regra de ordenação).
• A coluna inicial da grade de etapas do fluxo de trabalho.
• O cabeçalho do Inspetor acoplado e o histórico de execução por etapa.
• Logs de execução: Step 7 — Clean Customer Names: started. As etapas desativadas são registradas como ignoradas com o número, para que a sequência nunca tenha lacunas silenciosas.
• O relatório de documentação do fluxo de trabalho — tabela de resumo, seções por etapa e diagramas.
• A coluna Número da etapa da pré-visualização de dependências de tabela.
• Listagens de etapas do assistente de IA / MCP.

Nota

Em fluxos de trabalho avançados (visuais), a grade de etapas lista as linhas na ordem dos números de etapa, e os botões Mover para cima / Mover para baixo / Mover da grade ficam desativados — organize o fluxo na tela; os números seguem o seu layout.