AI CodeOps

Aprobaciones y políticas

Define qué pueden hacer las sesiones de IA con las reglas de política del espacio de trabajo (allow, ask, deny) y cómo funcionan las aprobaciones humanas: quién puede aprobar, caducidad y rechazos.

Las políticas deciden qué puede hacer una sesión de IA por su cuenta y qué necesita a una persona. Las aprobaciones son el lugar donde esa persona dice sí o no. Ambas quedan anotadas en el registro de auditoría y en el paquete de evidencias del cambio.

Política del espacio de trabajo

Abre Secure → Policies. La página muestra si la política está en Enforced o en Log only, el ajuste de confianza, las reglas en vigor, la versión y las decisiones recientes. Los roles Owner, Admin y Security Admin pueden editarla (el permiso policy-manage).

Ajuste de confianza

El ajuste se aplica cuando ninguna regla coincide. Sea cual sea el ajuste, el cambio de código de una sesión sigue necesitando una revisión aprobada antes de que se abra su pull request (consulta Aprobaciones más abajo).

AjusteQué significa
TrustedTodo lo que una regla no restringe está permitido.
Limited (por defecto)Como Trusted, pero abrir un pull request es un ask: necesita antes una revisión aprobada.
NoneLas sesiones pueden seguir escribiendo un cambio propuesto, pero no pueden llamar a herramientas MCP, ejecutar el comando de pruebas, abrir un pull request ni desplegar salvo que una regla lo permita.

Reglas

Cada regla tiene una acción, una decisión (allow, ask o deny) y un patrón de recurso opcional. Gana la regla coincidente más estricta: deny gana a ask, y ask gana a allow.

AcciónEtiquetaRecurso¿Admite ask?
workflow.dispatchStart a sessionflujo de trabajoSí
agent.dispatchRun an agent stepagenteSí
diff.applyChange a fileruta, p. ej. infra/**Sí
github.pushOpen a pull requestpropietario/repositorioSí
mcp.invokeCall an MCP toolservidor/herramientaNo
shell.commandRun the test commandcomandoNo
release.deployDeploy automaticallyentornoNo

Las rutas protegidas son reglas diff.apply con un patrón de archivos. Se comprueban cuando se abre un pull request, con cada archivo que toca el cambio; la sesión escribe el cambio igualmente. Los despliegues automáticos después de una fusión son reglas release.deploy. Una acción que no puede esperar a una persona no puede usar ask; el editor lo rechaza.

Elige Edit rules para cambiar el ajuste y las reglas, y después guarda. Las reglas se editan en un formulario, con una tarjeta por regla, o como JSON en la pestaña Advanced (JSON); los problemas se listan por regla y por campo antes de guardar nada. Cada guardado crea una versión nueva y una entrada de auditoría, y What changed between versions muestra las reglas añadidas, eliminadas y cambiadas entre dos versiones cualesquiera. Consulta la referencia de las reglas de política. Switch to log only sigue evaluando las reglas y registra lo que habrían hecho, sin bloquear nada. Resulta útil mientras ajustas una política nueva.

Aprobaciones

Se abre una solicitud de aprobación por ti cuando:

  • una sesión produce un cambio de código (todo cambio necesita revisión, sea cual sea el ajuste);
  • el inicio de una sesión se encuentra con una regla ask (la sesión espera en estado held hasta que se decide la solicitud);
  • se pide un pull request para un cambio que necesita revisión y todavía no tiene ninguna.

Abre Review & Gate → Approvals. Pending requests lista cada solicitud con cuántas aprobaciones necesita y cuándo caduca. Elige Review the proposed changes para ver el diff, y después Approve (con una nota opcional) o Reject (el motivo es obligatorio). La página de la ejecución tiene la misma decisión como Accept changes y Reject.

El cambio de código de una sesión muestra su comprobación de publicación junto a los botones: listo, o no listo con los motivos (pruebas que fallan, hallazgos abiertos de gravedad alta o crítica). Aprobar un cambio cuya comprobación no está lista pide antes un motivo. El motivo se conserva en el voto, en el registro de auditoría y en el paquete de evidencias. Registra tu aprobación y nada más: el pull request sigue cerrado hasta que la comprobación se supera. Rechazar nunca necesita la comprobación.

Cuando llega la última aprobación, la plataforma intenta abrir el pull request. Si no puede (por la comprobación de publicación, o porque el proveedor de Git rechaza el push), se te dice por qué, y la página de la sesión muestra el mismo motivo.

Quién puede aprobar

Los roles Owner, Admin y Security Admin pueden aprobar por defecto; a un rol personalizado también se le puede dar el permiso. Una solicitud puede además nombrar aprobadores concretos.

La persona que lanzó una sesión no puede aprobar su cambio cuando cualquier otra persona del espacio de trabajo puede hacerlo. Rechazar siempre está permitido. ¿Trabajas en solitario? Un espacio de trabajo con un solo aprobador aprueba sus propios cambios, y el registro de auditoría los marca como autoaprobados.

Un equipo pequeño cuyo otro aprobador está ausente a menudo puede activar Let the person who launched a change approve it en Settings → Change approvals. Está desactivado por defecto, y solo los roles Owner, Admin y Security Admin pueden cambiarlo. Cada aprobación que permite se marca como "Self-approved — allowed by workspace setting" en el cambio, en el registro de auditoría y en el paquete de evidencias.

Reglas de la decisión

  • Una revisión de cambio de código necesita una aprobación, de alguien distinto de la persona que lanzó la sesión (cuando el equipo tiene a otra persona que puede aprobar). Eso la convierte en una regla de dos personas. Las aprobaciones se cuentan por persona distinta, y votar de nuevo sustituye tu voto anterior.
  • Un solo rechazo pone fin a la solicitud como rechazada. No se reabre porque otra persona apruebe.
  • Las revisiones de cambios de código caducan a los 7 días; el inicio retenido de una sesión caduca a los 3 días. Después de la caducidad, usa Request approval again en la página de la ejecución.
  • Editar un cambio después de que se aprobara devuelve su aprobación a pendiente.
  • Aprobar un cambio de código abre su pull request, si el control de calidad también se supera.

Siguientes pasos

Preguntas frecuentes

¿Puedo aprobar un cambio de una sesión que lancé yo?

No si otra persona del espacio de trabajo puede aprobar, salvo que un administrador haya activado "Let the person who launched a change approve it" en Settings. Un espacio de trabajo sin otro aprobador siempre puede aprobar sus propios cambios. En ambos casos la aprobación se marca como autoaprobada (self-approved).

¿Qué pasa cuando una aprobación caduca?

El cambio sigue bloqueado. En la página de la ejecución puedes elegir Request approval again para abrir una revisión nueva.

¿Te resultó útil esta página?