AI CodeOps

Motor de políticas (policy engine)

Última actualización

Un motor de políticas evalúa reglas sobre las acciones solicitadas y devuelve permitir o denegar. Cómo funciona la política como código y cómo la usa AI CodeOps para gobernar las sesiones de IA.

Un motor de políticas es un componente que evalúa reglas sobre una acción solicitada y devuelve una decisión, como permitir o denegar, separado del código de la aplicación que realiza la acción. Las reglas («política como código», policy as code) se pueden cambiar, versionar y revisar sin cambiar la aplicación.

Qué es

La aplicación le hace una pregunta al motor: «¿puede este actor realizar esta acción sobre este recurso?». El motor compara la petición con sus reglas y responde. Los buenos motores son deterministas, explican qué regla decidió y tienen un comportamiento por defecto definido para cuando ninguna regla coincide. Algunos admiten también un modo de simulación o de auditoría que registra las decisiones sin aplicarlas.

Por qué importa

Con agentes de IA actuando sobre tu código, la pregunta no es solo quién puede actuar, sino qué puede hacer la automatización por su cuenta. Mantener esas reglas en un único motor significa un único lugar para leerlas, un único lugar para cambiarlas y un único registro de cada decisión. También separa responsabilidades: los equipos de seguridad son dueños de la política y el código del producto solo pregunta.

En AI CodeOps

La política del espacio de trabajo, en Secure → Policies, rige lo que pueden hacer las sesiones de IA. Las reglas son un array JSON; cada una tiene un id, una action, un glob resource opcional y una decision de allow, ask (necesita la aprobación de una persona) o deny. Hay siete acciones:

workflow.dispatch   start a session           (allow, ask, deny)
agent.dispatch      run an agent step         (allow, ask, deny)
mcp.invoke          call an MCP tool          (allow, deny)
shell.command       run the test command      (allow, deny)
diff.apply          change a file             (allow, ask, deny)
github.push         open a pull request       (allow, ask, deny)
release.deploy      deploy automatically      (allow, deny)

Una política que pregunta antes de actualizar dependencias, revisa los cambios de infraestructura, bloquea los despliegues automáticos a producción y mantiene las herramientas de borrado lejos de los agentes:

[
  {
    "id": "approve-dependency-refresh",
    "action": "workflow.dispatch",
    "resource": "dependency-refresh",
    "decision": "ask"
  },
  { "id": "review-infra-changes", "action": "diff.apply", "resource": "infra/**", "decision": "ask" },
  { "id": "no-production-deploys", "action": "release.deploy", "resource": "production", "decision": "deny" },
  { "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }
]

Cómo decide:

  • Se tienen en cuenta todas las reglas activadas cuya acción y cuyo recurso coinciden. Gana la más estricta: deny gana a ask, y ask gana a allow.
  • Cuando ninguna regla coincide, decide el ajuste de confianza (Trust posture): trusted, limited (el predeterminado; abrir un pull request es ask) o none (solo lectura salvo que una regla permita más).
  • Las acciones que no pueden esperar a una persona rechazan ask en el editor; un ask ya guardado en una de ellas se aplica como deny.
  • El modo Log only evalúa y registra sin bloquear.

Cada vez que se guarda se crea una nueva versión y una entrada policy.updated en el registro de auditoría. Las denegaciones, las retenciones y los resultados en modo log-only aparecen en Recent decisions. Editar la política requiere el permiso policy:manage: los roles Owner, Admin y Security Admin.

Preguntas frecuentes

¿Las políticas de AI CodeOps limitan lo que pueden hacer las personas?

No. Las políticas rigen lo que pueden hacer las sesiones de IA. Lo que puede hacer una persona lo fija su rol.

¿Importa el orden de las reglas?

No. Se tienen en cuenta todas las reglas que coinciden y gana la decisión más estricta, así que añadir una regla nunca puede relajar otra.

¿Puedo probar una política sin bloquear a nadie?

Sí. Cambia al modo log-only. Las reglas se siguen evaluando y las decisiones se registran, pero no se bloquea ni se retiene nada.