Trabajo largo de código
Un trabajo grande de código que se hace solo en segundo plano, con quien planifica, quienes trabajan a la vez y un juez que lo comprueba. Cómo empezarlo, qué ves mientras corre, cómo pararlo o guiarlo y qué gasta.
Un trabajo largo es para lo grande: pasar un proyecto a otra versión, una función que toca muchos archivos, un arreglo grande con pruebas. El agente lo reparte entre varios que trabajan a la vez, en segundo plano, y tú sigues con tu chat. Para un cambio pequeño no hace falta: el agente lo hace directo.
Cómo funciona, en palabras sencillas
- Quien planifica parte el objetivo en tareas que se entienden solas. Si una zona es grande, otro planificador la parte a su vez.
- Quienes trabajan hacen una tarea cada uno, todos a la vez, cada uno en su propia copia del proyecto, sin coordinarse entre sí. Cada tarea terminada se une a la rama del trabajo; si dos chocan, vuelve a quien la hizo para que lo resuelva.
- Las pruebas, si le diste un comando para correrlas, corren antes de cambiar nada y después de cada ronda, y el trabajo nunca acepta menos pruebas que pasen de las que ya pasaban.
- Un juez que no hizo nada del trabajo decide cuando una ronda no deja nada pendiente: terminado, otra ronda con su enfoque, o parar.
- Quien se pasa del tiempo que tenía se detiene y su planificador parte la tarea.
Todos usan el modelo del chat que lo empezó: no hay un modelo aparte para el juez.
Empezar uno
- Abre un chat en tu proyecto. Un trabajo largo empieza desde un chat tuyo, no desde un ayudante ni desde una tarea automática.
- Cuéntale lo que quieres con el resultado que esperas: “pasa este proyecto a la versión nueva y que sigan pasando las pruebas”, “arregla este fallo en todo el proyecto”. Si quieres, dile cómo se corren las pruebas y pídele que lo haga como un trabajo largo.
- El agente decide cómo empezarlo: el objetivo, las condiciones para darlo por terminado y el comando de pruebas. Si el comando de pruebas necesita tu revisión, el trabajo no empieza y el agente te lo dice.
- Con «Escribe en el proyecto» te sale una tarjeta que dice que quiere empezar «una tarea larga que trabaja sola» y muestra el objetivo. Apruébala para que empiece. Con «Acceso completo» no hay tarjeta: tu orden basta. Con «Solo lectura» no empieza, porque cambia archivos; cambia el permiso y vuelve a pedirlo. Mira Permisos, aprobaciones y tus reglas.
Lo que conviene saber antes:
- Parte de lo que ya confirmaste (el último «commit» de tu proyecto). Lo que tienes sin confirmar no entra en el trabajo.
- Con git, trabajan a la vez. Por omisión son 3 a la vez, hasta 10; el agente puede pedir otro número. Si la carpeta no es un proyecto con git, o es la de un Nobreinier, trabaja uno a la vez en esa misma carpeta.
- Tiene límites que puedes cambiar pidiéndolo: 5 rondas por omisión (hasta 50) y 45 minutos por tarea (de 5 a 480).
- Hasta 12 trabajos largos a la vez. Con 12 en marcha, el agente te dice que dejes terminar o detengas uno.
Qué ves mientras corre
Encima de la caja del mensaje, en el chat que lo empezó, aparece una tarjeta con el nombre del trabajo y, a su lado, en qué va, por ejemplo: “Trabajando · ronda 1/5 · 2 de 6 hechas · 3 trabajando · pruebas ✓ 12/12”. La fase dice «Planificando», «Trabajando», «Probando» o «Juzgando».
- Pulsa el nombre (su ayuda dice «Ver el árbol de tareas») y se abre el árbol: cada fila es una tarea con quién la hace («Planificador», «Trabajador» o «Juez») y cómo va («espera», «lista», «trabajando», «hecha», «falló» o «bloqueada»).
- Pulsa una tarea que ya tiene a alguien trabajando en ella y ves lo que hace o hizo.
- Cuando el juez pide otra ronda, la tarjeta lo dice con sus razones: «El juez pidió otra ronda».
- Al terminar, la tarjeta dice «Terminado» o «No terminó», con el nombre de la rama donde quedó lo hecho. Aparece un aviso, «Trabajo largo terminado» o «Trabajo largo detenido», y el chat recibe una nota con las tareas hechas y falladas, las pruebas y cuántos archivos cambió. Breini te cuenta cómo le fue.
- Unos segundos después de terminar, la tarjeta se pliega a su pastilla (mira Un recorrido por la ventana). La tarjeta sigue a mano durante un día.
Guiarlo, pausarlo o detenerlo
Mientras corre, la tarjeta tiene tres botones:
- «Pausar»: lo que trabaja termina su paso y el trabajo espera. «Reanudar» lo sigue.
- «Indicar»: escribe qué debe tener en cuenta (hasta 4000 letras) y pulsa «Enviar». Quienes trabajan en ese momento la leen en su próximo paso, y los siguientes planificadores y el juez también. Sirve para corregir el rumbo sin empezar de nuevo.
- «Detener»: para el trabajo. Lo hecho queda en su rama.
Estos botones son del trabajo, no del chat. Para parar el trabajo usa su «Detener». Si cierras la app, al abrirla el trabajo sigue donde iba: las tareas que estaban a medias retoman su trabajo.
Dónde queda el resultado
En un proyecto con git, el trabajo no toca tus archivos mientras corre: lo hecho queda en una rama aparte de tu proyecto, con nombre que empieza por osiris/job-, en su propia carpeta. Sin git, trabaja en tu misma carpeta. Cuando el trabajo termina, el agente te dice la rama y cómo traerla a tu carpeta. Pídele que la una a tu proyecto cuando la hayas mirado; con «Escribe en el proyecto», unir te lo pregunta. Mira también Revisión de código.
Qué cuesta
- El precio antes de empezar: elige «Trabajo largo» en el menú «+» de la caja del mensaje y termina la frase que escribe. Al asistente se le pide poner el trabajo en una tarjeta con sus pasos y un costo estimado con tu modelo, y desde esa tarjeta el trabajo empieza solo cuando pulsas «Empezar» («Ahora no» la guarda). Si empieza de otra forma, la tarjeta de aprobación muestra el objetivo, no una cifra.
- Cada planificador, trabajador y juez es una conversación con el modelo del chat, así que gasta de la misma cuenta y se ve en tu saldo, como todo lo demás (Tu saldo y la barra de estado).
- Más trabajadores a la vez, más rondas o tareas más largas, más gasto. Si quieres gastar menos, pídele menos trabajadores o menos rondas, o detén el trabajo.
- Un tope de gasto lo incluye.
/budgetcuenta a los ayudantes de la conversación, también los de un trabajo largo (Detener, guiar o encolar).
Si algo falla
- El agente dice que ya hay 12 trabajos largos en marcha: espera a que termine uno o detén uno con su «Detener».
- Dice que el comando de pruebas necesita tu revisión: dale un comando de pruebas sencillo y pídeselo de nuevo.
- «No terminó»: lee las razones del juez en la tarjeta. Lo hecho sigue en su rama; puedes darle una indicación y pedir que siga.
