Ejecutar una tarea y revisar el resultado

Crear una tarea

Abre la página Tareas de un proyecto, o la pestaña Tareas de la consola de una instancia, y crea una. Le das:

• Un título y una descripción. Qué debe cambiar, en lenguaje natural. El detalle ayuda: la misma petición con dos frases de contexto produce un plan mucho mejor que la petición sola.
• La instancia en la que trabajar. Esto decide qué código base lee el agente y a qué rama se sube el resultado.
• Habilidades y adjuntos, opcionalmente. Las habilidades son las convenciones de tu casa; los adjuntos son archivos que el agente debería tener como contexto, por ejemplo una especificación o una captura del problema.

Crear tareas requiere el permiso de tareas del agente. Si la suscripción del proyecto está sin pagar y el proyecto ha pasado a solo lectura, la creación de tareas se rechaza junto con todas las demás acciones.

Apuntar a la instancia de producción te obliga a escribir confirm al crear la tarea, y desde ese momento la tarea queda registrada como tarea de producción.

Leer el plan

El agente recoge la tarea, lee el código base y devuelve un plan. En este punto todavía no se ha cambiado nada.

Lee el plan entero, no solo su primera línea. Es tu única oportunidad de detectar un malentendido antes de que se escriba código, y el coste de leerlo es mucho menor que el de deshacer después un cambio malo.

Luego elige:

• Aprobar y ejecutar: el agente implementa el plan.
• Solicitar cambios: describe qué está mal y vuelve a planificar, con tus comentarios en la mano.
• Planificar de nuevo: repite la planificación tal cual, útil cuando el primer intento falló en vez de salir mal. Planificar de nuevo con indicaciones hace lo mismo con una nota tuya.
• Cancelar tarea: la detiene.

Aprobar requiere el permiso de aprobación de planes.

A veces el agente marca el plan como bloqueado: ha decidido que no puede hacer el trabajo de forma segura o que la petición no está lo bastante clara. Un plan bloqueado siempre espera a una persona, incluso en un proyecto con la ejecución automática activada.

Qué llega a git

Una vez apruebas, el agente hace el cambio dentro del contenedor de la instancia, crea el commit y lo sube con push a la rama de esa instancia. Ese push vuelve a desplegar la instancia, así que el resultado queda en marcha donde puedes verlo.

No hay pull request. El commit va directo a la rama desde la que se despliega la instancia, y por eso importa qué instancia eliges y por eso producción está protegida detrás de dos confirmaciones.

Si la ejecución termina sin necesidad de cambiar nada, lo dice en lugar de inventarse un commit.

Cuando el resultado no está bien

Usa Iniciar otra ronda en la tarea. Describe qué está mal y el agente planifica un arreglo, partiendo del código que ya subió en lugar de empezar de cero. Apruebas el nuevo plan antes de que se ejecute nada, y el commit existente se queda en la rama.

Las rondas se cuentan en la tarea, así que puedes ver cuántas pasadas costó un trabajo y qué cambió cada una.

Cuando algo va mal

• La instancia no arranca con lo que dejó la ejecución en el commit. CICDoo mueve esos commits a una rama de rescate, resetea la rama de la instancia y vuelve a levantar Odoo. No se sube nada y no se pierde nada: el trabajo está en la rama de rescate si lo quieres.
• El push falla. El trabajo se queda en el árbol de trabajo del contenedor en lugar de desaparecer.
• La ejecución alcanza el límite de uso de tu proveedor. La tarea se pausa y te dice cuándo se restablece el límite. Reanudar continúa con el plan aprobado desde ese punto; es la misma ronda, interrumpida, no una nueva.
• La ejecución deja de reportar. Si un contenedor muere a mitad del trabajo, la tarea se marca como fallida en lugar de quedarse colgada para siempre. Si el agente informa tarde después de eso, el resultado se recoge igualmente.

Vigilar el consumo

La pestaña Consumo de la tarea lista cada ejecución que hay detrás: qué ronda y qué fase, quién la disparó, el resultado, tokens de entrada y de salida, y el tiempo que tardó. La página /agent lo agrega entre proyectos, con gráficos de los últimos 30 días, 90 días o 12 meses.

Los reintentos y los fallos también cuentan. Es deliberado: cuestan tiempo de agente real, y una tarea que necesitó cuatro intentos debería parecerlo.

Siguientes pasos

Para saber cómo se mide y se paga ese tiempo, consulta Tiempo de agente y recargas. Para activar la función y conectar una CLI, consulta Configurar las tareas del agente.

Si te quedas atascado, abre un ticket de soporte desde la página de Tickets o el widget de chat.