Resposta direta
Repetição sem limite se controla com dois tetos e uma chave. O primeiro teto é o número de tentativas por item; o segundo, o número de passagens do laço inteiro. A chave é o identificador de idempotência: antes de agir, a rotina confere se aquele item já foi processado naquela execução. Quando qualquer teto é atingido, o item sai do fluxo ativo e vai para uma fila de exame, com o motivo registrado. Sem isso, uma falha intermitente produz um ciclo que se alimenta sozinho. O limite não é sobre o volume da operação; é sobre quantas vezes o mesmo caso pode ser tratado sem decisão humana.
- Objetivo
- Orientar implementação
- Formato indicado
- Workshop executivo
- Atualizado em
O que esta página acrescenta: Trata o teto de repetição como decisão de processo — tentativas, passagens e descarte —, e não como ajuste de configuração de ferramenta.
Duas contagens, não uma
Toda execução que repete precisa de duas contagens distintas. A primeira é por item: quantas vezes aquele caso específico pode ser retentado. A segunda é por ciclo: quantas passagens completas o laço pode dar antes de encerrar. As duas respondem a riscos diferentes. O teto por item evita insistência sobre um caso problemático. O teto por ciclo evita que o reprocessamento gere novos itens e o laço se amplie.
Definir os dois valores é decisão de operação, não de infraestrutura. Quem conhece o processo sabe qual falha é transitória e qual é definitiva. Essa distinção indica quantas tentativas fazem sentido e a partir de quando o caso precisa de uma pessoa. Sem essa definição, o padrão da ferramenta decide no lugar da área responsável.
Idempotência antes da ação
Um contador sozinho não impede duplicidade. Se a rotina age antes de verificar o que já foi feito, a repetição pode cobrar duas vezes, enviar duas mensagens ou criar dois registros. A verificação vem antes da ação: a chave de idempotência identifica o item e confirma se aquela operação já ocorreu na execução corrente.
A chave precisa ser estável e vir do processo, não do momento da chamada. Identificador do pedido, número do documento, combinação de data e origem. Chave gerada pelo horário de execução muda a cada tentativa e não serve para nada. Definir a chave é definir qual unidade de trabalho a automação não pode tratar duas vezes.
O que o teto não resolve
Limitar repetição não corrige a causa da falha. Se a origem do erro é um dado ausente, uma regra ambígua ou uma integração instável, o item vai parar na fila de exame todas as vezes. O teto protege o sistema do ciclo; ele não torna o processo confiável.
Também não substitui a fila de exame. Teto sem destino vira acúmulo silencioso: os itens saem do laço e ninguém olha. A fila precisa de dono, critério de prioridade e rotina de tratamento. Onde não existe quem trate os itens descartados, o teto apenas esconde o problema em outro lugar.
Recurso prático
Do item que falha ao item que para de ser repetido
- Antes da ação, gerar a chave de idempotência do item e verificar se ela já existe na execução corrente.
- Executar a ação e registrar o resultado vinculado à chave.
- Se falhar, incrementar o contador de tentativas daquele item e comparar com o teto definido.
- Ao atingir o teto por item, retirar o caso do laço e enviar para a fila de exame, com o último erro anexado.
- Encerrar o ciclo quando o contador de passagens do laço inteiro atingir o teto, mesmo com itens pendentes.
O erro mais comum é contar tentativas por execução e não por item: um único caso defeituoso consome o teto de todos os outros e o lote inteiro para. O ponto ignorado é o teto de passagens do laço, que evita o ciclo que reprocessa o próprio resultado.
Sobre o que está escrito aqui
Conceitos relacionados: chave de idempotência · teto de tentativas por item · teto de passagens do laço · fila de descarte · contador por item. Exemplos são ilustrativos. Não há cliente, resultado, preço, prazo ou certificação nesta página. Quando o formato indicado é Workshop executivo, ele descreve uma possibilidade de trabalho — a conversa inicial avalia contexto e aderência.
Para continuar
- Governança e controle de automação — Página central do tema
- Chave de API sem validade: o que exigir no co… — chave de API sem prazo de validade
- Permissão de teste que ninguém removeu: como… — permissão concedida para teste e nunca removida
Páginas relacionadas
O mesmo problema em outro objetivo
- Repetição sem limite: onde o controle deixa de contar — Diagnosticar
- Execução sem limite de repetição: onde fixar o teto — Organizar um processo
- Repetição sem limite: travas por contagem, tempo e custo — Comparar alternativas
- Execução sem limite de repetição: como medir o excesso — Explicar medição
- Execução sem limite de repetição: o teto no contrato — Orientar avaliação e contratação
Outras leituras em Governança e controle de automação
- Automação sem ambiente de teste: o que avaliar antes — Critérios de avaliação e aceite para contratar automação quando não há ambiente de teste: o que exigir do fornecedor em evidência, escopo e responsabilidade.
- Contrato sem prazo de resposta: o que medir na falha — Medição do intervalo entre falha e resposta quando o contrato não prevê prazo, com marcos de registro e uso do histórico na negociação.
- Segredo em texto no fluxo: o que exigir na contratação — O que avaliar e o que fechar no contrato quando a automação guarda o segredo em texto puro, com matriz de situações e o ponto de responsabilidade de cada uma.
- Registro de execução sem hora confiável: ordenar eventos — Organização do registro de execução quando o horário não é confiável: separar marcador de ordem, horário e evidência indireta, com o grau de certeza declarado.
- Parada planejada: o aviso que as áreas deveriam receber — Descreve como organizar o aviso de parada planejada: quem informa, o que a área confirma antes da janela e onde o registro fica.