Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Integracija s Vercel AI SDK-jem

Lekcija 7 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Više agenata u JavaScript ekosustavu
  2. Instalacija
  3. Osnovna konfiguracija
  4. Upravljanje brojem agenata
  5. Strujanje podataka s streamText
  6. Rukovanje greškama
  7. Upotreba u web aplikaciji
  8. Ključne točke

Ažurirano 3. studenoga 2026., na temelju dokumentacije AI SDK 7 i xAI-jeve stranice Multi-agent: xai() sada koristi Responses API (upozorenje iz prethodne verzije više se ne primjenjuje), Next.js ruta više ne koristi uklonjenu funkciju toDataStreamResponse(), a rezervna opcija cilja na grok-4.7. Mapiranje low/medium → 4 agenta, high/xhigh → 16 agenata proizlazi iz xAI-jeve dokumentacije. Izvori: AI SDK, xAI provider · xAI, Multi-agent.

Više agenata u JavaScript ekosustavu

Vercel AI SDK (ai) postao je standard za integraciju AI modela u web aplikacije napisane u JavaScriptu i TypeScriptu. U kombinaciji s pružateljem usluga @ai-sdk/xai, dobivaš pristup Grokovom načinu rada s više agenata iz Next.jsa, SvelteKita ili bilo kojeg drugog JavaScript okvira, a da pritom ne moraš napuštati apstrakcije koje tvoj front-end tim već poznaje.

Instalacija

Trebaš dva paketa:

npm install ai @ai-sdk/xai

Oni dijele posao: @ai-sdk/xai rukuje komunikacijom s xAI API-jem, dok ai pruža generičke funkcije generateText i streamText koje koristiš bez obzira na pružatelja usluge.

Osnovna konfiguracija

import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";

const { text } = await generateText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "Koji su najnoviji JavaScript okviri iz 2026.?",
  providerOptions: {
    xai: { reasoningEffort: "low" },
  },
});

console.log(text);

Rad s više agenata zahtijeva xAI-jev Responses API. S trenutnim verzijama (AI SDK 7 i @ai-sdk/xai 5), to je jedini API koji pružatelj usluge koristi: xai(model) već prolazi kroz njega. Pisanje xai.responses() eksplicitno naglašava taj izbor, što također štiti kod koji se pokreće uz stariju verziju SDK-a gdje je xai() išao kroz Chat Completions.

Upravljanje brojem agenata

Broj agenata postavljaš pomoću providerOptions.xai.reasoningEffort:

// Proslijedi kao providerOptions funkcijama generateText ili streamText
const rapide = { xai: { reasoningEffort: "low" } };       // 4 agenta
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 agenata

Mapiranje je isto ono koje si vidio kod OpenAI SDK-ja: low i medium koriste 4 agenta, dok high i xhigh koriste 16. Dakle, dobivaš ista dva načina rada pod drugačijim nazivom parametra.

Strujanje podataka s streamText

U web aplikaciji strujanje podataka postaje obavezno: istraživački zadatak s više agenata može trajati minutu, a nitko neće toliko dugo gledati u prazan zaslon.

import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";

const result = streamText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "Analiziraj trendove na tržištu umjetne inteligencije u Europi",
  providerOptions: {
    xai: { reasoningEffort: "medium" },
  },
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

U Next.js aplikaciji koja koristi App Router, čak ni ne moraš konzumirati stream na poslužitelju: API ruta može ga vratiti izravno pregledniku.

// 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" },
    },
  });

  // Sirovi tekstualni stream: na klijentu ga čitaj s fetch,
  // ili s useChat i TextStreamChatTransportom
  return createTextStreamResponse({
    stream: toTextStream({ stream: result.stream }),
  });
}

Vrijednost reasoningEffort: "low" u ovom primjeru namjeran je izbor: na ruti koju izravno poziva korisničko sučelje, latenciju od 16 agenata bilo bi teško održati.

Rukovanje greškama

Budući da je rad s više agenata u beta fazi, kvar ne smije rezultirati pokvarenom stranicom. Donji uzorak prikazuje najjednostavniju rezervnu opciju: uhvati grešku i ponovno pokreni isto pitanje na standardnom modelu:

try {
  const { text } = await generateText({
    model: xai.responses("grok-4.20-multi-agent-0309"),
    prompt: "Moje pitanje",
    providerOptions: {
      xai: { reasoningEffort: "low" },
    },
  });
  return text;
} catch (error) {
  console.error("Greška više agenata:", error);
  // Prelazak na standardni model
  const { text } = await generateText({
    model: xai("grok-4.7"),
    prompt: "Moje pitanje",
  });
  return text;
}

Rezervna opcija prelazi na standardni model, grok-4.7, koji nema ograničenja svojstvena radu s više agenata (s AI SDK-jem 7, xai() također koristi Responses API). Obavezno na neki način obavijesti korisnika jer će odgovor iz rezervne opcije biti manje temeljit od onoga koji je očekivao.

Upotreba u web aplikaciji

Upotreba koja najviše iskorištava ovu integraciju jest napredno istraživačko sučelje: korisnik postavi složeno pitanje, tvoja aplikacija otvori stream, a odgovor se sam ispisuje na zaslon dok agenti nastavljaju raditi u pozadini.

Rezultirajuće iskustvo iznenađujuće je prirodno. Tekst napreduje, ponekad zastane kada agenti pokrenu pretraživanje weba, a zatim se nastavi. Te pauze nisu mana: one govore korisniku da je stvarno istraživanje u tijeku – pod uvjetom da ih tvoje sučelje upari s indikatorom umjesto da ostave dojam zastoja.

Ključne točke

  • Koristi @ai-sdk/xai s xai.responses() za rad s više agenata
  • Upravljaj brojem agenata pomoću providerOptions.xai.reasoningEffort
  • streamText je idealan za interaktivne web aplikacije
  • Vercel AI SDK integrira se izvorno s Next.jsom i drugim okvirima
  • Planiraj prelazak na standardni model u slučaju greške