Journeys para Android Studio

Journeys para Android Studio te permite describir flujos de usuarios de extremo a extremo en lenguaje natural y ejecutarlos directamente con el agente de IA en un dispositivo conectado o emulador. Tu conjunto de instrucciones, llamado recorrido, se convierte en acciones que el agente realiza en tu app. Además, puedes escribir y describir aserción más complejas, que el agente evalúa según lo que ve en el dispositivo.

Un recorrido completado en Android Studio, con el recorrido abierto en el
        editor, la app en un emulador y los resultados del agente en la ventana
        Agent.
Recorridos para Android Studio.

Debido a que el agente analiza qué acciones realizar para cumplir con los objetivos, los recorridos son más resilientes a los cambios sutiles en el diseño o el comportamiento de tu app, lo que genera menos pruebas inestables cuando se ejecutan en diferentes versiones de tu app y diferentes parámetros de configuración del dispositivo.

Puedes escribir y ejecutar recorridos directamente desde Android Studio o desde la línea de comandos con cualquier agente. Cuando ejecutas un recorrido, el agente recorre el flujo, verifica los resultados esperados y genera un informe con capturas de pantalla que muestran si cada paso se aprobó o falló.

Escribe un recorrido

Los recorridos se escriben con XML para organizar la descripción y los pasos del recorrido. Los archivos de recorrido usan la extensión .journey.xml y se almacenan en el directorio src/journeysTest/ del módulo de tu app. Android Studio proporciona un editor visual que facilita la creación y edición de recorridos. No es necesario que realices ningún cambio en tus archivos de compilación para usar los recorridos.

Para crear un recorrido, realiza una de las siguientes acciones:

  • En el panel Project de Android Studio, haz clic con el botón derecho en el módulo de la app para el que quieras escribir un recorrido y selecciona New > Journey File. También puedes seleccionar File > New > Journey File en el menú principal.
  • En la ventana Agent, pídele al agente que cree un recorrido para un flujo de usuarios en tu app. Por ejemplo, "Crea un recorrido que busque un producto, lo agregue al carrito y verifique que el carrito muestre un artículo".

Para editar un recorrido, abre el archivo correspondiente. Puedes usar la vista Code para editar el XML directamente, la vista Design para obtener una experiencia de edición simplificada o la vista Split para ver ambas. También puedes pedirle al agente que actualice un archivo de recorrido existente.

En la vista Diseño, cada fila es un paso de tu recorrido. Escribe una acción que quieras que realice el agente o una aserción que quieras que verifique y, luego, presiona Intro para agregar el siguiente paso.

El editor de recorridos en Android Studio, que muestra el título,
        la descripción y los pasos de un recorrido.
El editor de recorridos en Android Studio.

Sugerencias para escribir recorridos

Aunque el agente es capaz de comprender la mayoría de los pasos escritos en los idiomas admitidos, seguir estas sugerencias para escribir recorridos puede generar resultados más precisos y esperados:

  • Supón que tu app ya está en primer plano: Cuando ejecutas un recorrido, se inicia automáticamente tu app. Los pasos de tu recorrido deben comenzar después de que la app se haya iniciado por completo. Es decir, no es necesario que incluyas "iniciar app" como un paso.
  • Usa un lenguaje inequívoco: Ser preciso minimiza las interpretaciones erróneas y mejora la confiabilidad.
En lugar de Qué hacer
"Seleccionar el botón para descartar" "Presiona 'Descartar'" o solo "Descartar"
"Escribe 'apio'" "Escribe 'apio' en la barra de búsqueda que se encuentra en la parte superior de la pantalla principal".
"Deslizar para descartar" "Desliza el dedo hacia la izquierda para descartar la tarjeta, que ya no debería ser visible".
  • Incluye los criterios de éxito como parte del paso: Esto ayuda al agente a comprender mejor tu intención y aclara cuándo se completa la acción y cuándo puede comenzar la siguiente.
En lugar de Qué hacer
"Selecciona el botón de enviar" "Envía el correo electrónico presionando el botón Enviar. Esto debería cerrar el correo electrónico y volver a la bandeja de entrada".
"Ir al carrito de compras" "Presiona el ícono del carrito de compras para ir a la página correspondiente. Verifica que contenga cero elementos".
"Haz clic en el primer video". "Haz clic en el primer video y espera a que se cargue por completo".
  • Define mejor tu recorrido: Si tu recorrido no se ejecuta como se espera, consulta los resultados para comprender por qué es posible que el agente no haya ejecutado los pasos como esperabas. Usa esta información para proporcionar claridad adicional a tus instrucciones.
  • Desglosa tu recorrido en pasos más específicos: Aunque el agente puede interpretar pasos de varias acciones, a veces, los pasos discretos más detallados pueden mejorar la exactitud y la reproducibilidad del recorrido.

Funcionalidades y limitaciones admitidas

