Define el comportamiento deseado, límites, respuestas ante fallos, controles humanos y requisitos de seguridad para los guardrails. Esta referencia fija el límite de adopción, el comportamiento ante fallos y la evidencia observable, dejando los límites específicos del entorno configurables.
Estado del paquete: contexto de referencia listo para revisión humana. El contrato y los escenarios de prueba están completos, pero no se afirma que una implementación adoptante los haya superado.
Decisión
Para Guardrails, adoptar una política de orquestación versionada y un límite explícito de llamada al modelo. Hacer explícita la promesa visible para el usuario, exclusiones, autoridad y respuesta ante fallos, dejando los umbrales medidos como elecciones de adopción. Este paquete es un contrato de referencia: el equipo adoptante debe elegir límites numéricos, proveedores, jurisdicciones y responsables operativos a partir de la evidencia en su propio entorno.
Alcance
- Los actores, entradas, salidas, estados, versiones de política o esquema y resultados visibles externamente descritos por este bloque de requisitos.
- Interfaces primarias y alternativas, trabajo en segundo plano, cachés, integraciones, rutas de soporte y evidencia que puedan ejercer el mismo límite.
- Configuración específica de adopción, despliegue, recuperación y responsabilidades de verificación necesarias para aplicar la referencia de forma segura.
Fuera de este bloque
- Elegir un proveedor universal, marco, jurisdicción, umbral numérico, período de retención u objetivo de nivel de servicio para todos los adoptantes.
- Afirmar que los escenarios empaquetados se han ejecutado contra una implementación descendente o que esta referencia otorga certificación legal, de seguridad o accesibilidad.
Contrato
- Persistir las versiones del prompt, herramienta, recuperación, modelo y política necesarias para reproducir o explicar cada resultado material.
- Validar la salida estructurada antes de cualquier efecto secundario; la salida malformada o incompleta es un error, no una autoridad parcial.
- Separar contenido no confiable del usuario o recuperado de la política del sistema y etiquetar cada elemento del contexto con origen y clase de confianza.
- Limitar tokens, llamadas a herramientas, latencia y gasto por solicitud; cruzar un límite sigue una recuperación nombrada en lugar de continuar sin límites.
- Indicar qué actor recibe qué resultado bajo cada estado material, incluyendo condiciones no disponibles, no autorizadas, vacías y parciales.
- Marcar límites y políticas configurables como elecciones con responsables; no presentar valores de ejemplo como requisitos universales.
- Expresar cada guardrail como un invariante medible con fuente de señal, ventana, umbral, alcance afectado, acción, autoridad, responsable y valor seguro cuando la evaluación no esté disponible.
- Aplicar límites antes de trabajo irreversible, hacer que las anulaciones sean estrechas y temporales, registrar activaciones y bypass, y probar falsos positivos, evasión, recuperación e interacción entre múltiples guardrails.
Guía de implementación
- Revisar el contrato con producto, implementación, operaciones, seguridad y usuarios afectados antes de promoverlo más allá de la revisión.
- Modelar entradas, salidas, actores, estados, invariantes, efectos secundarios y evidencia de Guardrails antes de seleccionar detalles de marco o proveedor.
- Almacenar la versión aplicable del contrato o política de Guardrails con el estado material para que migraciones, reproducción y decisiones de soporte sean atribuibles.
- Introducir la ruta detrás del despliegue controlado, comparar resultados esperados y observados, y mantener una ruta de recuperación probada hasta que la evidencia de adopción esté completa.
Manejo de fallos y salvaguardas
- Fallo del proveedor, salida insegura o presupuesto agotado devuelve una recuperación limitada y retiene evidencia diagnóstica segura para correlación.
- Estado inválido o contradictorio de Guardrails es rechazado o puesto en cuarentena; la implementación nunca adivina un valor que amplíe autoridad o duplique un efecto.
- Los reintentos están limitados y usan identidad duradera; tras agotarse, el trabajo alcanza un estado terminal inspeccionable con un responsable accountable.
Verificación y operaciones
- Mapear cada promesa y exclusión a al menos un escenario observable y confirmar que no haya dos estados que requieran resultados contradictorios.
- Monitorear éxito, denegación, fallo de validación, fallo de dependencia, agotamiento de reintentos y recuperación de Guardrails por versión de contrato sin dimensiones sensibles de carga útil.
- Reejecutar fixtures positivos y negativos emparejados tras cambios en política, esquema, dependencia, migración o límite y preservar la evidencia resultante.
Suposiciones de adopción
- Nombres y valores en el ejemplo son un fixture concreto, no valores predeterminados universales; los adoptantes los reemplazan mediante evidencia documentada y propiedad.
- El sistema adoptante puede proporcionar identidad autenticada, versiones duraderas de operación o registro, telemetría limitada y una ruta controlada para cambios.
Los ejemplos con apariencia ejecutable en este paquete son fixtures y contratos de aceptación. Ejecute el validador de colección para verificar estructura y metadatos, luego traduzca y ejecute los escenarios en el repositorio destino antes de registrar evidencia de implementación.
Referencias
- NIST AI 600-1, Perfil de IA Generativa (aplica a partir del 2026-09-08)