# Cómo funciona AI CodeOps

> Sigue una sesión de la tarea al pull request fusionado: los agentes planifican y desarrollan, tus pruebas se ejecutan en un sandbox, la revisión con IA señala problemas y una persona aprueba.

Fuente: https://aicodeops.dev/es/docs/how-it-works · Última actualización: 2026-10-18

Una sesión lleva una tarea de una frase a un pull request revisado. Esta página sigue una sesión por cada etapa, en el orden en que AI CodeOps las ejecuta.

## 1. Describes la tarea

Abre **Develop → AI Sessions** y elige **New session**. Describe la tarea, elige un **Workflow** y un **Project**, y elige **Start session**. Cada sesión pertenece a un [proyecto](https://aicodeops.dev/es/docs/projects).

Antes de que se ejecute nada, AI CodeOps comprueba dos cosas:

- **Tu presupuesto.** Si el espacio de trabajo ha superado su presupuesto o se ha quedado sin cuota, la sesión no empieza y dice por qué. Consulta [Control de costos](https://aicodeops.dev/es/docs/cost-controls).
- **La política de tu espacio de trabajo.** Una regla deny detiene la sesión. Una regla ask la retiene hasta que alguien la aprueba en **Review & Gate → Approvals**. Consulta [Aprobaciones y políticas](https://aicodeops.dev/es/docs/approvals-and-policies).

Después la sesión queda en cola con el estado **pending** hasta que un worker la recoge.

## 2. Los agentes recorren el flujo de trabajo

Un flujo de trabajo es una lista fija de pasos. Cada paso lo ejecuta un agente, y los pasos se ejecutan uno tras otro. El flujo de trabajo por defecto, **Plan, Build, Review & Test**, tiene cuatro:

1. **Plan**, a cargo del [Architect](https://aicodeops.dev/es/agents/architect).
2. **Build**, a cargo del [Builder](https://aicodeops.dev/es/agents/builder).
3. **Review**, a cargo del [Reviewer](https://aicodeops.dev/es/agents/reviewer).
4. **Test**, a cargo del [Tester](https://aicodeops.dev/es/agents/tester).

Los pasos hasta el que implementa el cambio (aquí, Plan y Build) se ejecutan primero. Los pasos posteriores comprueban el trabajo, así que esperan hasta que el código está escrito y tus pruebas se han ejecutado sobre él (etapa 5).

Cada paso ve la tarea y lo que escribieron los pasos anteriores. El presupuesto se comprueba otra vez antes de cada llamada al modelo. Una sesión que se pasa del presupuesto a medias se detiene con el motivo. Los demás flujos de trabajo se listan en [Flujos de trabajo](https://aicodeops.dev/es/docs/workflows).

## 3. Se escribe el cambio

A continuación AI CodeOps convierte el plan en archivos completos. Los aplica a una copia nueva de tu repositorio y produce un diff. Un proyecto sin repositorio recibe en su lugar una base de código nueva.

Una respuesta que se corta a medias conserva lo que escribió y se le pide el resto: los archivos a los que no había llegado y lo que faltaba del archivo en el que se detuvo. Antes de revisar nada, se comprueba cada archivo: los marcadores de diff sueltos se quitan, y un archivo que no se puede analizar se pide una vez más. Un archivo que sigue sin poder analizarse se registra como un hallazgo de gravedad high.

Un diff de más de 60 KB se rechaza entero: "Split the task into smaller changes." Si no vuelve ningún cambio de archivos utilizable, la sesión falla con el motivo.

## 4. Se ejecutan tus pruebas

AI CodeOps reconstruye el cambio en un sandbox aislado. Instala las dependencias, desconecta el sandbox de la red y ejecuta el comando de pruebas de tu proyecto. El resultado se registra como la ejecución de pruebas de la sesión: superadas, fallidas, omitidas y cobertura.

El comando de pruebas es el que está configurado en el proyecto. Si no hay ninguno, AI CodeOps busca un script test en `package.json`, después pytest y después `go test`. Si las pruebas no se pueden ejecutar en absoluto (no hay comando, o las dependencias no se instalan), no se registra nada y la página de la ejecución muestra que el cambio no se verificó. El [control de publicación](https://aicodeops.dev/es/docs/quality-gates) no lo cuenta como superado: deniega un cambio de código sin resultado de pruebas, salvo que el proyecto tenga activado **Don't run tests for this project**.

## 5. Los pasos restantes comprueban el cambio escrito

Los pasos que siguen al paso de implementación (aquí, Review y Test) se ejecutan ahora. A cada uno se le muestra el cambio tal como se escribió y el resultado de pruebas registrado, y se le indica que cite los archivos que leyó. El resumen de la sesión sale del último de ellos, así que se escribe después de que se ejecutaran las pruebas.

Si uno de estos pasos falla o se queda sin tiempo, la sesión sigue adelante con su cambio: el código está escrito y probado, y el paso se marca como fallido en la página de la sesión.

## 6. Se revisa el diff

Una pasada de revisión lee el diff real, con las notas de los pasos de revisión y de seguridad como contexto. Registra **hallazgos**, cada uno con una gravedad, una categoría y normalmente un archivo. En una sesión de seguimiento, se le indica también qué plantearon las rondas anteriores y qué decidió una persona sobre cada punto. Consulta [Revisiones multiagente](https://aicodeops.dev/es/docs/multi-agent-reviews).

Si esa revisión no puede terminar, el cambio queda retenido: sus hallazgos se desconocen, así que no se puede tratar como limpio.

## 7. El cambio espera a una persona

Cuando la sesión termina con un diff, AI CodeOps:

- marca la sesión como **completed**;
- pasa su cambio a **in review** en **Develop → Changes**;
- abre una solicitud de revisión en **Review & Gate → Approvals**. Caduca a los 7 días.

Abre la página de la sesión para ver el resumen, **Proposed changes**, el panel **Quality gates** y **Findings**.

## 8. Una persona aprueba

Elige **Accept changes** en la página de la sesión, o **Approve** en la página Approvals. La persona que lanzó la sesión no puede aprobarla mientras otra persona del espacio de trabajo pueda hacerlo. Un espacio de trabajo de una sola persona puede aprobar su propio cambio. Un rechazo pone fin a la solicitud.

## 9. Se abre el pull request

La aprobación pone en marcha el pull request. Antes de abrirlo, AI CodeOps comprueba, por este orden:

1. la política del espacio de trabajo;
2. la aprobación;
3. el [control de calidad](https://aicodeops.dev/es/docs/quality-gates): ningún hallazgo abierto de gravedad alta o crítica (high o critical), ninguna prueba fallida y una revisión completada.

Si las tres se superan, AI CodeOps hace push de una rama llamada `codeops/run-<id>` y abre un pull request hacia la rama predeterminada del proyecto. Usa la conexión de Git de la persona que aprobó, así que esta necesita una [cuenta de Git conectada](https://aicodeops.dev/es/docs/git/permissions-and-scopes) para ese proveedor. Si el pull request no se pudo abrir, elige **Create Pull Request** en la página de la sesión. El botón indica qué falta.

## 10. Fusiona y despliega

Fusiona el pull request cuando quieras. Si lo fusionas desde la consola, antes se comprueba otra vez el control de calidad. Si el proyecto tiene un destino de despliegue, AI CodeOps llama entonces a tu webhook de despliegue y registra el despliegue. Consulta [Despliegues controlados](https://aicodeops.dev/es/docs/gated-deploys).

## Límites de tiempo

| Etapa                       | Límite                                             |
| --------------------------- | -------------------------------------------------- |
| Pasos anteriores al código  | 4 minutos en total                                 |
| Escritura del cambio        | 8 minutos                                          |
| Pruebas                     | 6 minutos, más el comando que ya esté en ejecución |
| Pasos posteriores al código | 3 minutos en total                                 |
| Revisión del diff           | 2 minutos                                          |
| Sesión completa             | Se detiene por estar atascada tras unos 30 minutos |

Una sesión que agota el tiempo o se atasca termina como **failed**, con el motivo en su página.

## Siguientes pasos

- [Conceptos básicos](https://aicodeops.dev/es/docs/core-concepts)
- [Sesiones](https://aicodeops.dev/es/docs/sessions)
- [Controles de calidad](https://aicodeops.dev/es/docs/quality-gates)

## Preguntas frecuentes

### ¿Una sesión de IA fusiona código por sí sola?

No. Una persona aprueba cada cambio de código antes de que se abra su pull request, y fusionar es un paso aparte que haces tú.

### ¿Y si mi proyecto no tiene pruebas?

La sesión se ejecuta igualmente, y la página de la ejecución muestra que la verificación se omitió. El control de publicación deniega entonces el cambio, porque un cambio de código sin resultado de pruebas no cuenta como superado. Si el proyecto no tiene suite de pruebas, activa "Don't run tests for this project" en sus ajustes.

### ¿Puedo ver a los agentes mientras trabajan?

Sí. La página de la sesión se actualiza en tiempo real con cada paso, su agente, su estado y los tokens y el costo hasta ese momento.
