Integrazzjoni mal-Vercel AI SDK
F'din il-paġna
Aġġornat fit-3 ta’ Novembru, 2026, ibbażat fuq id-dokumentazzjoni tal-AI SDK 7 u l-paġna Multi-agent ta’ xAI:
xai()issa tuża r-Responses API (it-twissija mill-verżjoni preċedenti ma tapplikax aktar), ir-route ta’ Next.js ma tużax il-funzjoni mneħħijatoDataStreamResponse(), u l-fallback jimmira lejngrok-4.7. Il-mappaturalow/medium→ 4 aġenti,high/xhigh→ 16-il aġent tiġi mid-dokumentazzjoni ta’ xAI. Sorsi: AI SDK, xAI provider · xAI, Multi-agent.
Multi-agent fl-ekosistema JavaScript
Il-Vercel AI SDK (ai) sar standard għall-integrazzjoni ta’ mudelli tal-AI f’applikazzjonijiet web JavaScript u TypeScript. Meta tingħaqad mal-provider @ai-sdk/xai, tagħtik aċċess għall-modalità multi-agent ta’ Grok minn Next.js, SvelteKit, jew kwalunkwe qafas JavaScript ieħor, mingħajr ma toħroġ mill-astrazzjonijiet li t-tim tal-front-end tiegħek diġà jaf.
Installazzjoni
Għandek bżonn żewġ pakketti:
npm install ai @ai-sdk/xai
Huma jaqsmu x-xogħol: @ai-sdk/xai jimmaniġġja l-komunikazzjoni mal-API ta’ xAI, filwaqt li ai jipprovdi l-funzjonijiet ġeneriċi generateText u streamText li tuża irrispettivament mill-provider.
Konfigurazzjoni bażika
import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "X'inhu l-aħħar frameworks JavaScript tal-2026?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
Il-multi-agent jeħtieġ ir-Responses API ta’ xAI. Bil-verżjonijiet attwali (AI SDK 7 u @ai-sdk/xai 5), din hija l-unika API li l-provider juża: xai(model) diġà tgħaddi minnha. Il-kitba ta’ xai.responses() tagħmel dik il-għażla espliċita, li tipproteġi wkoll il-kodiċi li qed jiġi eżegwit kontra verżjoni eqdem tal-SDK fejn xai() kienet tgħaddi mill-Chat Completions.
Kontroll tan-numru ta’ aġenti
Tistabbilixxi n-numru ta’ aġenti b’providerOptions.xai.reasoningEffort:
// Għaddiha bħala providerOptions lil generateText jew streamText
const rapide = { xai: { reasoningEffort: "low" } }; // 4 aġenti
const approfondie = { xai: { reasoningEffort: "high" } }; // 16-il aġent
Il-mappatura hija l-istess waħda li rajt mas-SDK ta’ OpenAI: low u medium jużaw 4 aġenti, filwaqt li high u xhigh jużaw 16-il aġent. Allura tikseb l-istess żewġ modalitajiet taħt isem ta’ parametru differenti.
Streaming b’streamText
F’applikazzjoni web, l-istreaming isir obbligatorju: sessjoni ta’ riċerka multi-agent tista’ tieħu minuta, u ħadd ma jibqa’ quddiem skrin vojt daqshekk.
import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Analizza x-xejriet tas-suq tal-AI fl-Ewropa",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
F’applikazzjoni Next.js li tuża l-App Router, m’għandekx għalfejn tikkonsma l-istreaming fuq is-server: route tal-API tista’ tirritornah direttament lill-browser.
// 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" },
},
});
// Raw text stream: fuq il-klijent, aqrah b'fetch,
// jew b'useChat u TextStreamChatTransport
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
Ir-reasoningEffort: "low" f’dan l-eżempju huwa għażla deliberata: fuq route msejjaħ direttament mill-UI, il-latency ta’ 16-il aġent tkun diffiċli biex tinżamm.
Ġestjoni tal-iżbalji
Peress li l-multi-agent qiegħed fil-beta, ħsara fis-servizz m’għandhiex issir paġna miksura. Il-mudell hawn taħt juri l-aktar fallback sempliċi: qbad l-iżball u erġa’ għamel l-istess mistoqsija fuq mudell standard:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Il-mistoqsija tiegħi",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Żball multi-agent:", error);
// Mur lura għal mudell standard
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "Il-mistoqsija tiegħi",
});
return text;
}
Il-fallback ibiddel għal mudell standard, grok-4.7, li m’għandux il-limitazzjonijiet tal-multi-agent (mal-AI SDK 7, xai() tuża wkoll ir-Responses API). Ħalli lill-utent tiegħek jaf b’xi mod ukoll, għax it-tweġiba tal-fallback tkun inqas dettaljata minn dik li kien jistenna.
Każ ta’ użu f’applikazzjoni web
Il-każ ta’ użu li joħroġ l-aħjar minn din l-integrazzjoni huwa l-interfaċċa avvanzata tar-riċerka: l-utent jagħmel mistoqsija kumplessa, l-applikazzjoni tiegħek tiftaħ l-istreaming, u t-tweġiba tikteb lilha nnifisha fuq l-iskrin filwaqt li l-aġenti jkomplu jaħdmu fl-isfond.
L-esperjenza li tirriżulta hija sorprendentement naturali. It-test javvanza, kultant jieqaf meta l-aġenti jneddu tfittxija fuq il-web, imbagħad ikompli. Dawn il-waqfiet huma ‘l bogħod milli jkunu difett: jgħidu lill-utent li qed issir riċerka reali—sakemm l-interfaċċa tiegħek tgħaqqadhom ma’ indikatur minflok ma tagħmilhom jidhru bħala tfixkil.
Punti Ewlenin
- Uża
@ai-sdk/xaima’xai.responses()għall-multi-agent - Ikkontrolla n-numru ta’ aġenti b’
providerOptions.xai.reasoningEffort streamTexthuwa ideali għal applikazzjonijiet web interattivi- Il-Vercel AI SDK jintegra nativament ma’ Next.js u qafas oħra
- Ippjana fallback għal mudell standard fil-każ ta’ żball