Botões de uma Etapa

Cada controle em um cartão de etapa — começando pelos dois que são fáceis de confundir.

Passe o mouse sobre uma etapa na tela para exibir uma fileira de botões no cabeçalho. A maioria é autoexplicativa. Dois não são, e a diferença entre eles representa boa parte do que distingue o IceFold de um fluxo automatizado comum.

▶ Executar vs. ✓ Confirmar

Ambos "fazem as coisas acontecerem", então é tentador tratá-los como o mesmo botão. Mas a diferença não é se algo será executado — é quem toma a decisão e até onde o clique produz efeitos.

▶ Executar — fazendo uma pergunta

"Se eu pegar o rascunho acima de mim exatamente como está, o que esta etapa me dá?"

Executar é manual e age sobre uma etapa. Ele lê o conteúdo atual das entradas — inclusive uma saída anterior que você ainda não confirmou. Esse é o objetivo: você pode visualizar uma cadeia de rascunhos antes de aprovar qualquer parte dela.

O botão diz Executar esta etapa na primeira vez e Executar novamente esta etapa depois (ou Executar / Executar novamente todas as versões de conteúdo em uma etapa com várias versões). Etapas de entrada não têm esse botão — nelas, ✓ envia e confirma a entrada.

O IceFold distingue duas condições das etapas anteriores e informa qual se aplica:

• a saída anterior ainda vai mudar — ela está em execução, na fila ou desatualizada e será reexecutada. O resultado exibido agora será substituído, então talvez seja necessário repetir uma execução que o utilize. Você pode aguardar ou escolher Executar com as entradas atuais no aviso.
• a etapa anterior ainda não produziu nada — não há o que ler. O IceFold identifica a entrada vazia em vez de enviar silenciosamente um prompt vazio a um modelo.

Estar ainda não confirmada não é uma dessas condições.

✓ Confirmar — tomando uma decisão

"Este artefato está bom. Envie-o às próximas Etapas."

Confirmar significa aprovar o resultado e enviá-lo adiante. As Etapas automáticas que ficarem prontas podem ser executadas e gastar créditos. Etapas configuradas como Executar manualmente, saídas fixadas e saídas editadas por uma pessoa continuam sendo barreiras; Precisa de revisão adiciona a próxima barreira de revisão.

Como representa uma aprovação, a ação padrão pausa se uma Etapa anterior ainda estiver mudando ou aguardando confirmação, e informa qual é. Assim, um clique comum não parece aprovar toda a cadeia.

Quando todas as Etapas anteriores bloqueadoras já terminaram e aguardam apenas confirmação — e esta Etapa leu exatamente as saídas atuais delas —, o mesmo aviso oferece Usar esta saída e continuar. Essa confirmação local única publica a partir desta Etapa sem confirmar as anteriores nem iniciar seus outros ramos. Ela não fixa a saída nem cria uma barreira duradoura. Confirmar depois essas mesmas saídas anteriores não reexecuta esta Etapa; uma saída anterior realmente nova deixa esta Etapa desatualizada e volta a aplicar suas configurações normais de Executar manualmente / Precisa de revisão. Se uma Etapa anterior ainda estiver em execução ou esta saída já estiver desatualizada, aguarde ou reexecute. Use Fixar saída para preservar esses bytes por longo prazo.

O ✓ fica roxo enquanto a etapa ainda não foi confirmada e muda para verde depois da confirmação. Clicar no botão verde tem outro significado, indicado na dica:

• Confirmar e executar próximas etapas (roxo) — aceita esta saída e permite que as etapas posteriores prossigam.
• Confirmar novamente e reexecutar próximas etapas (verde) — o IceFold trata a confirmação como nova, e as Etapas automáticas posteriores elegíveis são reexecutadas até encontrar uma barreira manual, fixada, editada por uma pessoa ou de revisão. Use quando quiser uma nova execução, não apenas para "verificar novamente" — as reexecuções podem gastar créditos.

Você escolhe onde essas barreiras ficam. Ative Precisa de revisão em uma Etapa para que ela pare após a execução e permita uma análise antes de o Fluxo avançar. Uma Etapa sem essa barreira confirma o resultado automaticamente ao terminar.

