Integración con el Vercel AI SDK
En esta página
Actualizado el 3 de noviembre de 2026, basándose en la documentación del AI SDK 7 y en la página Multi-agent de xAI:
xai()utiliza ahora la API de Responses (la advertencia de la versión anterior ya no aplica), la ruta de Next.js ya no emplea el método eliminadotoDataStreamResponse(), y la alternativa de respaldo apunta agrok-4.7. La correspondencialow/medium→ 4 agentes,high/xhigh→ 16 agentes proviene de la documentación de xAI. Fuentes: AI SDK, proveedor xAI · xAI, Multi-agent.
Multi-agente en el ecosistema JavaScript
El Vercel AI SDK (ai) se ha convertido en el estándar para integrar modelos de IA en aplicaciones web de JavaScript y TypeScript. Junto con el proveedor @ai-sdk/xai, te permite acceder al modo multi-agente de Grok desde Next.js, SvelteKit o cualquier otro framework de JavaScript, sin salir de las abstracciones que tu equipo de front-end ya conoce.
Instalación
Necesitas dos paquetes:
npm install ai @ai-sdk/xai
Estos dividen el trabajo: @ai-sdk/xai gestiona la comunicación con la API de xAI, mientras que ai proporciona las funciones genéricas generateText y streamText que utilizas independientemente del proveedor.
Configuración básica
import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "¿Cuáles son los últimos frameworks de JavaScript de 2026?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
El modo multi-agente requiere la API de Responses de xAI. Con las versiones actuales (AI SDK 7 y @ai-sdk/xai 5), es la única API que utiliza el proveedor: xai(model) ya pasa por ella. Escribir xai.responses() hace explícita esa elección, lo cual también protege el código que se ejecute contra una versión antigua del SDK donde xai() utilizaba Chat Completions.
Control del número de agentes
Estableces el número de agentes mediante providerOptions.xai.reasoningEffort:
// Pasar como providerOptions a generateText o streamText
const rapide = { xai: { reasoningEffort: "low" } }; // 4 agentes
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 agentes
La correspondencia es la misma que viste con el SDK de OpenAI: low y medium utilizan 4 agentes, mientras que high y xhigh utilizan 16. Así obtienes los mismos dos modos bajo un nombre de parámetro diferente.
Streaming con streamText
En una aplicación web, el streaming se vuelve obligatorio: una ejecución de investigación multi-agente puede tardar un minuto, y nadie permanece frente a una pantalla vacía tanto tiempo.
import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Analiza las tendencias del mercado de IA en Europa",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
En una aplicación Next.js que utiliza App Router, ni siquiera necesitas consumir el flujo en el servidor: una ruta de API puede devolverlo directamente al navegador.
// app/api/research/route.ts
import { xai } from "@ai-sdk/xai";
import { createTextStreamResponse, streamText, toTextStream } from "ai";
export async function POST(req: Request) {
const { query } = await req.json();
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: query,
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
// Flujo de texto sin procesar: en el cliente, léelo con fetch,
// o con useChat y un TextStreamChatTransport
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
La opción reasoningEffort: "low" en este ejemplo es una elección deliberada: en una ruta llamada directamente desde la interfaz de usuario, la latencia de 16 agentes sería difícil de sostener.
Gestión de errores
Dado que el modo multi-agente está en beta, una interrupción no debería convertirse en una página rota. El patrón siguiente muestra la alternativa de respaldo más sencilla: capturar el error y volver a formular la misma pregunta en un modelo estándar:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Mi pregunta",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Error multi-agente:", error);
// Alternativa de respaldo a un modelo estándar
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "Mi pregunta",
});
return text;
}
La alternativa de respaldo cambia a un modelo estándar, grok-4.7, que no tiene las restricciones del modo multi-agente (con AI SDK 7, xai() también utiliza la API de Responses). Informa también a tu usuario de alguna manera, porque la respuesta de respaldo será menos exhaustiva que la que esperaba.
Caso de uso en una aplicación web
El caso de uso que más partido saca a esta integración es la interfaz de investigación avanzada: el usuario plantea una pregunta compleja, tu aplicación abre el flujo y la respuesta se escribe en la pantalla mientras los agentes siguen trabajando en segundo plano.
La experiencia resultante es sorprendentemente natural. El texto avanza, a veces se pausa cuando los agentes lanzan una búsqueda web y luego se reanuda. Estas pausas están lejos de ser un defecto: le indican al usuario que hay una investigación real en curso, siempre que tu interfaz las acompañe con un indicador en lugar de hacer parecer que se ha producido un bloqueo.
Puntos clave
- Utiliza
@ai-sdk/xaiconxai.responses()para el modo multi-agente - Controla el número de agentes con
providerOptions.xai.reasoningEffort streamTextes ideal para aplicaciones web interactivas- El Vercel AI SDK se integra de forma nativa con Next.js y otros frameworks
- Planifica una alternativa de respaldo a un modelo estándar en caso de error