- Inicio
- Documentación
- Conceptos básicos
Conceptos básicos
Última actualización
Las piezas de AI CodeOps: organizaciones, espacios de trabajo, proyectos, agentes, flujos de trabajo, sesiones, hallazgos, controles, aprobaciones, cambios y despliegues.
Estas son las cosas con las que trabaja AI CodeOps y cómo se conectan. Cada entrada indica dónde encontrarla en la consola.
Organización
La cuenta a la que pertenecen los espacios de trabajo, y la unidad para el plan y los usuarios. Todo el mundo recibe una organización la primera vez que inicia sesión. Gestiónala en Configure → Settings → Organization & Teams.
Espacio de trabajo
Donde trabaja tu equipo: proyectos, sesiones, miembros, roles y ajustes. Cada espacio de trabajo pertenece a una organización. Los espacios de trabajo están separados en la base de datos, así que uno no puede leer los datos de otro. Consulta Miembros y roles.
Proyecto
Una base de código en la que trabaja AI CodeOps, normalmente vinculada a un repositorio Git. Tiene un identificador, un tipo, una rama predeterminada y un comando de pruebas. Cada sesión se ejecuta sobre un proyecto. Encuentra los proyectos en Plan → Projects. Consulta Proyectos.
Agente
Un rol de IA con sus propias instrucciones, como Architect, Builder, Reviewer, Tester o Security Auditor. Cada paso de un flujo de trabajo lo ejecuta un agente. Puedes definir tus propios agentes, con su propio modelo, sus permisos y su prompt, en Configure → Agents. Consulta Agentes y flujos de trabajo y las páginas de los agentes.
Flujo de trabajo
Una lista fija de pasos, cada uno ejecutado por un agente, por ejemplo Plan → Build → Review → Test. Hay 16 flujos de trabajo integrados, listados en Develop → Workflows. Consulta Flujos de trabajo.
Sesión
Una ejecución de un flujo de trabajo sobre una tarea y un proyecto. En la consola es una AI session, en Develop → AI Sessions. Una sesión registra cada paso de agente, sus tokens y su costo, el diff que produjo y su resultado de pruebas.
El estado de una sesión es uno de estos: pending, running, completed, failed, canceled o blocked (por una política o por un presupuesto). Una sesión de seguimiento queda vinculada a la sesión en la que se basa.
Hallazgo
Un problema que la revisión con IA encontró en un cambio. Cada hallazgo tiene:
- una gravedad: critical, high, medium, low o info;
- una categoría, como seguridad, calidad, rendimiento o cobertura de pruebas;
- un estado de triaje: open, acknowledged, in progress, fixed, won't fix, false positive o duplicate.
Los hallazgos abiertos de gravedad high y critical bloquean el cambio. Los hallazgos aparecen en la página de la sesión y en Build & Test → Quality. Consulta Revisiones multiagente.
Control de calidad
La comprobación que decide si un cambio puede entregarse. Un cambio está listo para publicarse cuando su revisión se completó, no queda abierto ningún hallazgo de gravedad high o critical y no falló ninguna prueba. El control se ejecuta antes de que se abra un pull request y antes de que la consola fusione uno. Tu CI puede hacer la misma pregunta mediante el control de publicación. Consulta Controles de calidad y El control de publicación en CI.
Aprobación
Una solicitud para que una persona diga sí o no. AI CodeOps abre una por cada cambio de código que propone una sesión, y por las acciones que tu política marca como ask. Cada una tiene un estado: pending, approved, rejected, expired o canceled. Decídelas en Review & Gate → Approvals. Consulta Aprobaciones y políticas.
Cambio
La unidad de trabajo, de la propuesta a producción. Un cambio vincula la sesión que lo hizo, su aprobación, su pull request, su despliegue y cualquier incidente. Su estado avanza así:
| Estado | Significado |
|---|---|
| proposed | Una sesión empezó a trabajar en él. |
| in review | La sesión produjo código; espera la aprobación. |
| approved | Una persona lo aprobó. |
| merged | Su pull request se fusionó desde la consola. |
| deployed | Un despliegue del cambio tuvo éxito. |
| abandoned | La sesión falló o se canceló. |
Encuentra los cambios en Develop → Changes.
Paquete de evidencias
Un registro firmado de cómo se hizo un cambio: la tarea, los modelos, las aprobaciones, las decisiones de política, los hallazgos, las pruebas y la entrega. Descárgalo desde la página de un cambio y verifícalo en el navegador o sin conexión. Consulta Paquetes de evidencias.
Despliegue
Un registro de que una versión de un proyecto llegó a un entorno. Tiene un estado (queued, in progress, succeeded, failed, rolled back o canceled), un commit o una versión, y la sesión que lo produjo. Encuentra los despliegues en Release → Deployments. Consulta Despliegues controlados.
Siguientes pasos
Preguntas frecuentes
¿Una sesión es lo mismo que un flujo de trabajo?
No. Un flujo de trabajo es la receta, una lista fija de pasos de agentes. Una sesión es una ejecución de un flujo de trabajo sobre una tarea y un proyecto.
¿Dónde encuentro un cambio después de que termine su sesión?
En Develop → Changes. Un cambio sigue el trabajo desde la propuesta, pasando por la revisión y la fusión, hasta el despliegue.
¿AI CodeOps despliega mi código?
No. Llama a un webhook de despliegue que tú configuras y registra el despliegue. El despliegue lo hace tu propio pipeline.