Agente Builder
El agente Builder describe los cambios exactos de código que pide una tarea, archivo por archivo. Está en seis flujos de trabajo integrados, antes de que la pasada de código escriba el diff real.
El agente Builder implementa. A partir de un plan, describe los cambios de código exactos que hay que hacer: archivo por archivo, con el código clave o pseudocódigo, y por qué. También anota lo que necesite un seguimiento.
Dónde se ejecuta
| Flujo de trabajo | Paso |
|---|---|
| Plan, Build, Review & Test | Build |
| Security-Sensitive Change | Implement |
| UI Implementation | Implement |
| Incident Response | Mitigation |
| Performance Tuning | Apply |
| Quality-Gated Change | Build |
Entradas
- La tarea de la sesión.
- Una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto, o nada cuando el proyecto empieza desde cero.
- Los pasos anteriores. En la mayoría de los flujos de trabajo es un plan del Architect o del UI Designer. En Security-Sensitive Change incluye también el análisis de riesgos del Security Auditor. En Quality-Gated Change, el Builder se ejecuta primero y trabaja solo a partir de la tarea.
Salidas
El paso del Builder devuelve texto: los cambios por archivo y el razonamiento que hay detrás. Es una de las entradas de lo que viene después.
En todos los flujos de trabajo en los que se ejecuta, el paso del Builder es el último antes de que se escriba el código. Justo después, la sesión ejecuta una pasada de código. Esa pasada lee la tarea, el código y el trabajo del equipo hasta ese momento (incluida la descripción del Builder) y devuelve el contenido nuevo completo de cada archivo que cambia. La plataforma escribe esos archivos en un clon desechable y obtiene un diff de git real. Ese diff es lo que revisas, aquello contra lo que se ejecutan las pruebas del proyecto y lo que llega como pull request después de la aprobación.
Los pasos que vienen después del Builder, como Review y Test, se ejecutan cuando el código ya está escrito y las pruebas ya se han ejecutado. Se les muestra ese diff y el resultado de pruebas registrado, no solo la descripción del Builder.
Ejemplo de ejecución
Ejemplo ilustrativo, no una sesión registrada. En Incident Response, el Incident Responder ha hecho el triaje de un pico de errores 500 en el checkout, y el Architect lo ha atribuido a un código de moneda nulo de un proveedor de pagos. El paso Mitigation del Builder propone una protección en el adaptador de pagos que recurre a la moneda del pedido, una línea de log cuando se use esa alternativa y una nota de seguimiento para corregir bien el mapeo del proveedor. La pasada de código lo convierte en un diff de dos archivos y las pruebas del proyecto se ejecutan sobre él. Después, el paso Verify del Tester lee el diff y el resultado de las pruebas.
Límites
- No ejecuta comandos, no compila código ni ejecuta pruebas. Las pruebas se ejecutan después, en un sandbox, contra el diff.
- Lo que describe y lo que escribe la pasada de código pueden ser distintos. Revisa el diff, no la descripción.
- La pasada de código lee una cantidad fija de lo que escribieron los pasos anteriores. Cuando esos pasos son largos, el último de ellos puede quedar recortado en lo que ve.
- Un cambio demasiado grande para revisarlo termina la sesión con ese motivo. Nunca se recorta en silencio.
- El límite de gasto de tu espacio de trabajo se aplica a toda la sesión. No hay un límite aparte por agente. Consulta control de costos.
Preguntas frecuentes
¿El agente Builder edita mi repositorio directamente?
No. Describe el cambio. Una pasada de código aparte escribe archivos completos en una copia desechable del repositorio y produce un diff, que solo se aplica después del control de publicación y de la aprobación.
¿Qué modelo usa el Builder?
El modelo de la sesión. Con el nivel Auto, su paso va primero al nivel Economy, y la pasada de código que escribe los archivos va primero al nivel Standard.