¿Por qué JSON en feature flags es importante?
Las feature flags son geniales, pero cuando necesitas probar algo complejo —como la configuración de un modelo de IA— rápidamente terminas con un montón de flags individuales. ai_model, ai_temperature, ai_max_tokens, system_prompt… cada una necesita su propia flag, su propia lógica de rollout y su propio mantenimiento. Es frágil y difícil de mantener.
Vercel acaba de resolver esto. Su producto Flags ahora soporta valores JSON directamente, permitiéndote agrupar configuraciones relacionadas en una sola flag coherente. Esto cambia el juego para equipos que hacen rollouts progresivos, pruebas A/B o experimentos con múltiples variantes.
Para contexto sobre cómo las arquitecturas cloud-native modernas manejan despliegues complejos, checa nuestra guía sobre failover tolerante a fallos en AWS.
¿Cómo funciona?
En lugar de manejar tres flags separadas para un experimento de modelo de IA, defines una sola flag con variantes JSON. Aquí un ejemplo concreto:
// Variante A: Claude Sonnet
{
"id": "claude-sonnet-4-6",
"temperature": 0.7,
"maxTokens": 1024,
"systemPrompt": "Eres un asistente de compras útil."
}
// Variante B: Claude Opus
{
"id": "claude-opus-4-6",
"temperature": 0.8,
"maxTokens": 2048,
"systemPrompt": "Ayudas con compras."
}
En tu código de aplicación, obtienes la flag y usas el objeto JSON directamente. Olvídate de variables de entorno y condicionales para cada parámetro.
// Obtén la flag JSON
const modelConfig = await getFlag('ai_model_config');
// Usa el objeto directamente
const response = await callModel({
modelId: modelConfig.id,
temperature: modelConfig.temperature,
maxTokens: modelConfig.maxTokens,
systemPrompt: modelConfig.systemPrompt
});
Este patrón hace tu código más limpio, reduce la proliferación de flags y te permite gestionar experimentos desde el dashboard de Vercel sin tocar código.
Casos de uso y limitaciones
Dónde brilla:
- Pruebas A/B de configuraciones de modelos de IA (temperatura, prompt, model ID)
- Rollout de variaciones de componentes de UI (color, layout, comportamiento) sin múltiples flags
- Configuraciones multi-región donde cada región necesita parámetros ligeramente diferentes
Limitaciones a considerar:
- Las flags JSON aún están sujetas a la latencia estándar de evaluación de Vercel (típicamente <50ms). Para rutas de latencia ultra baja (ej.: edge middleware), mantén las flags simples.
- El tamaño del payload JSON es limitado — no intentes almacenar archivos de configuración completos. Quédate con unos pocos KB.
- No puedes anidar flags JSON dentro de otras flags; cada flag es un objeto JSON independiente.
Para equipos que ya usan feature flags para seguridad en despliegues, esto es una evolución natural. Pero si todavía usas archivos de configuración manuales o variables de entorno para experimentos, esta es una señal fuerte para modernizar tu enfoque. Si te interesa ver cómo otras empresas manejan estrategias complejas de rollout, nuestro artículo sobre reducción de fallos en despliegues con Temporal ofrece una perspectiva complementaria.
Conclusión
Las Flags de Vercel con soporte JSON es un cambio pequeño con grandes implicaciones. Reduce la sobrecarga de gestión de flags, hace las pruebas A/B más expresivas y se alinea con la tendencia de la industria de configuración-como-código. Pruébalo en tu próximo experimento — tu yo del futuro (y tus colegas) te lo agradecerán.
Siguientes pasos:
- Revisa tus feature flags actuales: ¿alguna se puede agrupar en JSON?
- Empieza con un experimento de bajo riesgo (ej.: variante de UI) para acostumbrarte al patrón.
- Mantente al tanto de la documentación de Vercel para actualizaciones sobre límites de payload y rendimiento.