Vercel AI SDK: integrar IA y agentes en una aplicación web

Una librería, no una plataforma

El Vercel AI SDK, de la empresa creadora de Next.js, funciona como una caja de herramientas. Su idea central es una API unificada: el mismo código llama a un modelo de OpenAI, Anthropic, Google u otro proveedor, y cambiar de modelo es cambiar una línea. Alrededor de ese núcleo ofrece generación de texto en streaming, salida estructurada validada con un esquema, llamada a herramientas y componentes de interfaz para React, Svelte, Vue o Angular.

Para los agentes de IA, la clase ToolLoopAgent encadena llamadas a herramientas hasta terminar la tarea. La documentación cubre también la memoria, las aprobaciones antes de ejecutar una herramienta, los subagentes y la conexión con servidores MCP para incorporar herramientas externas.

Para quién y cómo empezar

El SDK se dirige a desarrolladores TypeScript, desde el freelance que añade un asistente a la web de un cliente hasta equipos de producto completos. Requiere Node.js 22 o posterior. Se instala el paquete ai con npm y después se elige entre dos caminos: pasar por Vercel AI Gateway con solo el nombre del modelo, o instalar el paquete de un proveedor (por ejemplo @ai-sdk/anthropic) y usar su propia clave API. El sitio ai-sdk.dev reúne guías, ejemplos de chatbots y la referencia completa. También existe un «skill» oficial que puede añadir a un asistente de programación para que conozca la librería.

Ventajas y límites

Ventajas. Gratuito y con licencia Apache 2.0, independiente del proveedor de modelos, muy buena integración del streaming en interfaces web, documentación extensa y versiones frecuentes.

Límites. El SDK no incluye base de datos, panel de control ni motor de workflows duraderos listo para usar: para una aplicación de agentes completa, hay que montar esas piezas uno mismo. El comportamiento por defecto, que envía las llamadas por AI Gateway, puede sorprender, así que compruebe por dónde pasan sus peticiones y quién le factura. Además, la API cambia rápido entre versiones mayores, lo que obliga a migraciones periódicas.

Alternativas

Mastra comparte el enfoque TypeScript pero añade workflows, memoria y evaluaciones en un framework más completo. En Python, el OpenAI Agents SDK y Pydantic AI ocupan un hueco parecido de caja de herramientas ligera. Para estimar cuánto costarán las llamadas a los modelos, pruebe nuestra calculadora de coste de un agente.

Documentación oficial: ai-sdk.dev.