Antes de empezar
Esta guía usa el ejemplo de Twitter, twitter-starter, para crear una funcionalidad: compartir un emoji gigante con texto debajo. Describirás lo que quieres directamente al agent, seguirás su trabajo y revisarás el resultado final. Puedes usar el mismo flujo de trabajo para otra funcionalidad o para un error que quieras corregir.
- Instala Panolayer, inicia sesión y abre el ejemplo Twitter Clone. Consulta Instalar y configurar Panolayer si aún no has abierto un repository.
- Usa Panolayer Agent, que viene integrado. También puedes usar cualquier otro agent compatible, que debes instalar antes de usarlo. Consulta Agents compatibles para la configuración.
Terminarás con un cambio revisado registrado en tu historial local de Git. Subirlo a un remoto es un paso aparte.
Iniciar Panolayer Agent
- Abre Mis agents en la barra lateral.
- Haz clic en el botón + junto a Monitorizar agents para abrir el menú de agents.
- Selecciona Panolayer Agent para este tutorial.
El menú incluye Panolayer Agent y los agents que hayas instalado. Puedes elegir cualquiera de ellos para corregir un error o crear código.
Panolayer Agent funciona como los agents de programación que ya usas. Pídele que cree una funcionalidad, corrija un error o responda a una pregunta sobre tu código. Escribe tu solicitud en Chatea con tu base de código o crea algo… y continúa la conversación mientras trabajas.
¿Partes de una incidencia? En Incidencias, elige Corregir y selecciona Panolayer Agent. Panolayer traslada el contexto de la incidencia a la tarea. Sigue el tutorial del primer error para esa ruta.
Dale una tarea con un resultado claro
Describe qué va mal o qué quieres crear, qué debería ocurrir cuando funcione y cualquier cosa que el agent deba conservar. Indica un archivo o una función cuando lo sepas.
Para el ejemplo de Twitter, usa la misma petición que se muestra en la captura de pantalla:
añade una nueva función con la que puedas compartir un emoji gigante con texto debajo
Introduce tu petición en el cuadro de mensaje y haz clic en la flecha de envío.
Panolayer Agent puede usar el mapa de código para encontrar las funciones y relaciones relevantes mientras trabaja. Puedes referirte al comportamiento que te interesa aunque no conozcas todos los nombres de archivo.
Si el agent hace una pregunta, respóndela en la misma conversación. Si necesitas acotar la tarea, indica el resultado específico que quieres.
Sigue el trabajo sin renunciar a tu espacio de trabajo
Cuando Panolayer Agent inicia una ejecución de código, su progreso aparece en la conversación. El trabajo de programación se realiza en un worktree de Git aislado: una copia de trabajo separada donde el agent puede editar y probar el código mientras tu espacio de trabajo principal sigue disponible.
Sigue la tarea en la conversación
La tarjeta de ejecución muestra la tarea y su actividad actual mientras el agent crea la funcionalidad de emoji gigante. Puedes seguir su progreso y ver los archivos y comandos que está usando mientras trabaja.
Abre la ejecución para ver más detalles
Elige Abrir en el lado derecho de la tarjeta para ver la actividad de la ejecución. En Flujo, selecciona una actividad para inspeccionar el comando y su salida en el panel derecho. Usa Volver al agent para regresar a la conversación.
Consulta cuándo se completa la ejecución
Cuando el trabajo termina, la tarjeta se actualiza a Ejecución de subagent completada. El banner Completado resume las comprobaciones y el número de archivos modificados. Todavía puedes elegir Abrir para inspeccionar la ejecución completada.
Puedes seguir trabajando y volver a la ejecución más tarde. Usa Supervisar agents para obtener una visión general cuando tengas más de un agent trabajando. Varios agents pueden trabajar en el mismo repository en worktrees separados; revisa cómo encajan sus cambios antes de fusionarlos.
Mantén un seguimiento vinculado a su tarea. Usa la referencia de ejecución que aparece en tu conversación cuando envíes un seguimiento, para que quede claro a qué tarea te refieres.
Revisa el resultado de la verificación
Revisa el código modificado junto con el resultado de la verificación antes de fusionar. Consulta Revisar cambios y commit para ver la guía completa sobre cómo revisar los cambios de un agent.
Cuando el agent solicite una fusión, lee el resumen de la verificación: Reglas superadas, Ejecuciones de verificación y Archivos modificados. Revisa los fallos nuevos por separado de los problemas que ya existían.
En esta ejecución, el resumen muestra 110 de 121 reglas superadas, 1 ejecución de verificación y 16 archivos modificados. Identifica 11 fallos preexistentes por separado e informa de que no hay fallos nuevos, advertencias ni reglas sin comprobar. Los totales dependerán de tu tarea.
Abre Detalles para investigar más a fondo el resultado. Consulta Entender un resultado de verificación para conocer los campos y estados del resumen.
Comprueba el comportamiento en la aplicación en ejecución cuando la tarea lo requiera. Para este ejemplo, prueba a crear una publicación con un emoji gigante y texto debajo, y luego comprueba que las publicaciones de texto normales siguen funcionando como se espera.
Merge when you’re ready
You decide what moves from the agent’s worktree into your branch. Choose Not now to keep reviewing. Once you’re satisfied with the changes and results, confirm the target branch and choose Merge into main for the Twitter sample.
The Merged into main confirmation shows a commit ID. This workflow records the change in local Git history, so you don’t need to commit that same change again.
Open Changes and find the commit in History. Check for unexpected uncommitted edits. If your repository has a remote and you want to share the commit, use Git → Push.
You’ve given an agent a task, followed its work, reviewed the result, and decided what reaches your branch.