Vercel - AI Gateway - modelos de IA - agentes
4 min lectura

Vercel Virtual Models: cambia el modelo de tu agente sin redeploy

Tutorial práctico para crear un alias de modelo en Vercel AI Gateway, evaluar un candidato con los mismos casos, cambiar sin desplegar y revertir si falla.

Vercel Virtual Models: cambia el modelo de tu agente sin redeploy

Tu app resume tickets con un modelo y tu agente de código usa otro. Aparece una opción más barata, pero cambiar un ID en tres repositorios y desplegar de nuevo para probarla es una forma lenta de equivocarse. Los Virtual Models de Vercel AI Gateway, anunciados el 28 de octubre de 2026, ponen un nombre estable delante del modelo real. Puedes apuntar `vmc/soporte` a un candidato y volver al anterior sin tocar el código. La parte importante es probar el cambio antes de mover tráfico real.

La presentación oficial y la documentación indican que el ID virtual también guarda en el gateway opciones de proveedor, fallbacks, cumplimiento y etiquetas de observabilidad. Esto es diferente de la guía de respaldo ante fallos: aquí la decisión es quién controla el modelo activo de una tarea y cómo se cambia con una evaluación, no qué proveedor toma una solicitud fallida.

Un ID de modelo virtual estable dirige la app y el agente al modelo actual; un candidato se evalúa antes del cambio y puede revertirse

Un caso: clasificar tickets sin romper el contrato

Supón una app que clasifica mensajes de soporte en `urgente`, `normal` o `sin_datos`, y redacta una respuesta sugerida. El contrato exige JSON válido, categoría correcta y ninguna respuesta automática cuando faltan datos. Crea dos IDs: `vmc/soporte` para el tráfico actual y `vmc/soporte-candidato` para el nuevo modelo. No cambies el primero mientras averiguas si el candidato conserva el contrato.

En el panel de Vercel, abre Virtual Models, crea el slug y elige un modelo disponible en tu catálogo. La documentación también muestra este patrón de CLI; revisa primero tu equipo con `vercel whoami` y `vercel switch` porque los modelos virtuales pertenecen al scope activo:

vercel ai-gateway virtual-models create soporte --model anthropic/claude-opus-5.5

vercel ai-gateway virtual-models create soporte-candidato --model openai/gpt-6.1-sol

Los IDs y comandos anteriores siguen el ejemplo de Vercel; no los ejecuté en una cuenta SoyJB. Si tu cuenta no tiene esos modelos, usa dos realmente disponibles. El slug no se puede cambiar después de crear el modelo virtual, así que escoge nombres por tarea, no por proveedor. Así el nombre `vmc/soporte` sigue teniendo sentido cuando cambie el modelo.

Conecta la app y compara el mismo caso

En AI SDK, el ID virtual ocupa el lugar donde normalmente va el nombre del modelo. La app necesita autenticación de AI Gateway configurada según tu entorno; no incluyas claves en el código ni en el artículo:

import { generateText } from 'ai';

const result = await generateText({
  model: 'vmc/soporte',
  prompt: 'Clasifica este ticket: no puedo abrir mi cuenta',
});
console.log(result.text);

Para evaluar, ejecuta los mismos 20 tickets anonimizados contra `vmc/soporte` y `vmc/soporte-candidato`. Incluye mensajes ambiguos y casos que deben escalar a una persona. Anota porcentaje de JSON válido, aciertos de categoría revisados por un humano, falsos negativos urgentes, latencia y costo por ticket resuelto. No selecciones el candidato solo por precio por token. Si la salida alimenta acciones automáticas, verifica también que la estructura y el comportamiento con herramientas sean compatibles.

Cuando el candidato pase un umbral escrito antes de la prueba, cambia el modelo detrás del ID estable desde el panel o con el comando documentado:

vercel ai-gateway virtual-models edit soporte --model openai/gpt-6.1-sol

Vercel dice que las nuevas solicitudes adoptan la configuración en unos minutos, sin redeploy. Vigila las métricas del ID virtual y compara resultados en la misma ventana de tráfico. Si empeoran, apunta `vmc/soporte` al modelo anterior. Ese rollback de configuración no revierte respuestas ya enviadas: por eso conviene un despliegue gradual en la lógica de tu producto si la tarea tiene consecuencias para clientes.

Dos límites que cambian la decisión

Las opciones del modelo virtual tienen precedencia sobre opciones equivalentes de cada solicitud. Esto es útil para imponer rutas aprobadas o retención cero, pero puede sorprender a una app que creía controlar fallbacks desde su código. Las opciones específicas de Anthropic tampoco pasan mágicamente a OpenAI al cambiar de proveedor; revisa la configuración guardada y vuelve a probar herramientas, formatos y seguridad. Los roles del equipo determinan quién puede modificar el alias: da ese permiso solo a quienes controlan el experimento.

La prueba local de hoy puede ser diseñar el conjunto de 20 tickets y el criterio de aceptación. No ejecuté aquí el CLI ni un benchmark con modelos pagados; por eso no afirmo que una alternativa sea más rápida o barata para tu app. El beneficio verificable del producto es separar el ID que usa tu código del modelo concreto que eliges en el gateway. El beneficio de negocio solo aparece si tu evaluación muestra que el cambio conserva calidad y reduce costo o fricción.

Fuentes

Vercel, anuncio del 28 de octubre de 2026; Vercel Docs: Virtual Models. Revisado el 10 de noviembre de 2026.

Recibe lo nuevo en tu correo

Workshops gratis, herramientas y novedades de IA aplicadas a negocio, sin humo.

🎓 Workshops en vivo🛠️ Herramientas nuevas⚡ Novedades de IA

Sin spam. Te das de baja cuando quieras.

Comentarios

Aún no hay comentarios. Sé el primero.

Deja un comentario