Policy Engine define la política de revisión predeterminada para el workspace. Controla qué tipos de revisión están activos, qué instrucciones adicionales deben orientar el análisis y qué autores deben incluirse o bloquearse.
Usa Consola > Policy Engine para configurar el valor predeterminado del workspace. Usa la configuración del repositorio solo para excepciones.
Quién puede acceder
ElPolicy Engine requiere un admin de workspace (los admins de plataforma también tienen acceso). Los roles son conjuntos de capacidades fijos definidos por Acrity, por lo que este acceso no es configurable por organización.
Cuándo usar
Usa esta pantalla para:- activar o desactivar tiers de revisión en el workspace;
- agregar instrucciones generales de revisión;
- definir bots que pueden ser revisados;
- bloquear autores que no deben generar revisión;
- consultar o rotar la configuración de webhook cuando la pantalla muestre esa opción;
- alinear la política predeterminada antes de conectar muchos repositorios.
Tiers de revisión
| Tier | Uso típico |
|---|---|
Fast | Revisión más directa para cambios comunes, con foco en respuesta rápida. |
Deep | Revisión más completa para cambios que requieren un análisis más cuidadoso. |
No uses tiers como sustituto de reglas de branch. Las branch rules deben quedar en
Consola > Repositorios.Instrucciones adicionales
Las instrucciones adicionales permiten adaptar la revisión a los estándares de la organización. Úsalas para registrar directrices como:- patrones de arquitectura esperados;
- criterios de calidad relevantes para la organización;
- cuidados con pruebas, seguridad o compatibilidad;
- lenguaje esperado en los comentarios;
- decisiones de producto que deben considerarse.
- secretos;
- tokens;
- información confidencial de clientes;
- reglas internas que no deberían aparecer en las salidas de revisión;
- instrucciones demasiado específicas para un único repositorio.
Consola > Repositorios > Detalle > Revisión.
Overrides de prompt de revisores
Cada rol de revisor tiene su propio campo de override de prompt, para que puedas ajustar con precisión cómo un revisor específico analiza los cambios en todo el workspace.| Revisor | Orienta |
|---|---|
| Architect | Estructura, diseño y cómo un cambio encaja en el sistema en general. |
| Spec Validator | Alineación entre el cambio y los requisitos declarados. |
| QA Engineer | Cobertura de pruebas, casos límite y calidad general. |
- acepta hasta 2.000 caracteres;
- muestra si el texto actual es un override del workspace o el predeterminado global;
- ofrece una acción Revertir al global que descarta el override del workspace y restaura el predeterminado global.
Política de autores
La política de autores ayuda a controlar qué cambios deben revisarse.| Campo | Para qué sirve |
|---|---|
| Bots permitidos | Identifica cuentas automatizadas cuyos PRs/MRs pueden revisarse. |
| Autores bloqueados | Impide revisiones para autores específicos. |
Clave o URL de webhook
Algunos workspaces pueden mostrar la configuración de webhook vinculada al flujo de revisión. Cuando la pantalla muestre esta opción:- copia la URL solo al proveedor correcto;
- trata la clave como un secreto;
- rota la clave si se sospecha una exposición;
- actualiza el proveedor después de rotar;
- valida el webhook desde la Consola o el proveedor.
Configurar política predeterminada
Agregar instrucciones
Completa instrucciones adicionales generales que apliquen a la mayoría de los repositorios.
Ajustar prompts de revisores (opcional)
Define un override del workspace para el revisor Architect, Spec Validator o QA Engineer solo cuando sea necesario, y revierte al predeterminado global cuando ya no se requiera.
Relación con la configuración del repositorio
| Nivel | Mejor uso |
|---|---|
| Workspace | Política predeterminada para la mayoría de los repositorios. |
| Repositorio | Excepciones para proyectos con necesidades específicas. |
Buenas prácticas
- Escribe instrucciones cortas, claras y verificables.
- Evita duplicar documentación larga dentro del campo de instrucciones.
- No incluyas secretos ni datos confidenciales.
- Revisa la política después de cambios importantes de proceso.
- Usa las excepciones por repositorio con moderación.
- Revierte los overrides de prompt de revisor al predeterminado global una vez que ya no se necesiten, y mantén la guía duradera en el
ARCHITECTURE.mddel repositorio. - Combina la política de autores con las branch rules para reducir el ruido.
Problemas comunes
| Síntoma | Qué verificar |
|---|---|
| No puedo guardar | Confirma que al menos un tier esté activo y que los campos pasen la validación de la pantalla. |
| Un repositorio no sigue el predeterminado | Verifica si tiene su propia configuración en la pestaña Revisión. |
| Las revisiones tienen mucho ruido | Revisa las instrucciones adicionales, la política de autores y las branch rules de los repositorios. |
| Un revisor se comporta de forma inesperada en todas partes | Verifica si hay un override de prompt del workspace configurado para ese revisor y usa Revertir al global si es necesario. |
| El bot esperado no fue revisado | Confirma que la cuenta esté en bots permitidos y que el evento cumpla las reglas del repositorio. |
| El autor sigue generando revisión | Verifica la grafía, el identificador del proveedor y la configuración del repositorio. |