Integrácia s Vercel AI SDK
Na tejto strane
Aktualizované 3. novembra 2026 na základe dokumentácie AI SDK 7 a stránky xAI Multi-agent:
xai()teraz používa Responses API (varovanie z predchádzajúcej verzie už neplatí), Next.js route už nepoužíva odstránenú funkciutoDataStreamResponse()a záložný model cieli nagrok-4.7. Mapovanielow/medium→ 4 agenti,high/xhigh→ 16 agentov pochádza z dokumentácie xAI. Zdroje: AI SDK, xAI provider · xAI, Multi-agent.
Multi-agent v ekosystéme JavaScriptu
Vercel AI SDK (ai) sa stal štandardom pre integráciu modelov umelej inteligencie do webových aplikácií v JavaScripte a TypeScripte. V kombinácii s providerom @ai-sdk/xai ti umožňuje pristupovať k režimu multi-agent modelu Grok priamo z Next.js, SvelteKitu alebo akéhokoľvek iného JavaScriptového frameworku, bez toho, aby si musel opustiť abstrakcie, ktoré tvoj front-end tím už pozná.
Inštalácia
Potrebuješ dva balíčky:
npm install ai @ai-sdk/xai
Rozdeľujú si prácu: @ai-sdk/xai sa stará o komunikáciu s API xAI, zatiaľ čo ai poskytuje všeobecné funkcie generateText a streamText, ktoré používaš bez ohľadu na providera.
Základná konfigurácia
import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "What are the latest JavaScript frameworks of 2026?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
Multi-agent vyžaduje Responses API od xAI. Pri aktuálnych verziách (AI SDK 7 a @ai-sdk/xai 5) je to jediné API, ktoré provider používa: xai(model) ho už využíva automaticky. Zápis xai.responses() túto voľbu explicitne vyjadruje, čo zároveň chráni kód bežiaci proti staršej verzii SDK, kde xai() prechádzalo cez Chat Completions.
Ovládanie počtu agentov
Počet agentov nastavíš pomocou providerOptions.xai.reasoningEffort:
// Odovzdaj ako providerOptions do generateText alebo streamText
const rapide = { xai: { reasoningEffort: "low" } }; // 4 agenti
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 agentov
Mapovanie je rovnaké, aké si videl pri OpenAI SDK: low a medium využívajú 4 agentov, zatiaľ čo high a xhigh využívajú 16 agentov. Získavaš teda tie isté dva režimy, len pod iným názvom parametra.
Streamovanie pomocou streamText
Vo webovej aplikácii sa streamovanie stáva nevyhnutnosťou: beh výskumu s viacerými agentmi môže trvať minútu a nikto nezostane sedieť pred prázdnu obrazovku tak dlho.
import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Analyze AI market trends in Europe",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
V aplikácii Next.js využívajúcej App Router nemusíš stream ani spracovávať na strane servera: API route ho môže vrátiť priamo do prehliadača.
// 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" },
},
});
// Surový textový stream: na klientovi ho čítaj pomocou fetch,
// alebo s useChat a TextStreamChatTransport
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
Hodnota reasoningEffort: "low" v tomto príklade je zámerná voľba: pri route volanej priamo z UI by latenciu 16 agentov bolo ťažké udržať.
Ošetrenie chýb
Keďže multi-agent je v beta verzii, výpadok by nemal spôsobiť nefunkčnú stránku. Nižšie uvedený vzor ukazuje najjednoduchšie záložné riešenie: zachyť chybu a zopakuj tú istú otázku na štandardnom modeli:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "My question",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Multi-agent error:", error);
// Prepnutie na štandardný model
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "My question",
});
return text;
}
Záložné riešenie prepne na štandardný model grok-4.7, ktorý nemá obmedzenia multi-agent režimu (pri AI SDK 7 používa xai() tiež Responses API). Nezabudni používateľa nejako informovať, pretože odpoveď zo záložného modelu bude menej dôkladná, než očakával.
Prípad použitia vo webovej aplikácii
Prípad použitia, ktorý z tejto integrácie vyťaží najviac, je pokročilé rozhranie pre výskum: používateľ položí komplexnú otázku, tvoja aplikácia otvorí stream a odpoveď sa sama vypisuje na obrazovku, zatiaľ čo agenti pokračujú v práci na pozadí.
Výsledná skúsenosť je prekvapivo prirodzená. Text postupuje, niekedy sa zastaví, keď agenti spustia vyhľadávanie na webe, a potom pokračuje. Tieto pauzy nie sú chybou: signalizujú používateľovi, že prebieha skutočný výskum – za predpokladu, že ich tvoje rozhranie spáruje s indikátorom stavu, namiesto toho, aby to vyzeralo ako zaseknutie.
Kľúčové poznatky
- Použi
@ai-sdk/xaisxai.responses()pre multi-agent - Ovládaj počet agentov pomocou
providerOptions.xai.reasoningEffort streamTextje ideálny pre interaktívne webové aplikácie- Vercel AI SDK sa natívne integruje s Next.js a ďalšími frameworkmi
- Naplánuj si záložné riešenie so štandardným modelom pre prípad chyby