# Sesiones

> Lanza una sesión de IA en AI CodeOps: describe la tarea, elige un proyecto y un flujo de trabajo, mira a los agentes trabajar en tiempo real, revisa el diff y abre un pull request.

Fuente: https://aicodeops.dev/es/docs/sessions

Una sesión es una pieza de trabajo de IA en un proyecto. Describes una tarea; un equipo de agentes la planifica y escribe el cambio, tus pruebas se ejecutan sobre él, y después los agentes revisan lo que se escribió. Luego tú revisas el resultado y decides si se entrega. Todo se ejecuta en la plataforma; tú lo sigues en el navegador.

## Lanzar una sesión

1. Abre **Develop → AI Sessions** y elige **New session**.
2. Rellena el formulario **Start an AI session** (los campos están más abajo).
3. Elige **Start session**. La sesión queda en cola y aparece en la lista.

Los campos del formulario:

- **What should the session do?** Describe la tarea con palabras sencillas, por ejemplo «Añade límite de peticiones a la API pública y escribe pruebas para ello».
- **Workflow:** cómo deben trabajar los agentes. El flujo por defecto, **Plan, Build, Review & Test**, sirve para la mayoría de los cambios. Consulta [Agentes y flujos de trabajo](https://aicodeops.dev/es/docs/agents).
- **Project:** obligatorio. El código generado por IA siempre pertenece a un [proyecto](https://aicodeops.dev/es/docs/projects).
- **Model tier** o **Model:** qué modelos usar. Consulta [Modelos y niveles](https://aicodeops.dev/es/docs/models).
- **File context (optional):** rutas separadas por comas que los agentes deben leer primero.

También puedes lanzar una desde la página de un proyecto con **Run workflow**.

### Qué tamaño puede tener un cambio

El cambio de una sesión tiene que ser lo bastante pequeño para que una persona lo revise:

- su diff puede ocupar hasta 60 KB;
- puede cambiar hasta 25 archivos, cada uno de hasta 64 KB.

Un cambio mayor se rechaza entero, nunca se recorta: la sesión termina con "The change is too large to review" e indica los archivos en los que está la mayor parte del tamaño. Divide la tarea en otras más pequeñas.

Una sesión reescribe por completo cada archivo que cambia, y de un archivo largo solo se le muestra el principio. Una reescritura que eliminaría líneas que nunca vio no se escribe: se le dan esos archivos completos y lo intenta una vez más, y si el resultado sigue eliminándolas, la sesión termina con el motivo. En ese caso pide un cambio más acotado, o indica la parte del archivo que hay que cambiar.

## Seguirla en tiempo real

La página de la sesión se actualiza mientras se ejecuta. Ves cada paso (qué agente, qué está haciendo, su estado), y el costo y los tokens de la sesión a medida que se acumulan. La lista de **AI Sessions** muestra cada sesión con su proyecto, su duración, su costo y su estado, y distintivos para las sesiones que produjeron cambios o hallazgos.

Para detener una sesión, elige **Cancel session** e indica un motivo. El motivo se guarda en la sesión y se muestra en su página.

## Revisar el resultado

Cuando la sesión termina, su página muestra:

- **Summary:** lo que hicieron los agentes, con las palabras del último paso. Cuando el flujo de trabajo tiene pasos posteriores al código, como Review y Test, se escribe después de que se ejecutaran tus pruebas. Si lo que dice sobre las pruebas contradice el resultado registrado, un aviso encima lo indica.
- **Proposed changes:** el diff, con una descarga `.patch`. Si tu petición nombraba archivos y el cambio dejó algunos sin tocar, una nota los lista.
- **Quality gates:** los resultados de las pruebas y si el cambio está listo para publicarse. Consulta [Controles de calidad](https://aicodeops.dev/es/docs/quality-gates).
- **Findings:** los problemas que encontró la revisión, con su gravedad y su archivo.

Toda sesión que escribe código aparece también en **Develop → Changes**, donde puedes seguirla desde la propuesta, pasando por la revisión y la fusión, hasta el despliegue.

## Pedir cambios

Usa el cuadro **Follow-up prompt** de la página de la sesión para pedir ajustes o una tarea siguiente que se base en esta. Elige **Send follow-up**; continúa a partir del contexto de la sesión. La página de la sesión de seguimiento muestra la **Task** original y, debajo, **Latest request (follow-up N)**. Mientras una sesión sigue en ejecución, un seguimiento lanza una sesión nueva y vinculada; la que está en ejecución continúa sin cambios.

**Re-run** lanza la misma tarea otra vez desde el principio.

## Aprobar y abrir un pull request

Una sesión que cambia código abre una revisión en **Review & Gate → Approvals**. En la página de la sesión, elige **Accept changes** o **Reject**. La persona que lanzó la sesión no puede aprobarla si otra persona del espacio de trabajo puede hacerlo. Consulta [Aprobaciones y políticas](https://aicodeops.dev/es/docs/approvals-and-policies).

Cuando el cambio está aprobado y supera sus controles de calidad, AI CodeOps abre el pull request por ti: una rama nueva `codeops/run-<id>` en el repositorio del proyecto, hacia su rama predeterminada. También puedes elegir **Create Pull Request** tú mismo. Si está bloqueado, el botón explica qué falta, por ejemplo **Connect git to open PR** o **Add a repository to open PR**.

Nada se fusiona sin tu aprobación.

## Terminal

**Develop → Terminal** (beta) abre una shell en la raíz de un proyecto, en su propio sandbox aislado, para cuando quieras echar un vistazo o ejecutar un comando tú mismo. Los comandos nunca se ejecutan en los servidores propios de la plataforma. La disponibilidad depende de tu plan.

## Siguientes pasos

- [Agentes y flujos de trabajo](https://aicodeops.dev/es/docs/agents)
- [Controles de calidad](https://aicodeops.dev/es/docs/quality-gates)
- [Control de costos](https://aicodeops.dev/es/docs/cost-controls)

## Preguntas frecuentes

### ¿Tengo que instalar algo para ejecutar una sesión?

No. Las sesiones se ejecutan en la nube y las sigues en el navegador. No hay CLI ni configuración local.

### ¿Puedo cambiar el resultado de una sesión antes de aprobarlo?

Puedes pedir cambios con un prompt de seguimiento. Editar el cambio después de que se aprobara restablece su aprobación, así que hay que aprobarlo de nuevo.
