Cubre fixtures, métricas de recuperación y respuesta, monitoreo, verificaciones de frescura, depuración y recuperación para la transformación de consultas. Establece límites de adopción y evidencia observable de fallos mientras mantiene configurables los límites específicos del entorno.
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 la transformación de consultas, adopte un linaje versionado de fuente, transformación, índice y control de acceso. Trate el bloque como un contrato de lanzamiento y regresión construido a partir de casos representativos positivos, de límite, de denegación, de fallo y de recuperación. Este paquete es un contrato de referencia: el equipo adoptante debe elegir límites numéricos, proveedores, jurisdicciones y responsables operativos basándose en la evidencia de su propio entorno.
Alcance
- Los actores, entradas, salidas, estados, versiones de políticas o esquemas y resultados visibles externamente de la transformación de consultas descritos por este bloque de pruebas.
- Interfaces primarias y alternativas, trabajo en segundo plano, cachés, integraciones, rutas de soporte y evidencia que pueda 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, periodo 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
- Preservar identificador de fuente, versión, ubicación, alcance de acceso, analizador, normalización, fragmento, incrustación y versiones de índice para cada unidad recuperable.
- Aplicar filtros de acceso antes de exponer resultados, fragmentos, conteos, cachés y contexto del modelo; el filtrado posterior no es suficiente.
- Poner en cuarentena fallos de análisis o transformación y evitar que un artefacto parcial reemplace silenciosamente la última versión completa.
- Evaluar el comportamiento de recuperación y respuesta fundamentada en casos representativos versionados, incluyendo conflictos, ausencia, obsolescencia y texto adversarial.
- Registrar versión del fixture, entorno, configuración, resultado observado y ubicación de la evidencia para cada ejecución con decisiones.
- Separar en los informes fallos de producto, fallos de dependencia, fallos de infraestructura de prueba y evidencia inconclusa.
- Definir un mapeo tipado y versionado para campos, operadores, valores, nulos, rangos, fechas, zonas horarias, ordenamiento, paginación y constructos no soportados entre modelos de consulta fuente y destino.
- Validar antes de la ejecución, preservar restricciones de autorización, emitir una forma canónica explicable y rechazar transformaciones con pérdida o ambiguas en lugar de ampliar la consulta silenciosamente.
Guía de implementación
- Construir el conjunto de fixtures determinista más pequeño que abarque clases de riesgo, luego añadir casos derivados de producción solo tras revisión segura para la privacidad.
- Modelar entradas, salidas, actores, estados, invariantes, efectos secundarios y evidencia de la transformación de consultas antes de seleccionar detalles de marco o proveedor.
- Almacenar la versión aplicable del contrato o política de transformación de consultas 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 completar la evidencia de adopción.
Manejo de fallos y salvaguardas
- Si falta la procedencia, alcance de acceso o contenido requerido, excluir la unidad y exponer una brecha de cobertura diagnóstica en lugar de fabricar completitud.
- El estado inválido o contradictorio de la transformación de consultas se rechaza o pone 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 durable; tras agotarse, el trabajo alcanza un estado terminal inspeccionable con un responsable accountable.
Verificación y operaciones
- Ejecutar la suite dos veces desde un estado limpio y confirmar que el orden, reintentos y ejecución paralela no cambian el veredicto.
- Monitorear éxito, denegación, fallo de validación, fallo de dependencia, agotamiento de reintentos y recuperación de la transformación de consultas 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ímites y preservar la evidencia resultante.
Suposiciones de adopción
- Los 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 durables de operación o registro, telemetría limitada y una ruta controlada para el cambio.
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)