Vercel AI SDK u l-Integrazzjoni mal-Frontend
F'din il-paġna
Aġġornat fit-3 ta’ Novembru 2026 abbażi tad-dokumentazzjoni tal-AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x):useChatjaħdem ma’DefaultChatTransportusendMessage, il-messaġġi jintwerew permezz ta’parts, ir-rotta tirritornacreateUIMessageStreamResponse,systemisirinstructions, u l-provider@ai-sdk/xai5 ma jappoġġjax aktar il-Chat Completions:xai()juża r-Responses API (kodiċi vverifikat mal-kompilatur TypeScript bl-użu ta’ai7.0.162 u@ai-sdk/xai5.0.38). Il-verżjoni preċedenti kienet tuża l-API tal-AI SDK 4 (input,handleSubmit,isLoading,toDataStreamResponse). Sorsi: AI SDK, Chatbot · AI SDK, xAI provider.
Il-Vercel AI SDK għall-Applikazzjonijiet Web
Il-Vercel AI SDK huwa qafas TypeScript iddisinjat biex jintegra mudelli tal-AI f’applikazzjonijiet web. Jipprovdi hooks ta’ React, utilitajiet ta’ streaming, u astrazzjoni unifikata li tappoġġja nattivament lil xAI/Grok permezz tal-pakkett @ai-sdk/xai.
Jekk qed tibni applikazzjoni Next.js, Nuxt, SvelteKit, jew kwalunkwe applikazzjoni React li teħtieġ turi risposti f’temp reali (streaming), il-Vercel AI SDK jissimplifika x-xogħol b’mod sinifikanti.
Installazzjoni
Installa l-SDK ewlieni u l-provider ta’ xAI:
npm install ai @ai-sdk/xai
Ikkonfigura ċ-ċavetta tal-API tiegħek fil-varjabbli tal-ambjent:
# .env.local
XAI_API_KEY=your-api-key
Naħa tas-Server: Ġenerazzjoni tat-Test
Il-funzjoni generateText hija l-ekwivalenti l-aktar sempliċi ta’ client.chat.create(). Hemm affarijiet waħda li nbidlet, u taffettwa dan il-kors direttament: mill-verżjoni 5 tal-provider @ai-sdk/xai (Settembru 2026), kompatibbli mal-AI SDK 7, il-provider ma jappoġġjax aktar l-endpoint tal-Chat Completions. xai(model) juża r-Responses API, li xAI jirrakkomanda issa. Il-metodu xai.chat(model), li xi gwidi ta’ migrazzjoni għadhom jissemmu, eżista biss fil-verżjoni 4 tal-provider; għal kodiċi li jrid jibqa’ fuq il-Chat Completions, uża l-OpenAI SDK immirat lejn xAI minflok (Lezzjoni 5).
import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";
const { text } = await generateText({
model: xai("grok-4.7"), // xAI Responses API
instructions: "You are a technical assistant.",
prompt: "Explain the concept of containerization.",
});
console.log(text);
Il-provider xai jaqra awtomatikament XAI_API_KEY mill-ambjent; createXai() jippermettilek toħloq istanza b’settinji personalizzati. L-għażla instructions tissostitwixxi system, li għadha aċċettata iżda skaduta fl-AI SDK 7.
Streaming fuq in-Naħa tas-Server
Għall-streaming, uża streamText. Ir-risposta taqra biċċa biċċa minn textStream:
import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";
const result = streamText({
model: xai("grok-4.7"),
instructions: "You are a teaching assistant.",
messages: [
{ role: "user", content: "How does a relational database work?" },
],
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Naħa tal-Klijent: Il-Hook useChat
Il-hook useChat huwa ċ-ċentru tal-attenzjoni fuq il-frontend. Jimmaniġġja l-istorja tal-konversazzjoni, l-istreaming, u l-istat tat-talba; il-qasam tal-input, madankollu, jibqa’ stat sempliċi ta’ React li timmaniġġja int:
"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" ? "You" : "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="Ask your question..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Send
</button>
</form>
</div>
);
}
X’jimmaniġġja useChat Awtomatikament
- Storja tal-messaġġi: Jakkwista l-iskambji; kull messaġġ iġorr
parts(test, sejħiet ta’ għodod…), uri dawn minflok il-qasam antikcontent - Streaming: Juri r-risposta hekk kif tiġi ġġenerata
- Stat tat-talba:
statusikunreadymeta tista’ tintbagħat messaġġ ġdid - Ġestjoni tal-iżbalji: Jinterċetta żbalji tan-netwerk u tal-API
- Kanċellazzjoni:
stop()jinterrompi ġenerazzjoni li għaddejja
Ir-Rotta tal-API Korrispondenti
Il-hook jistenna rotta li tirritorna fluss ta’ messaġġi tal-UI. Hawnhekk hija l-implimentazzjoni b’Next.js App Router, immudellata wara l-eżempju uffiċjali tal-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: "You are a helpful assistant. Respond in English.",
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Żewġ konverżjonijiet jdawru l-iskambju: convertToModelMessages tittrasforma l-messaġġi tal-UI li waslu mill-klijent f’messaġġi tal-mudell, u toUIMessageStream tagħmel l-oppost fuq l-istreaming tar-risposta. Il-metodi toUIMessageStreamResponse() fuq ir-riżultat ta’ streamText għadhom jaħdmu fl-AI SDK 7, iżda huma skaduti; fir-rigward ta’ toDataStreamResponse() antik, dan ma jeżistix aktar.
Punti Ewlenin
- Il-Vercel AI SDK jappoġġja lil xAI/Grok permezz tal-pakkett
@ai-sdk/xai generateTextgħal risposti sinkroni,streamTextgħall-istreaming- Il-hook
useChatjimmaniġġja l-istat sħiħ ta’ konversazzjoni fuq il-klijent createUIMessageStreamResponseutoUIMessageStreamjirritornaw l-istreaming mistenni minnuseChat;toDataStreamResponse()ma jeżistix aktar- Minn
@ai-sdk/xai5, il-provider ma jappoġġjax aktar il-Chat Completions:xai()juża r-Responses API; biex tibqa’ fuq il-Chat Completions, uża l-OpenAI SDK - Il-provider
createXai()jiskopri awtomatikament iċ-ċavetta tal-API fl-ambjent