Confirmar uma visualização não a reexecuta

A parte que vale a pena internalizar:

Executar nunca confirma nada para você.

Visualize uma etapa usando uma saída anterior ainda não confirmada. Se gostar do resultado, volte e confirme essa saída: a etapa visualizada permanecerá exatamente como está. Ela não será redefinida nem reexecutada, e não haverá nova cobrança. O IceFold registra qual entrada a visualização realmente utilizou, então confirmar essa mesma entrada não fornece nada novo.

A exceção é intencional: se você alterar a etapa anterior entre a visualização e a confirmação — reexecutando-a ou editando sua saída manualmente — a entrada será diferente. A Etapa fica desatualizada e segue suas configurações de Executar manualmente e Precisa de revisão. Confirmar uma entrada alterada é uma mudança real; confirmar uma entrada inalterada não é.

Editar uma saída manualmente é diferente de confirmar localmente uma visualização. A versão de conteúdo editada recebe o selo de procedência Editado, e a automação anterior não pode substituir silenciosamente essa geração. As outras versões continuam independentes. Uma execução explícita substitui a geração editada e restaura o comportamento gerado. Para proteção duradoura, use Fixar saída, não o selo Editado.

Executar em si pode gastar créditos. A economia é que confirmar uma entrada inalterada não repete o trabalho que você já visualizou. Explore com Executar; comprometa-se deliberadamente com Confirmar.

	▶ Executar	✓ Confirmar
O que você está dizendo	"O que isso me daria?"	"Eu aceito isso."
Alcança	apenas esta etapa	Etapas automáticas posteriores que ficarem prontas
Pode gastar créditos em	execução desta etapa	execuções posteriores iniciadas
Exige confirmação anterior?	não — essa é a visualização	por padrão; entradas estáveis não confirmadas podem continuar localmente
Decide algo para você	nunca	esse é o ponto inteiro

O resto do cartão

• ■ Parar — aborta uma etapa em execução. Substitui ▶ enquanto a etapa executa, então uma etapa nunca é executável e parável ao mesmo tempo.
• ↻ Executar novamente esta versão de conteúdo — em uma etapa com várias versões, cada aba de versão de conteúdo tem sua própria reexecução. Apenas essa versão é recalculada; as demais permanecem inalteradas. Use ◀ / ▶ para navegar pelas abas quando não couberem todas.
• ⬇ Baixar — salva a saída desta etapa. Texto estruturado usa o formato declarado (por exemplo, .srt para legendas); os demais textos usam .md por padrão.
• ✎ Próximas etapas — cria e conecta a próxima etapa revisável de acordo com a saída atual. Vídeo oferece Editar vídeo, Extrair quadro e Extrair áudio; áudio oferece Editar áudio, Transcrever, Alinhar legendas e Misturar com música. Imagem e texto exibem ações relevantes de leitura, geração e animação. Refinamentos são inseridos no fluxo e derivados criam uma ramificação; arquivos também oferecem Substituir saída….
• 🔒 Fixar saída — preserva o resultado. Uma etapa fixada não é executada, reexecutada nem editada, e alterações anteriores não redefinem sua saída; Confirmar ainda pode publicar esses bytes fixos. Use Desafixar saída quando quiser que ela volte a participar. Desafixar não a executa automaticamente: se as entradas mudaram, execute quando estiver pronto. Isso é diferente de Bloquear layout, que só evita arrastar e redimensionar acidentalmente na tela.
• ⤢ Abrir visualização expandida — abre o diálogo completo de detalhes, com entradas, parâmetros, saída e versões de conteúdo. Clicar duas vezes no cartão produz o mesmo resultado.
• Renomear etapa — use o lápis ao lado do título em Propriedades Rápidas ou na vista expandida, ou clique com o botão direito no cartão. Isso muda apenas o nome que você vê; conexões, saídas e estado de execução permanecem intactos.
• ⧉ Abrir grupo — em uma etapa de Subfluxo, abre o grafo que ela contém.

Relacionado

• Solução de problemas → "Minha etapa está travada em enfileirado" — geralmente indica uma etapa anterior com erro ou aguardando uma confirmação.