Vercel AI SDK ja kasutajaliidese integreerimine
Sellel lehel
Uuendatud 3. novembril 2026 vastavalt AI SDK 7 dokumentatsioonile (
ai7.0.x,@ai-sdk/react4.x):useChattöötab koosDefaultChatTransportjasendMessage-ga, sõnumeid kuvataksepartskaudu, ruut tagastabcreateUIMessageStreamResponse,systemasendubinstructions-ga ning@ai-sdk/xai5 pakkuja ei toeta enam Chat Completionsi:xai()kasutab Responses API-t (kood on kontrollitud TypeScripti kompilaatoriga, kasutadesai7.0.162 ja@ai-sdk/xai5.0.38). Eelmine versioon kasutas AI SDK 4 API-t (input,handleSubmit,isLoading,toDataStreamResponse). Allikad: AI SDK, Chatbot · AI SDK, xAI pakkuja.
Vercel AI SDK veebirakendustele
Vercel AI SDK on TypeScripti raamistik, mis on loodud tehisintellekti mudelite veebirakendustesse integreerimiseks. See pakub Reacti konksu (hooks), voogedastusvahendeid ja ühtset abstraktsiooni, mis toob kaasa xAI/Groki toe paketi @ai-sdk/xai kaudu.
Kui ehitate Next.js, Nuxt, SvelteKit või mõnda muud Reacti rakendust, mis peab kuvama voogedastatavaid vastuseid, lihtsustab Vercel AI SDK tööd oluliselt.
Paigaldamine
Paigaldage põhiline SDK ja xAI pakkuja:
npm install ai @ai-sdk/xai
Seadistage oma API-võti keskkonnamuutujates:
# .env.local
XAI_API_KEY=your-api-key
Serveripoolne: teksti genereerimine
Funktsioon generateText on lihtsaim vaste client.chat.create()-le. Üks asi on muutunud ja see puudutab otseselt seda kursust: alates @ai-sdk/xai pakkuja 5. versioonist (september 2026), mis ühildub AI SDK 7-ga, ei toeta pakkuja enam Chat Completionsi lõpp-punkti. xai(model) kasutab Responses API-t, mida xAI nüüd soovitab. Meetod xai.chat(model), mida mõned migratsioonijuhendid endiselt mainivad, eksisteeris ainult pakkuja 4. versioonis; koodi jaoks, mis peab jääma Chat Completionsi juurde, kasutage selle asemel xAI-le suunatud OpenAI SDK-d (Õppetund 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);
xai pakkuja loeb XAI_API_KEY automaatselt keskkonnast; createXai() võimaldab luua instantsi kohandatud seadetega. Valik instructions asendab system-i, mida AI SDK 7-s endiselt aktsepteeritakse, kuid mida peetakse iganenuks.
Serveripoolne voogedastus
Voogedastuseks kasutage streamText. Vastust loetakse textStream-ist tükkhaaval:
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);
}
Kliendipoolne: useChat konks
Konks useChat on kasutajaliideses keskne element. See haldab vestluse ajalugu, voogedastust ja päringu olekut; sisendväli on aga lihtne Reacti olek, mida haldad ise:
"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>
);
}
Mida useChat automaatselt haldab
- Sõnumite ajalugu: Kogub vahetusi; iga sõnum kannab
parts(tekst, tööriista väljakutsed jne), kuva neid vanacontentvälja asemel. - Voogedastus: Kuvab vastuse selle genereerimise käigus.
- Päringu olek:
statusonready, kui uus sõnum saab saata. - Veahaldus: Püüab kinni võrgu- ja API-vigad.
- Tühistamine:
stop()katkestab käimasoleva genereerimise.
Vastav API ruut
Konks eeldab ruutu, mis tagastab kasutajaliidese sõnumite voogu. Siin on implementeerimine koos Next.js App Routeriga, modelleeritud ametliku AI SDK 7 näite järgi:
// 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 }),
});
}
Vahetust ümbritsevad kaks teisendust: convertToModelMessages teisendab kliendilt saadud kasutajaliidese sõnumid mudeli sõnumiteks ja toUIMessageStream teeb vastupidist vastuse voos. Meetodid toUIMessageStreamResponse() streamText tulemusel töötavad AI SDK 7-s endiselt, kuid need on iganenud; vana toDataStreamResponse() enam ei eksisteeri.
Peamised punktid
- Vercel AI SDK toetab xAI/Groki paketi
@ai-sdk/xaikaudu generateTextsünkroonsete vastuste jaoks,streamTextvoogedastuse jaoks- Konks
useChathaldab kliendil kogu vestluse olekut createUIMessageStreamResponsejatoUIMessageStreamtagastavaduseChat-i oodatava voo;toDataStreamResponse()enam ei eksisteeri- Alates
@ai-sdk/xai5 versioonist ei toeta pakkuja enam Chat Completionsi:xai()kasutab Responses API-t; Chat Completionsi juurde jäämiseks kasutage OpenAI SDK-d - Pakkuja
createXai()tuvastab API-võtme automaatselt keskkonnast