A continuación, se incluye una descripción general de las funciones compatibles cuando se escriben recorridos y las funciones que no son compatibles o que pueden tener un rendimiento inconsistente. Las siguientes listas no son exhaustivas.

Las siguientes acciones son compatibles con los recorridos:

  • Presionar elementos de la IU
  • Mantener presionados los elementos de la IU
  • Escribe para ingresar texto en los campos de texto.
  • Desliza el dedo o desplázate en una dirección determinada para navegar por la IU.

Por el momento, no se admiten las siguientes funciones:

  • Gestos de varios dedos (por ejemplo, pellizcar para hacer zoom): Son interacciones que requieren dos o más puntos de contacto en la pantalla de forma simultánea, como pellizcar para acercar o alejar, o deslizar con dos dedos.

Las siguientes funciones pueden tener un rendimiento inconsistente:

  • Recuento: Realiza un seguimiento preciso de las cantidades, las frecuencias o el progreso.

Las funciones y capacidades mejoran constantemente. Te sugerimos que consultes esta página más adelante para conocer las funciones y capacidades adicionales. Para ayudarnos a mejorar Exploraciones, comparte tus comentarios.

Ejecuta tu recorrido

Ejecutas los recorridos con el agente de IA en la ventana Agente. Cuando ejecutas un recorrido, el agente compila e implementa tu app en un dispositivo, realiza cada paso del recorrido y, luego, informa si se completó correctamente o no.

Un recorrido abierto en el editor mientras el agente lo ejecuta en la ventana de Agent, con la app ejecutándose en un emulador.
Un recorrido que se ejecuta en la ventana de Agent.

Para ejecutar un recorrido, realiza una de las siguientes acciones:

  • Abre el archivo de recorrido y haz clic en Run en la barra de herramientas del editor.
  • En la vista Code o Split, haz clic en Run en el medianil junto a la etiqueta <journey>.
  • En el panel Project, haz clic con el botón derecho en un archivo de recorrido y selecciona Run Journey with Agent. Para ejecutar varios recorridos, selecciona más de un archivo de recorrido o una carpeta que contenga archivos de recorrido y selecciona Ejecutar recorridos con el agente.
  • En la ventana Agente, pídele al agente que ejecute un recorrido.

Android Studio inicia una nueva conversación en la ventana Agent con el agente que seleccionaste por última vez, incluidos otros agentes que hayas conectado en Settings > Tools > AI > Agents.

El agente ejecuta el recorrido en el dispositivo que se selecciona en la barra de herramientas principal. Si no se está ejecutando ningún dispositivo, el agente puede iniciar un emulador por ti. Si ejecutas más de un recorrido o seleccionas más de un dispositivo, el agente muestra un resumen de los resultados cuando se completan las ejecuciones.

Cómo ejecutar un recorrido desde la línea de comandos

Para ejecutar Journeys desde la línea de comandos con cualquier agente, usa la CLI de Android.

Ver resultados

Cuando el agente completa un recorrido, informa si este se aprobó o falló, incluido cualquier paso con errores, en la ventana Agente. También proporciona un vínculo a un informe del recorrido. El informe incluye lo siguiente:

  • Es el resultado general del recorrido.
  • Si cada paso se aprobó o falló
  • Son los comandos que el agente ejecutó en el dispositivo.
  • Los comentarios del agente sobre cada paso.
  • Vínculos a las capturas de pantalla que tomó el agente
Un informe de recorrido que muestra el resultado, los comandos, la captura de pantalla y
        el comentario de cada paso, junto con el resumen del agente en la ventana
        del agente.
Un informe de recorrido, con el resumen del agente en la ventana Agent.

Ejecuta recorridos como paquetes de pruebas del AGP

En Android Studio Rabbit 2 y versiones anteriores, Journeys está disponible como una función de Studio Labs que ejecuta recorridos como paquetes de pruebas del complemento de Android para Gradle (AGP). Para usarla, haz lo siguiente:

  1. Ve a Studio Labs en el menú de configuración y habilita Journeys.
  2. Asegúrate de que tu proyecto use el AGP 9.0.0 o una versión posterior.
  3. En el panel Project, haz clic con el botón derecho en el módulo de la app y selecciona New > Journey Test. Si es la primera vez que agregas recorridos a tu proyecto, Android Studio también agrega compatibilidad con el paquete de pruebas del AGP a tu proyecto.
  4. Abre el archivo del recorrido y, en la vista Design, haz clic en Run Journey. Android Studio crea una configuración de ejecución de prueba de Journeys Test, la ejecuta en el dispositivo seleccionado y muestra los resultados en el panel de resultados de la prueba.

El paquete de pruebas se ejecuta en la variante de compilación que estaba activa cuando creaste el recorrido. Si cambias a una variante de compilación diferente, agrégala a la propiedad targetVariants en el bloque testSuites del archivo build.gradle.kts a nivel del módulo.