Integracija z Vercel AI SDK
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi dokumentacije AI SDK 7 in strani xAI Multi-agent:
xai()zdaj uporablja Responses API (opozorilo iz prejšnje različice ne velja več), usmerjevalnik Next.js ne uporablja več odstranjene funkcijetoDataStreamResponse(), nadomestni model pa cilja nagrok-4.7. Preslikavalow/medium→ 4 agenti,high/xhigh→ 16 agentov izvira iz dokumentacije xAI. Viri: AI SDK, ponudnik xAI · xAI, Multi-agent.
Večagentni sistemi v ekosistemu JavaScript
Vercel AI SDK (ai) je postal standard za integracijo modelov umetne inteligence v spletne aplikacije JavaScript in TypeScript. V povezavi s ponudnikom @ai-sdk/xai vam omogoča dostop do večagentnega načina Grok iz okolij Next.js, SvelteKit ali katerega koli drugega ogrodja JavaScript, ne da bi morali zapustiti abstrakcije, ki jih vaša ekipa za front-end že pozna.
Namestitev
Potrebujete dva paketa:
npm install ai @ai-sdk/xai
Delo si razdelita: @ai-sdk/xai upravlja komunikacijo z API-jem xAI, medtem ko ai zagotavlja splošni funkciji generateText in streamText, ki ju uporabljate ne glede na ponudnika.
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: "Kateri so najnovejši ogrodji JavaScript leta 2026?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
Večagentni način zahteva API Responses od xAI. Pri trenutnih različicah (AI SDK 7 in @ai-sdk/xai 5) je to edini API, ki ga ponudnik uporablja: xai(model) že poteka skozenj. Zapis xai.responses() to izbiro naredi eksplicitno, kar hkrati ščiti kodo, ki teče proti starejši različici SDK, kjer je xai() potekal skozi Chat Completions.
Nadzor števila agentov
Število agentov nastavite z providerOptions.xai.reasoningEffort:
// Posredujte kot providerOptions funkcijama generateText ali streamText
const rapide = { xai: { reasoningEffort: "low" } }; // 4 agenti
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 agentov
Preslikava je enaka kot pri SDK OpenAI: low in medium uporabita 4 agente, medtem ko high in xhigh uporabita 16 agentov. Tako dobite ista dva načina pod drugim imenom parametra.
Pretakanje s streamText
V spletni aplikaciji je pretakanje obvezno: raziskovalni zagon z več agenti lahko traja minuto, nihče pa ne bo tako dolgo strmel v prazen 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 trende trga AI v Evropi",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
V aplikaciji Next.js z uporabo App Routerja vam stream-a na strežniku sploh ni treba porabiti: pot API ga lahko vrne neposredno brskalniku.
// 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 besedilni stream: na odjemalcu ga preberite s fetch,
// ali z useChat in TextStreamChatTransport
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
reasoningEffort: "low" v tem primeru je namerna izbira: pri poti, ki jo kliče neposredno uporabniški vmesnik, bi bilo latenco 16 agentov težko vzdrževati.
Obravnava napak
Ker je večagentni način v beta različici, izpad ne sme povzročiti pokvarjene strani. Spodnji vzorec prikazuje najpreprostejši nadomestni načrt: ujemi napako in ponovno zaženi isto vprašanje na standardnem modelu:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Moje vprašanje",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Napaka večagentnega sistema:", error);
// Preklop na standardni model
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "Moje vprašanje",
});
return text;
}
Nadomestni načrt preklopi na standardni model grok-4.7, ki nima omejitev večagentnega sistema (pri AI SDK 7 tudi xai() uporablja API Responses). Uporabnika na nek način obvestite, saj bo nadomestni odgovor manj izčrpen od pričakovanega.
Primer uporabe v spletni aplikaciji
Primer uporabe, ki iz te integracije izvleče največ, je napreden raziskovalni vmesnik: uporabnik zastavi kompleksno vprašanje, vaša aplikacija odpre stream in odgovor se samodejno izpiše na zaslon, medtem ko agenti nadaljujejo z delom v ozadju.
Dobljena izkušnja je presenetljivo naravna. Besedilo napreduje, včasih zastane, ko agenti sprožijo spletno iskanje, nato pa se nadaljuje. Ti zastoji niso napaka: uporabniku sporočajo, da poteka pravo raziskovanje – pod pogojem, da jih vaš vmesnik poveže z indikatorjem, namesto da bi videti kot zagozditev.
Ključne ugotovitve
- Uporabite
@ai-sdk/xaizxai.responses()za večagentni način - Število agentov nadzorujte z
providerOptions.xai.reasoningEffort streamTextje idealen za interaktivne spletne aplikacije- Vercel AI SDK se izvorno integrira z Next.js in drugimi ogrodji
- Načrtujte preklop na standardni model v primeru napake