Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Integráció a Vercel AI SDK-val

7. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Többügynökes rendszerek a JavaScript ökoszisztémában
  2. Telepítés
  3. Alapkonfiguráció
  4. Az ügynökök számának szabályozása
  5. Streamelés a streamText segítségével
  6. Hibakezelés
  7. Használati eset webes alkalmazásban
  8. Főbb megállapítások

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ított toDataStreamResponse() függvényt, és a tartalék megoldás a grok-4.7 modellt célozza meg. A low/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/xai csomagot az xai.responses() hívással a többügynökes módhoz
  • Szabályozd az ügynökök számát a providerOptions.xai.reasoningEffort paraméterrel
  • A streamText ideá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