Como escrever um caso de teste em linguagem simples que um agente de IA consegue executar
By Mirko Peters · · Updated
Escreva casos de teste em linguagem simples que um agente de IA consegue executar: um comportamento por teste, uma ação por passo, elementos nomeados e um resultado esperado claro e verificável.
Automatically translated with AI from the original post. Read the English original
Para escrever casos de teste em linguagem simples que um agente de IA consegue executar, mantenha cada teste com um único comportamento, cada passo com uma única ação e cada verificação com um único resultado que você possa ver na tela. Este guia é para líderes de QA e testadores que querem sair de roteiros de script e passar para instruções escritas, sem perder resultados confiáveis. Você vai conhecer as cinco partes de um caso de teste, as regras que tornam um passo executável, um método para transformar critérios de aceitação em testes e um exemplo prático que você pode copiar.
Pontos-chave
- Um caso de teste em linguagem simples tem cinco partes: título, pré-condições, passos, resultado esperado e dados de teste, e um agente de IA precisa que todas as cinco estejam explicitadas.
- Escreva um comportamento por teste e uma ação por passo, porque fabricantes de ferramentas relatam que instruções de passo único são as mais precisas.
- Nomeie cada elemento como o usuário o vê, por exemplo o botão Entrar, em vez de escrever apenas "o botão" ou "o campo".
- Dê a cada teste um resultado esperado que possa ser verificado na tela, como um título ou um valor, nunca apenas "verificar se funciona".
- Leia o que o agente gerou antes de confiar em um resultado de aprovação e reescreva qualquer passo que ele tenha interpretado de forma diferente do que você pretendia.
As cinco partes de um caso de teste em linguagem simples
Um bom caso de teste se lê como uma história curta que qualquer pessoa da equipe consegue acompanhar. Em testes de software, escrever casos de teste eficazes é uma habilidade central de QA, e testadores manuais sempre os escreveram em linguagem simples. O que é novo é que um agente de IA agora consegue executar os passos do teste. Isso é mais importante para testes de ponta a ponta, em que um teste acompanha um usuário por um fluxo de trabalho completo em um navegador. Para um agente de IA, cada parte precisa ser explícita, porque o agente não pode perguntar o que você quis dizer.
- Título. Uma linha que descreve o comportamento, como "Um cliente consegue redefinir uma senha esquecida". O título é a primeira coisa que o leitor vê em um relatório.
- Pré-condições. O estado em que o produto precisa estar antes de o teste começar, por exemplo "Existe uma conta de cliente e o cliente está desconectado".
- Passos. O que o usuário faz, uma ação por linha.
- Resultado esperado. O que o usuário deve ver depois, em termos que você possa verificar na tela.
- Dados de teste. Os valores exatos usados, como um endereço de e-mail ou um número de pedido.
Um modelo compartilhado mantém os casos de teste de todos os testadores no mesmo formato, e uma suíte de testes com um único modelo é muito mais fácil de revisar. Um caso de teste também precisa de uma forma de verificar o resultado, e é por isso que o resultado esperado é tão importante.
Esta é a mesma estrutura usada pelo desenvolvimento orientado por comportamento. Na linguagem Gherkin, como explicado no site Automation Panda, Given define o estado inicial, When executa a ação testada e Then declara o resultado esperado. Você não precisa usar essas palavras-chave. Os três papéis continuam sendo úteis.
Regras que tornam um passo executável por um agente de IA
As ferramentas publicam orientações para escrever instruções que um agente de IA consegue seguir. A documentação da BrowserStack para o seu agente de teste em linguagem natural traz regras que valem para a maioria das ferramentas:
- Comece com um verbo de ação. "Clique no botão Enviar" é claro. "O botão de enviar" não é uma instrução.
- Use uma intenção por comando. Divida tarefas com várias etapas em passos separados.
- Nomeie o elemento específico. Escreva "o botão Entrar", e não "o botão".
- Role a tela primeiro quando o alvo estiver fora da área visível. Adicione um passo antes da ação.
A mesma página diz que a confiabilidade cai conforme os comandos ficam mais complexos e que instruções de um único passo são as mais precisas. Acrescento três regras baseadas na experiência:
- Use as palavras que aparecem na tela. Se o botão diz "Sign in", não escreva "Log in".
- Coloque os valores no passo. Escreva "Digite ana@example.com no campo Email", e não "insira um e-mail válido".
- Evite pronomes e termos vagos. "Ele", "lá", "corretamente" e "adequadamente" escondem uma decisão que o agente precisa adivinhar.
Como escrever casos de teste em linguagem simples, passo a passo
Siga este método para transformar um requisito em um caso de teste.
- Parta de um critério de aceitação. Use uma única frase da história de usuário, por exemplo: "Um cliente que esquece a senha pode definir uma nova por e-mail".
- Escolha um comportamento. Cada caso de teste verifica um comportamento. O guia da Automation Panda sobre como escrever bons cenários Gherkin resume isso como "Um cenário, um comportamento" e afirma que um cenário com vários pares When-Then deve ser dividido.
- Escreva o estado inicial. Descreva-o como um estado, e não como ações de preparação. "Existe uma conta de cliente" é melhor do que dez passos que criam essa conta.
- Escreva as ações do usuário. Cada ação é uma linha curta, com um verbo e um elemento nomeado.
- Escreva o resultado esperado. Diga o que aparece: um título, uma mensagem, um valor. Use o texto exato.
- Inclua os dados. Coloque os valores nos passos ou em uma pequena tabela abaixo do teste.
- Leia em voz alta. Se um colega recém-chegado não conseguiria executá-lo manualmente, o agente também terá dificuldade.
O mesmo guia sugere manter os cenários curtos, com menos de dez passos. Um caso de teste longo costuma ser vários casos de teste unidos. Variações de um mesmo comportamento, como três senhas inválidas, pertencem a uma tabela de dados, e não a três cópias dos mesmos passos.
Exemplo: um teste de redefinição de senha, antes e depois
Os detalhes são fictícios.
Antes (vago demais). "Verificar se a redefinição de senha funciona." Um agente não tem estado inicial, ações nem resultado a conferir. Ele pode passar pelo motivo errado.
Depois (executável).
- Título: Um cliente pode solicitar um link para redefinir a senha.
- Pré-condição: Existe uma conta de cliente para ana@example.com, e o cliente está desconectado.
- Passo 1: Abra a página Sign in.
- Passo 2: Clique no link "Forgot password".
- Passo 3: Digite ana@example.com no campo Email.
- Passo 4: Clique no botão "Send reset link".
- Resultado esperado: A página exibe a mensagem "Check your email".
A versão "depois" tem um comportamento, cinco ações curtas e um resultado visível. Se o seu produto também precisa que o link do e-mail funcione, escreva um segundo caso de teste para esse comportamento. Não amplie o primeiro.
Agora execute o teste e leia o log. Suponha que o agente clicou em "Forgot password" corretamente, mas digitou o endereço em uma caixa de pesquisa. O log mostra o erro, e você reescreve o passo 3 como "Digite ana@example.com no campo Email do formulário de redefinição". A equipe do Cypress recomenda o mesmo hábito para a sua própria ferramenta em linguagem simples: inspecione cada passo gerado e migre para código fixo quando precisar de um teste estável.
Variações: use uma tabela de dados, e não cópias
Muitos casos de teste verificam o mesmo comportamento com valores diferentes. Um formulário de cadastro deve rejeitar um endereço de e-mail sem o caractere @, outro sem domínio e outro com espaços. Não escreva três casos de teste com passos idênticos.
O guia da Automation Panda observa que o Gherkin não tem um passo "Or". Para variações de um mesmo comportamento, ele recomenda um Scenario Outline com uma tabela Examples, e aconselha incluir apenas as variações de que você precisa, porque linhas extras aumentam o tempo de execução. Você pode usar a mesma ideia em inglês simples. Escreva os passos uma vez, com um marcador, como "Digite {email} no campo Email", e adicione uma tabela pequena abaixo.
Exemplo de tabela (fictício): {email} é "ana.example.com" e a mensagem esperada é "Enter a valid email address"; {email} é "ana@" e a mensagem é a mesma; {email} está vazio e a mensagem é "Email is required". Três linhas, um único conjunto de passos, três resultados claros. Se uma linha falhar, o relatório mostra qual valor quebrou a regra.
Checklist de revisão antes de executar
Use esta lista para todo novo caso de teste:
- O título descreve um único comportamento.
- O estado inicial é um estado, não uma lista de cliques de preparação.
- Cada passo começa com um verbo e nomeia um elemento como aparece na tela.
- Todos os valores estão escritos por extenso.
- O resultado esperado pode ser observado e tem texto ou número exato.
- São menos de dez passos.
- Outra pessoa leu o teste.
Erros comuns
- Combinar vários comportamentos em um único caso de teste. Quando ele falha, você não sabe qual parte quebrou.
- Descrever o como em vez do o quê. Dez passos de teclas escondem a intenção. Descreva a ação no nível em que um usuário a realizaria.
- Pular o resultado esperado. Um caso de teste sem verificação pode passar sem provar nada.
- Usar nomes internos. IDs de teste e classes CSS mudam. Use os rótulos que os usuários veem.
- Deixar a IA generativa redigir os testes e aceitá-los sem ler. Um modelo pode inventar passos que o seu produto não tem.
- Deixar os dados por conta do acaso. Se um valor não for definido, o agente escolherá um, e o teste pode não se repetir.
Como o software pode ajudar
Uma planilha compartilhada ou uma página de wiki já basta para começar. Escreva cada teste na forma de cinco partes e revise-o como se fosse código. Se você usa uma ferramenta de gestão de testes, mantenha um teste por registro e vincule-o ao requisito. Uma ferramenta de teste em linguagem natural então lê o mesmo texto. Muitas equipes também mantêm um guia de estilo curto com as regras acima, para que todo novo testador escreva os passos da mesma forma.
Próximo passo
Escolha três critérios de aceitação da sua sprint atual e escreva um caso de teste para cada um, usando as cinco partes. Execute-os na ferramenta de sua preferência para escrever casos de teste em linguagem simples que um agente possa executar, e depois corrija cada passo que o log mostrar como mal interpretado.