Integráció a Vercel AI SDK-val
Ezen az oldalon
Frissítve: 2026. november 3., az AI SDK 7 dokumentációja és az xAI Multi-agent oldala alapján: az
xai()most már a Responses API-t használja (az előző verzióból származó figyelmeztetés már nem érvényes), a Next.js útvonal nem használja a már eltávolítotttoDataStreamResponse()függvényt, és a tartalék megoldás agrok-4.7modellt célozza meg. Alow/medium→ 4 ügynök,high/xhigh→ 16 ügynök leképezés az xAI dokumentációjából származik. Források: AI SDK, xAI provider · xAI, Multi-agent.
Többügynökes rendszerek a JavaScript ökoszisztémában
A Vercel AI SDK (ai) szabvánnyá vált az AI modellek JavaScript és TypeScript alapú webes alkalmazásokba történő integrálásában. A @ai-sdk/xai szolgáltatóval párosítva lehetővé teszi, hogy Next.js, SvelteKit vagy bármely más JavaScript keretrendszerből hozzáférj a Grok többügynökes módjához anélkül, hogy el kellene hagynod azokat az absztrakciókat, amelyeket a frontend csapatod már ismer.
Telepítés
Két csomagra van szükséged:
npm install ai @ai-sdk/xai
Ezek megosztják a munkát: az @ai-sdk/xai kezeli a kommunikációt az xAI API-val, míg az ai biztosítja azokat az általános generateText és streamText függvényeket, amelyeket a szolgáltatótól függetlenül használsz.
Alapkonfiguráció
import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Mik a legújabb JavaScript keretrendszerek 2026-ban?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
A többügynökes módhoz az xAI Responses API-ja szükséges. A jelenlegi verziókban (AI SDK 7 és @ai-sdk/xai 5) ez az egyetlen API, amelyet a szolgáltató használ: az xai(model) már ezen keresztül fut. Az xai.responses() explicit módon jelzi ezt a választást, ami védi a kódot akkor is, ha régebbi SDK-verzió ellen fut, ahol az xai() még a Chat Completions API-t használta.
Az ügynökök számának szabályozása
Az ügynökök számát a providerOptions.xai.reasoningEffort paraméterrel állíthatod be:
// providerOptions-ként add át a generateText vagy streamText függvénynek
const rapide = { xai: { reasoningEffort: "low" } }; // 4 ügynök
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 ügynök
A leképezés ugyanaz, mint amit az OpenAI SDK-nál láttál: a low és medium értékek 4 ügynököt használnak, míg a high és xhigh értékek 16-ot. Tehát ugyanazt a két módot kapod meg, csak más paraméternév alatt.
Streamelés a streamText segítségével
Webes alkalmazásokban a streamelés kötelezővé válik: egy többügynökes kutatási futtatás eltarthat egy percig, és senki sem vár ennyi ideig egy üres képernyő előtt.
import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Elemezd az AI piaci trendeket Európában",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Egy App Routert használó Next.js alkalmazásban nem is kell a szerveren fogyasztanod a streamet: egy API útvonal közvetlenül visszaadhatja azt a böngészőnek.
// 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" },
},
});
// Nyers szöveg stream: a kliens oldalon fetch-csel olvasd be,
// vagy használd a useChat hookot egy TextStreamChatTransporttal
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
A példában szereplő reasoningEffort: "low" szándékos választás: egy közvetlenül a felhasználói felületről hívott útvonalon a 16 ügynök késleltetését nehéz lenne fenntartani.
Hibakezelés
Mivel a többügynökes mód még béta verzióban van, egy kimaradásnak nem szabad törött oldalhoz vezetnie. Az alábbi minta mutatja a legegyszerűbb tartalék megoldást: elkapjuk a hibát, és ugyanazt a kérdést újrajátsszuk egy szabványos modellen:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "A kérdésem",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Többügynökes hiba:", error);
// Váltás szabványos modellre
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "A kérdésem",
});
return text;
}
A tartalék megoldás átvált egy szabványos modellre, a grok-4.7-re, amelyre nem vonatkoznak a többügynökes mód korlátai (az AI SDK 7-ben az xai() szintén a Responses API-t használja). Értesítsd valahogy a felhasználót is, mert a tartalék válasz kevésbé lesz alapos, mint amit várt.
Használati eset webes alkalmazásban
Ennek az integrációnak a legtöbbet kihozó használati eset a fejlett kutatási felület: a felhasználó feltett egy összetett kérdést, az alkalmazásod megnyitja a streamet, és a válasz magától íródik ki a képernyőre, miközben az ügynökök a háttérben dolgoznak.
A resulting experience is surprisingly natural. A szöveg halad, néha megáll, amikor az ügynökök webes keresést indítanak, majd folytatódik. Ezek a szünetek korántsem hibák: azt jelzik a felhasználónak, hogy valódi kutatás zajlik – feltéve, hogy a felületed egy indikátorral párosítja őket, ahelyett, hogy leállásnak tűnnének.
Főbb megállapítások
- Használd a
@ai-sdk/xaicsomagot azxai.responses()hívással a többügynökes módhoz - Szabályozd az ügynökök számát a
providerOptions.xai.reasoningEffortparaméterrel - A
streamTextideális interaktív webes alkalmazásokhoz - A Vercel AI SDK natívan integrálódik a Next.js-szel és más keretrendszerekkel
- Tervezz be tartalék megoldást egy szabványos modellre hiba esetén