Comhtháthú leis an Vercel AI SDK
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026, bunaithe ar dhoiciméadú AI SDK 7 agus ar leathanach Ilghníomhaire xAI: úsáideann
xai()anois an API Freagraí (ní bhaineann an rabhadh ón leagan roimhe seo a thuilleadh), ní úsáideann an bealach Next.js an fheidhm bhaintetoDataStreamResponse()a thuilleadh, agus díreoidh an cúltaca argrok-4.7. Tagann an mapáillow/medium→ 4 ghníomhaire,high/xhigh→ 16 ngníomhaire ó dhoiciméadú xAI. Foinse: AI SDK, soláthraí xAI · xAI, Ilghníomhaire.
Ilghníomhaireacht san éiceachóras JavaScript
Tá an Vercel AI SDK (ai) ina chaighdeán chun samhlacha AI a chomhtháthú i bhfeidhmchláir ghréasáin JavaScript agus TypeScript. Nuair a chuirtear an soláthraí @ai-sdk/xai leis, tugann sé rochtain duit ar mhód ilghníomhaire Grok ó Next.js, SvelteKit, nó aon fhráma oibre JavaScript eile, gan imeacht ón abstractú atá ar eolas cheana féin ag d’fhoireann front-end.
Suiteáil
Tá dhá phacáiste uait:
npm install ai @ai-sdk/xai
Roinneann siad an obair: déanann @ai-sdk/xai cumarsáid leis an API xAI a láimhseáil, agus soláthraíonn ai na feidhmeanna ginearálta generateText agus streamText a úsáideann tú beag beann ar an soláthraí.
Cumraíocht bhunúsach
import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Cad iad na frámaí oibre JavaScript is déanaí sa bhliain 2026?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
Éilíonn an ilghníomhaireacht API Freagraí xAI. Leis na leaganacha reatha (AI SDK 7 agus @ai-sdk/xai 5), is é seo an t-aon API a úsáideann an soláthraí: téann xai(model) tríd cheana féin. Déanann scríobh xai.responses() an rogha sin follasach, rud a chosnaíonn cód atá ag rith i gcoinne leagan níos sine den SDK áit ar shiúl xai() trí Chat Completions.
Líon na ngníomhairí a rialú
Socraíonn tú líon na ngníomhairí le providerOptions.xai.reasoningEffort:
// Cuir mar providerOptions le generateText nó streamText
const rapide = { xai: { reasoningEffort: "low" } }; // 4 ghníomhaire
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 ghníomhaire
Is é an mapáil céanna é agus a chonaic tú leis an OpenAI SDK: úsáideann low agus medium 4 ghníomhaire, agus úsáideann high agus xhigh 16 ngníomhaire. Mar sin, faigheann tú an dá mhód chéanna faoi ainm paraiméadair difriúil.
Sruthú le streamText
I bhfeidhmchlár gréasáin, éiríonn an sruthú éigeantach: is féidir le reatha taighde ilghníomhaire nóiméad a ghlacadh, agus ní fhanfaidh aon duine os comhair scáileáin fholaimh chomh fada sin.
import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Déan anailís ar threochtaí margaidh AI san Eoraip",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
I bhfeidhmchlár Next.js a úsáideann an App Router, ní gá duit an sruth a úsáid ar an bhfreastalaí fiú: is féidir le bealach API é a thabhairt ar ais go díreach chuig an mbrabhsálaí.
// 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" },
},
});
// Sruth téacs amh: ar an gcliant, léigh é le fetch,
// nó le useChat agus TextStreamChatTransport
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
Is rogha dheaibhí é reasoningEffort: "low" sa sampla seo: ar bhealach a ghlaotar go díreach ón UI, bheadh sé deacair moill 16 ngníomhaire a choinneáil suas.
Láimhseáil earráidí
Toisc go bhfuil an ilghníomhaireacht i mbéite, níor chóir go dtiocfadh briseadh amach as asbhaint. Taispeánann an patrún thíos an cúltaca is simplí: gabh an earráid agus athsheinn an cheist chéanna ar shamhail chaighdeánach:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Mo cheist",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Earráid ilghníomhaire:", error);
// Fill ar shamhail chaighdeánach
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "Mo cheist",
});
return text;
}
Aistríonn an cúltaca go samhail chaighdeánach, grok-4.7, nach bhfuil faoi shrianta na hilghníomhaireachta (le AI SDK 7, úsáideann xai() an API Freagraí freisin). Cuir in iúl don úsáideoir ar bhealach éigin freisin, toisc go mbeidh an freagra cúltaca níos lú cuimsitheach ná an ceann a bhí ag súil leis.
Cás úsáide i bhfeidhmchlár gréasáin
Is é an comhéadan taighde ardleibhéil an cás úsáide a bhaineann an leas is fearr as an gcomhtháthú seo: iarrann an t-úsáideoir ceist chasta, osclaíonn d’fheidhmchlár an sruth, agus scríobhann an freagra é féin ar an scáileán agus na gníomhairí fós ag obair sa chúlra.
Tá an taithí a thagann as iontach nádúrtha. Téann an téacs ar aghaidh, stopann sé uaireanta nuair a sheolann na gníomhairí cuardach gréasáin, agus ansin tosaíonn sé arís. Ní locht ar bith iad na stadanna seo: insíonn siad don úsáideoir go bhfuil fíorthaighde ar siúl – ar choinníoll go gcuireann do chomhéadan táscaire leo seachas cuma a chur orthu go bhfuil an córas bacaithe.
Príomhphointí
- Úsáid
@ai-sdk/xailexai.responses()don ilghníomhaireacht - Rialaigh líon na ngníomhairí le
providerOptions.xai.reasoningEffort - Tá
streamTextidéalach d’fheidhmchláir ghréasáin idirghníomhacha - Comhtháthaíonn an Vercel AI SDK go dúchasach le Next.js agus le frámaí oibre eile
- Pleanáil cúltaca go samhail chaighdeánach i gcás earráide