Vercel AI SDK agus Comhtháthú Frontend
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x): oibríonnuseChatleDefaultChatTransportagussendMessage, taispeántar teachtaireachtaí tríparts, filleann an rútarcreateUIMessageStreamResponse, éiríonnsysteminainstructions, agus ní thacaíonn an soláthraí@ai-sdk/xai5 le Chat Completions a thuilleadh: úsáideannxai()an Responses API (fíoraíodh an cód le tiomsaitheoir TypeScript ag baint úsáide asai7.0.162 agus@ai-sdk/xai5.0.38). Bhain an leagan roimhe seo úsáid as API AI SDK 4 (input,handleSubmit,isLoading,toDataStreamResponse). Foinse: AI SDK, Chatbot · AI SDK, soláthraí xAI.
Vercel AI SDK do Fheidhmchláir Ghréasáin
Is creatlach TypeScript é Vercel AI SDK atá deartha chun samhlacha AI a chomhtháthú i bhfeidhmchláir ghréasáin. Soláthraíonn sé hookanna React, áiseanna sruthaithe, agus teibíocht aontaithe a thacaíonn go dúchasach le xAI/Grok tríd an bpacáiste @ai-sdk/xai.
Má tá tú ag tógáil feidhmchláir Next.js, Nuxt, SvelteKit, nó aon fheidhmchlár React a bhfuil gá aige le freagairtí sruthaithe a thaispeáint, déanann Vercel AI SDK an obair i bhfad níos simplí.
Suiteáil
Suiteáil an SDK bunúsach agus an soláthraí xAI:
npm install ai @ai-sdk/xai
Cumraigh do eochair API sna hathróga timpeallachta:
# .env.local
XAI_API_KEY=do-eochair-api
Taobh Freastalaí: Téacs a Ghiniúint
Is é an fheidhm generateText an coibhéis is simplí de client.chat.create(). Tá rud amháin athraithe, agus baineann sé go díreach leis an gcúrsa seo: ó leagan 5 den soláthraí @ai-sdk/xai (Meán Fómhair 2026), atá comhoiriúnach le AI SDK 7, ní thacaíonn an soláthraí leis an bpointe deiridh Chat Completions a thuilleadh. Úsáideann xai(model) an Responses API, a mholann xAI anois. Ní raibh an modh xai.chat(model), a luaann roinnt treoracha imirce fós, ann ach i leagan 4 den soláthraí; maidir le cód nach mór a choinneáil ar Chat Completions, úsáid an OpenAI SDK atá dírithe ar xAI ina ionad sin (Ceacht 5).
import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";
const { text } = await generateText({
model: xai("grok-4.7"), // xAI Responses API
instructions: "Is tú cúntóir teicniúil.",
prompt: "Mínigh coincheap na gcoimeádán.",
});
console.log(text);
Léann an soláthraí xai XAI_API_KEY go huathoibríoch ón timpeallacht; ligeann createXai() duit sampla a chruthú le socruithe saincheaptha. Cuireann an rogha instructions in ionad system, a nglactar leis fós ach atá as dáta in AI SDK 7.
Sruthú ar Thaobh an Fhreastalaí
Chun sruthú a dhéanamh, úsáid streamText. Léann an fhreagairt píosa ar phíosa ó textStream:
import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";
const result = streamText({
model: xai("grok-4.7"),
instructions: "Is tú cúntóir teagaisc.",
messages: [
{ role: "user", content: "Conas a oibríonn bunachar sonraí gaolmhar?" },
],
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Taobh an Chliaint: An Hook useChat
Is é an hook useChat an phríomhghné ar an bhfrontend. Déileálann sé le stair na comhráite, leis an sruthú, agus le stát na n-iarratas; fanann an réimse ionchuir, áfach, ina stát React simplí a bhainistíonn tusa féin:
"use client";
import { useChat } from "@ai-sdk/react";
import { DefaultChatTransport } from "ai";
import { useState } from "react";
export default function ChatPage() {
const { messages, sendMessage, status } = useChat({
transport: new DefaultChatTransport({ api: "/api/chat" }),
});
const [input, setInput] = useState("");
return (
<div>
{messages.map((m) => (
<div key={m.id}>
<strong>{m.role === "user" ? "Tusa" : "Grok"}</strong>
{m.parts.map((part, i) =>
part.type === "text" ? <p key={i}>{part.text}</p> : null
)}
</div>
))}
<form
onSubmit={(e) => {
e.preventDefault();
if (input.trim()) {
sendMessage({ text: input });
setInput("");
}
}}
>
<input
value={input}
onChange={(e) => setInput(e.target.value)}
placeholder="Cuir do cheist..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Seol
</button>
</form>
</div>
);
}
Cad a Láimhseálann useChat go Huathoibríoch
- Stair na dteachtaireachtaí: Carnann sé malartuithe; iompraíonn gach teachtaireacht
parts(téacs, glaonna uirlisí…), taispeáin iad seo seachas an seanghallacontent - Sruthú: Taispeánann sé an fhreagairt de réir mar a ghintear í
- Stát an iarratais: Tá
statusmarreadynuair is féidir teachtaireacht nua a sheoladh - Láimhseáil earráidí: Gabhann sé earráidí líonra agus API
- Cealú: Briseann
stop()giniúint atá ar siúl
An Rútar API Comhfhreagrach
Tá súil ag an hook le rútar a fhilleann sruth de theachtaireachtaí UI. Seo an cur i bhfeidhm le Next.js App Router, samhaltaithe ar shampla oifigiúil AI SDK 7:
// app/api/chat/route.ts
import {
convertToModelMessages,
createUIMessageStreamResponse,
streamText,
toUIMessageStream,
type UIMessage,
} from "ai";
import { xai } from "@ai-sdk/xai";
export async function POST(req: Request) {
const { messages }: { messages: UIMessage[] } = await req.json();
const result = streamText({
model: xai("grok-4.7"),
instructions: "Is tú cúntóir cabhrach. Freagair i mBéarla.",
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Cuimsíonn dhá thiontú an malartú: déanann convertToModelMessages teachtaireachtaí UI a fuarthas ón gcliant a thiontú ina dteachtaireachtaí samhaltacha, agus déanann toUIMessageStream an rud céanna ar ais ar an sruth freagartha. Fós oibríonn na modhanna toUIMessageStreamResponse() ar an toradh streamText in AI SDK 7, ach tá siad as dáta; maidir leis an sean toDataStreamResponse(), níl sé ann a thuilleadh.
Príomhphointí
- Tacaíonn Vercel AI SDK le xAI/Grok tríd an bpacáiste
@ai-sdk/xai generateTextle haghaidh freagairtí comhthreomhara,streamTextle haghaidh sruthaithe- Bainistíonn an hook
useChatstát iomlán comhrá ar an gcliant - Filleann
createUIMessageStreamResponseagustoUIMessageStreaman sruth a bhfuil súil aguseChatleis; níltoDataStreamResponse()ann a thuilleadh - Ó
@ai-sdk/xai5, ní thacaíonn an soláthraí le Chat Completions a thuilleadh: úsáideannxai()an Responses API; chun fanacht ar Chat Completions, úsáid an OpenAI SDK - Braitheann an soláthraí
createXai()an eochair API sa timpeallacht go huathoibríoch