Descreva o processo habitual e as situações que o interrompem
A descrição de um processo costuma começar pela sequência prevista: chega um pedido, prepara-se a informação, alguém decide e o resultado fica registado. As situações menos convenientes merecem a mesma atenção. Pode faltar um anexo, dois registos podem divergir ou um sistema pode deixar de responder depois de receber uma atualização.
Comece por exemplos recentes de quem faz o trabalho. Pergunte o que verificaram, o que não conseguiram apurar e como prosseguiram. Inclua o email, a folha de cálculo ou o telefonema que permitiu avançar. Estes passos ajudam a identificar requisitos operacionais que um esquema idealizado pode omitir.
Defina o estado seguinte para cada exceção. O sistema e a pessoa responsável devem conseguir perceber o que aconteceu e o que é preciso fazer a seguir.
Interrupções diferentes exigem respostas diferentes
Uma informação em falta, uma decisão de negócio e uma falha técnica são situações distintas. Tratá-las como um erro genérico cria uma fila de pedidos que alguém terá de investigar desde o início.
Distinga o motivo da interrupção da resposta proposta. Um modelo pode ajudar a classificar ou resumir o problema, mas a aplicação deve preservar a origem, a operação tentada e os elementos disponíveis.
- Informação necessária
- Explique o que falta e quem pode fornecer essa informação. Mantenha o assunto associado ao pedido original.
- Decisão necessária
- Identifique quem tem autoridade para decidir, as opções disponíveis e as consequências de cada ação.
- Falha técnica temporária
- Defina se é seguro repetir a tentativa, quantas tentativas são permitidas e quando deve haver intervenção de um responsável.
- Resultado incerto
- Verifique o sistema de destino antes de repetir uma alteração. A falta de resposta, por si só, não demonstra que a atualização falhou.
Definir o próximo passo do trabalho interrompido
- ProntoContinuar pelo processo acordado
- Informação em faltaPedir o elemento em falta
- Decisão necessáriaPreparar uma revisão com a origem e as opções
- Resultado incertoVerificar o destino antes de repetir
A resposta depende do motivo da interrupção. Os estados, as permissões e as regras de recuperação são definidos para o sistema concreto.
Dê ao revisor os elementos de que precisa para decidir
Uma fila de exceções útil contém a informação necessária para a próxima decisão: o pedido, o estado atual, o motivo da interrupção, os documentos de suporte e a pessoa responsável. O registo concreto depende do trabalho e da sensibilidade da informação.
Quando a IA prepara informação, distinga a proposta daquilo que já foi verificado. O revisor deve conseguir consultar os elementos de suporte e corrigir um campo sem reconstruir o processo em vários sistemas.
Defina o que acontece depois da revisão. Aprovar uma proposta, corrigir um valor, pedir informação e encerrar um assunto são ações distintas. Registe a decisão e retome o processo no ponto adequado, sem repetir ações que já produziram efeitos.
Defina a recuperação antes de automatizar novas tentativas
Uma consulta falhada e uma escrita com resultado incerto têm consequências diferentes. Repetir uma consulta pode ser inofensivo; repetir uma instrução de pagamento, uma mensagem ou a criação de um registo pode duplicar o efeito. As regras de repetição devem respeitar a operação e as garantias reais do sistema de destino.
Ao criar um registo de negócio, a solução pode usar um identificador de pedido estável, um mecanismo de idempotência suportado pelo destino ou uma verificação de reconciliação. É também preciso definir o que acontece se o mesmo identificador chegar com conteúdos diferentes.
Defina em conjunto os tempos de espera, os limites de novas tentativas e as regras de intervenção. Um assunto que não pode prosseguir em segurança deve continuar visível, com contexto suficiente para uma pessoa autorizada o resolver. O fluxo também precisa de uma forma acordada de continuar o trabalho durante uma interrupção do serviço.
Teste o percurso completo de uma exceção
Use exemplos representativos com informação incompleta, valores contraditórios, acesso recusado e falhas de ligação. Verifique o destino além do ecrã: uma mensagem de sucesso na interface não prova que o registo esperado existe.
Confirme se a pessoa certa recebe o assunto, o compreende e o consegue encaminhar para um estado válido. Meça separadamente o tempo de espera por uma decisão e o tempo de processamento. Inclua novas tentativas seguras e a retoma do trabalho nos exemplos de aceitação.
O tratamento de exceções faz parte do serviço entregue. A responsabilidade pela sua gestão, as instruções de operação e os resultados dos testes devem constar do âmbito e da passagem para operação.
Referências
- Amazon Builders’ Library: tempos-limite, repetição e espera progressiva
A incerteza após um tempo-limite e os efeitos operacionais das novas tentativas.
- Amazon Builders’ Library: repetir pedidos com segurança
Identificadores de pedidos, efeitos duplicados e alterações aos parâmetros.
- RFC 9110, secção 9.2.2: métodos idempotentes
A definição HTTP e as condições para repetir um pedido.
Software, integrações e implementação de IA
Conheça as atividades, os elementos necessários e as responsabilidades que um trabalho pode incluir.
Explorar o serviço Fale connosco sobre o que precisa