Cómo escribir un caso de prueba en lenguaje claro que un agente de IA pueda ejecutar
Por Mirko Peters · · Actualizado
Escribe casos de prueba en lenguaje claro que un agente de IA pueda ejecutar: un comportamiento por prueba, una acción por paso, elementos con nombre y un resultado esperado que puedas comprobar.
Traducido automáticamente con IA a partir de la publicación original. Lee el original en inglés
Para escribir casos de prueba en lenguaje claro que un agente de IA pueda ejecutar, limita cada prueba a un solo comportamiento, cada paso a una sola acción y cada comprobación a un único resultado que puedas ver en pantalla. Esta guía está pensada para responsables de QA y testers que quieran pasar de los guiones a instrucciones escritas sin perder fiabilidad en los resultados. Aprenderás las cinco partes de un caso de prueba, las reglas que hacen que un paso sea ejecutable, un método para convertir los criterios de aceptación en pruebas y un ejemplo práctico que puedes copiar.
Puntos clave
- Un caso de prueba en lenguaje claro tiene cinco partes: un título, condiciones previas, pasos, un resultado esperado y los datos de prueba. Un agente de IA necesita que las cinco estén explícitas.
- Escribe un comportamiento por prueba y una acción por paso, porque los fabricantes de herramientas señalan que las instrucciones de un solo paso son las más precisas.
- Nombra cada elemento tal como lo ve el usuario, por ejemplo el botón Iniciar sesión, en lugar de escribir «el botón» o «el campo».
- Define para cada prueba un resultado esperado que se pueda comprobar en pantalla, como un título o un importe, y nunca escribas «comprobar que funciona».
- Revisa lo que genera el agente antes de dar una prueba por superada, y reescribe cualquier paso que haya interpretado de forma distinta a la que pretendías.
Las cinco partes de un caso de prueba en lenguaje claro
Un buen caso de prueba se lee como una historia breve que cualquiera del equipo puede seguir. En el testing de software, escribir casos de prueba eficaces es una habilidad básica de QA, y los testers manuales siempre los han redactado en lenguaje sencillo. Lo nuevo es que ahora un agente de IA puede ejecutar los pasos de la prueba. Esto es especialmente importante en las pruebas de extremo a extremo, en las que una prueba sigue a un usuario a lo largo de un flujo de trabajo completo en el navegador. Para un agente de IA, cada parte debe estar explícita, porque el agente no puede preguntarte qué querías decir.
- Título. Una línea que expresa el comportamiento, por ejemplo "Un cliente puede restablecer una contraseña olvidada". El título es lo primero que ve el lector en un informe.
- Condiciones previas. El estado en el que debe estar el producto antes de empezar la prueba, por ejemplo "Existe una cuenta de cliente y el cliente ha cerrado sesión".
- Pasos. Lo que hace el usuario, una acción por línea.
- Resultado esperado. Lo que el usuario debe ver después, expresado en términos que puedas comprobar en pantalla.
- Datos de prueba. Los valores exactos que se utilizan, como una dirección de correo electrónico o un número de pedido.
Una plantilla común mantiene los casos de prueba de todos los testers con la misma estructura, y una suite con una única plantilla es mucho más fácil de revisar. Además, un caso de prueba necesita una forma de verificar el resultado, y por eso es tan importante el resultado esperado.
Es la misma estructura que utiliza el desarrollo guiado por comportamiento (BDD). En el lenguaje Gherkin, tal como explica Automation Panda, Given establece el estado inicial, When describe la acción que se prueba y Then indica el resultado esperado. No necesitas usar esas palabras clave, pero los tres roles siguen siendo útiles.
Reglas para que un paso sea ejecutable por un agente de IA
Los fabricantes de herramientas publican consejos para redactar instrucciones que un agente de IA pueda seguir. La documentación de BrowserStack para su agente de pruebas en lenguaje natural incluye reglas que se aplican a la mayoría de herramientas:
- Empieza con un verbo de acción. "Haz clic en el botón Enviar" es claro. "El botón de enviar" no es una instrucción.
- Usa una sola intención por comando. Divide las tareas de varios pasos en pasos separados.
- Nombra el elemento concreto. Escribe "el botón Iniciar sesión", no "el botón".
- Desplázate primero cuando el destino esté fuera de la pantalla. Añade un paso antes de la acción.
La misma página indica que la fiabilidad disminuye a medida que los comandos se vuelven más complejos, y que las instrucciones de un solo paso son las más precisas. Añado tres reglas basadas en la experiencia:
- Usa las palabras que aparecen en pantalla. Si el botón dice "Iniciar sesión", no escribas "Acceder".
- Incluye los valores en el paso. Escribe "Escribe ana@example.com en el campo Correo electrónico", no "introduce un correo electrónico válido".
- Evita los pronombres y las palabras vagas. "Eso", "allí", "correctamente" y "bien" ocultan una decisión que el agente tendrá que adivinar.
Cómo escribir casos de prueba en lenguaje sencillo, paso a paso
Sigue este método para convertir un requisito en un caso de prueba.
- Parte de un único criterio de aceptación. Toma una sola frase de la historia de usuario, por ejemplo "Un cliente que olvida su contraseña puede establecer una nueva por correo electrónico".
- Elige un comportamiento. Cada caso de prueba comprueba un solo comportamiento. La guía de Automation Panda sobre cómo escribir buenos escenarios Gherkin lo expresa como "Un escenario, un comportamiento" y señala que un escenario con varios pares When-Then debe dividirse.
- Describe el estado inicial. Descríbelo como un estado, no como acciones de preparación. "Existe una cuenta de cliente" es mejor que diez pasos que crean una.
- Escribe las acciones del usuario. Cada acción ocupa una línea corta con un verbo y un elemento con nombre.
- Escribe el resultado esperado. Indica qué aparece: un título, un mensaje o un valor. Usa el texto exacto.
- Añade los datos. Incluye los valores en los pasos o en una tabla pequeña debajo de la prueba.
- Léelo en voz alta. Si un compañero nuevo no pudiera ejecutarlo a mano, el agente también tendrá dificultades.
La misma guía recomienda mantener los escenarios breves, con menos de diez pasos. Un caso de prueba largo suele ser varios casos de prueba unidos. Las variaciones de un mismo comportamiento, como tres contraseñas no válidas, deben ir en una tabla de datos, no en tres copias de los mismos pasos.
Ejemplo: una prueba de restablecimiento de contraseña, antes y después
Los detalles son ficticios.
Antes (demasiado vago). "Comprueba que el restablecimiento de contraseña funciona." El agente no tiene estado inicial, acciones ni resultado que verificar. Podría pasar la prueba por el motivo equivocado.
Después (ejecutable).
- Título: Un cliente puede solicitar un enlace para restablecer su contraseña.
- Precondición: Existe una cuenta de cliente para ana@example.com, y el cliente ha cerrado sesión.
- Paso 1: Abre la página Iniciar sesión.
- Paso 2: Haz clic en el enlace "¿Olvidaste la contraseña?".
- Paso 3: Escribe ana@example.com en el campo Correo electrónico.
- Paso 4: Haz clic en el botón "Enviar enlace de restablecimiento".
- Resultado esperado: La página muestra el mensaje "Revisa tu correo electrónico".
La versión "después" tiene un solo comportamiento, cinco acciones breves y un resultado visible. Si tu producto también necesita que el enlace del correo funcione, escribe un segundo caso de prueba para ese comportamiento. No amplíes el primero.
Ahora ejecútala y revisa el registro. Supongamos que el agente hizo clic correctamente en "¿Olvidaste la contraseña?", pero escribió la dirección en un cuadro de búsqueda. El registro muestra el error, y reescribes el paso 3 como "Escribe ana@example.com en el campo Correo electrónico del formulario de restablecimiento". El equipo de Cypress recomienda el mismo hábito para su propia herramienta en lenguaje sencillo: revisa cada paso generado y pasa a código fijo cuando necesites una prueba estable.
Variaciones: usa una tabla de datos, no copias
Muchos casos de prueba comprueban el mismo comportamiento con valores diferentes. Un formulario de registro debe rechazar una dirección de correo sin el signo @, otra sin dominio y otra con espacios. No escribas tres casos de prueba con pasos idénticos.
La guía de Automation Panda señala que Gherkin no tiene un paso "Or". Para las variaciones de un mismo comportamiento, recomienda un Scenario Outline con una tabla Examples, y aconseja incluir solo las variaciones que necesites, porque las filas adicionales aumentan el tiempo de ejecución. Puedes aplicar la misma idea en inglés sencillo. Escribe los pasos una sola vez con un marcador de posición, como "Type {email} into the Email field" (Escribe {email} en el campo Email), y añade una tabla pequeña debajo.
Tabla de ejemplo, inventada: {email} es "ana.example.com" y el mensaje esperado es "Enter a valid email address"; {email} es "ana@" y el mensaje es el mismo; {email} está vacío y el mensaje es "Email is required". Tres filas, un solo conjunto de pasos y tres resultados claros. Si una fila falla, el informe muestra qué valor incumplió la regla.
Lista de comprobación antes de ejecutar
Usa esta lista para cada caso de prueba nuevo:
- El título describe un solo comportamiento.
- El estado inicial es un estado, no una lista de clics de preparación.
- Cada paso empieza con un verbo y nombra un elemento tal como aparece en la pantalla.
- Todos los valores están escritos explícitamente.
- El resultado esperado se puede observar y tiene un texto o un número exactos.
- Tiene menos de diez pasos.
- Otra persona ha leído la prueba.
Errores comunes
- Combinar varios comportamientos en un solo caso de prueba. Cuando falla, no sabes qué parte se rompió.
- Describir el cómo en lugar del qué. Diez pasos de pulsaciones de teclas ocultan la intención. Indica la acción al nivel en que la haría un usuario.
- Omitir el resultado esperado. Un caso de prueba sin comprobación puede pasar sin demostrar nada.
- Usar nombres internos. Los identificadores de prueba y las clases CSS cambian. Usa las etiquetas que ven los usuarios.
- Dejar que la IA generativa redacte las pruebas y aceptarlas sin revisarlas. Un modelo puede inventar pasos que tu producto no tiene.
- Dejar los datos al azar. Si un valor no está indicado, el agente elegirá uno, y es posible que la prueba no se pueda repetir.
Cómo puede ayudar el software
Una hoja de cálculo compartida o una página de wiki basta para empezar. Escribe cada prueba en la forma de cinco partes y revísala como si fuera código. Si usas una herramienta de gestión de pruebas, guarda una prueba por registro y vincúlala al requisito. Una herramienta de pruebas en lenguaje natural puede entonces leer el mismo texto. Muchos equipos también mantienen una guía de estilo breve con las reglas anteriores, para que cada nuevo probador escriba los pasos de la misma manera.
Siguiente paso
Toma tres criterios de aceptación de tu sprint actual y escribe un caso de prueba para cada uno, usando las cinco partes. Ejecútalos en la herramienta que prefieras para escribir casos de prueba en inglés sencillo que un agente pueda ejecutar, y luego corrige cada paso que el registro muestre como mal interpretado.