Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Integrácia s Vercel AI SDK

Lekcia 7 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Multi-agent v ekosystéme JavaScriptu
  2. Inštalácia
  3. Základná konfigurácia
  4. Ovládanie počtu agentov
  5. Streamovanie pomocou streamText
  6. Ošetrenie chýb
  7. Prípad použitia vo webovej aplikácii
  8. Kľúčové poznatky

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ú funkciu toDataStreamResponse() a záložný model cieli na grok-4.7. Mapovanie low/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/xai s xai.responses() pre multi-agent
  • Ovládaj počet agentov pomocou providerOptions.xai.reasoningEffort
  • streamText je 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