Vercel AI SDK és frontend integráció
Ezen az oldalon
Frissítve: 2026. november 3. az AI SDK 7 dokumentációja alapján (
ai7.0.x,@ai-sdk/react4.x): auseChataDefaultChatTransportés asendMessagefüggvénnyel működik, az üzenetek megjelenítése apartssegítségével történik, az útvonal acreateUIMessageStreamResponseértéket adja vissza, asystemparamétert azinstructionsváltotta fel, és az@ai-sdk/xai5-ös szolgáltató már nem támogatja a Chat Completions végpontot: azxai()a Responses API-t használja (a kódot a TypeScript fordító ellenőrizte azai7.0.162 és az@ai-sdk/xai5.0.38 verziókkal). Az előző verzió az AI SDK 4 API-ját használta (input,handleSubmit,isLoading,toDataStreamResponse). Források: AI SDK, Chatbot · AI SDK, xAI szolgáltató.
A Vercel AI SDK webalkalmazásokhoz
A Vercel AI SDK egy TypeScript keretrendszer, amelyet arra terveztek, hogy mesterséges intelligencia modelleket integráljon webalkalmazásokba. React hookokat, streamelési segédeszközöket és egységes absztrakciót biztosít, amely natívan támogatja az xAI/Grok modelleket az @ai-sdk/xai csomagon keresztül.
Ha Next.js, Nuxt, SvelteKit vagy bármilyen React alkalmazást építesz, amelynek streamelt válaszokat kell megjelenítenie, a Vercel AI SDK jelentősen leegyszerűsíti a munkát.
Telepítés
Telepítsd a core SDK-t és az xAI szolgáltatót:
npm install ai @ai-sdk/xai
Állítsd be az API-kulcsodat a környezeti változókban:
# .env.local
XAI_API_KEY=your-api-key
Szerveroldal: Szöveg generálása
A generateText függvény a client.chat.create() legegyszerűbb megfelelője. Egy dolog megváltozott, ami közvetlenül érinti ezt a tananyagot: az @ai-sdk/xai szolgáltató 5-ös verziója óta (2026. szeptember), amely kompatibilis az AI SDK 7-tel, a szolgáltató már nem támogatja a Chat Completions végpontot. Az xai(model) a Responses API-t használja, amit az xAI most ajánl. Az xai.chat(model) metódus, amelyet egyes migrációs útmutatók még említenek, csak a szolgáltató 4-es verziójában létezett; ha a kódodnak a Chat Completions végponton kell maradnia, használd helyette az xAI-ra irányított OpenAI SDK-t (5. lecke).
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);
Az xai szolgáltató automatikusan beolvassa az XAI_API_KEY értékét a környezetből; a createXai() lehetővé teszi egy példány létrehozását egyedi beállításokkal. Az instructions opció váltja fel a system paramétert, amelyet az AI SDK 7 még elfogad, de elavultnak (deprecated) minősít.
Szerveroldali streamelés
Streameléshez használd a streamText függvényt. A válasz darabonként olvasható a textStreamből:
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);
}
Kliensoldal: A useChat Hook
A useChat hook a frontend központi eleme. Kezeli a beszélgetés előzményeit, a streamelést és a kérés állapotát; a beviteli mező azonban egy egyszerű React állapot marad, amelyet neked kell kezelned:
"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>
);
}
Mit kezel automatikusan a useChat
- Üzenetelőzmények: Felhalmozza a cseréket; minden üzenet tartalmaz
partselemeket (szöveg, eszköz hívások stb.), ezeket jelenítsd meg a régicontentmező helyett. - Streamelés: Megjeleníti a választ generálás közben.
- Kérés állapota: A
statusértékeready, ha új üzenet küldhető. - Hibakezelés: Elfogja a hálózati és API hibákat.
- Megszakítás: A
stop()megszakítja a folyamatban lévő generálást.
A megfelelő API útvonal
A hook egy olyan útvonalat vár, amely UI üzenetek streamjét adja vissza. Íme a megvalósítás a Next.js App Routerrel, a hivatalos AI SDK 7 példa alapján:
// 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 }),
});
}
Két konverzió veszi körül a cserét: a convertToModelMessages átalakítja a klienstől kapott UI üzeneteket modell üzenetekká, a toUIMessageStream pedig fordítva jár el a válasz streamen. A streamText eredményén található toUIMessageStreamResponse() metódusok még működnek az AI SDK 7-ben, de elavultak; ami a régi toDataStreamResponse()-t illeti, az már nem létezik.
Főbb megállapítások
- A Vercel AI SDK támogatja az xAI/Grok modelleket az
@ai-sdk/xaicsomagon keresztül - A
generateTextszinkron válaszokhoz, astreamTextstreameléshez való - A
useChathook kezeli a beszélgetés teljes állapotát a kliens oldalon - A
createUIMessageStreamResponseés atoUIMessageStreamadja vissza auseChatáltal várt streamet; atoDataStreamResponse()már nem létezik - Az
@ai-sdk/xai5-ös verziója óta a szolgáltató már nem támogatja a Chat Completions végpontot: azxai()a Responses API-t használja; ha a Chat Completions végponton akarsz maradni, használd az OpenAI SDK-t - A
createXai()szolgáltató automatikusan észleli az API-kulcsot a környezetben