Vercel AI SDK a integrácia s frontendom
Na tejto strane
Aktualizované 3. novembra 2026 na základe dokumentácie AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x):useChatfunguje sDefaultChatTransportasendMessage, správy sa zobrazujú cezparts, ruta vraciacreateUIMessageStreamResponse,systemsa mení nainstructionsa poskytovateľ@ai-sdk/xai5 už nepodporuje Chat Completions:xai()využíva Responses API (kód overený kompilátorom TypeScript s použitímai7.0.162 a@ai-sdk/xai5.0.38). Predchádzajúca verzia používala API AI SDK 4 (input,handleSubmit,isLoading,toDataStreamResponse). Zdroje: AI SDK, Chatbot · AI SDK, poskytovateľ xAI.
Vercel AI SDK pre webové aplikácie
Vercel AI SDK je TypeScript framework navrhnutý na integráciu modelov umelej inteligencie do webových aplikácií. Poskytuje React hooky, nástroje pre streamovanie a jednotnú abstrakciu, ktorá natívne podporuje xAI/Grok prostredníctvom balíka @ai-sdk/xai.
Ak buduješ aplikáciu v Next.js, Nuxt, SvelteKit alebo akúkoľvek React aplikáciu, ktorá potrebuje zobrazovať streamované odpovede, Vercel AI SDK ti prácu výrazne zjednoduší.
Inštalácia
Nainštaluj základné SDK a poskytovateľa xAI:
npm install ai @ai-sdk/xai
Nakonfiguruj svoj API kľúč v premenných prostredia:
# .env.local
XAI_API_KEY=your-api-key
Serverová strana: Generovanie textu
Funkcia generateText je najjednoduchším ekvivalentom client.chat.create(). Jedna vec sa zmenila a týka sa priamo tohto kurzu: od verzie 5 poskytovateľa @ai-sdk/xai (september 2026), kompatibilnej s AI SDK 7, tento poskytovateľ už nepodporuje koncový bod Chat Completions. xai(model) využíva Responses API, ktoré xAI teraz odporúča. Metóda xai.chat(model), ktorú niektoré sprievodcovia migráciou stále uvádzajú, existovala len vo verzii 4 poskytovateľa; pre kód, ktorý musí zostať na Chat Completions, namiesto toho použi OpenAI SDK nasmerované na xAI (Lekcia 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);
Poskytovateľ xai automaticky číta XAI_API_KEY z prostredia; createXai() ti umožňuje vytvoriť inštanciu s vlastnými nastaveniami. Možnosť instructions nahrádza system, ktoré je stále akceptované, ale v AI SDK 7 je zastarané.
Streamovanie na strane servera
Pre streamovanie použi streamText. Odpoveď sa číta po častiach z 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);
}
Klientská strana: Hook useChat
Hook useChat je ústredným bodom na fronte. Spravuje históriu konverzácie, streamovanie a stav požiadavky; vstupné pole však zostáva jednoduchým stavom React, ktorý spravuješ sám:
"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" ? "Ty" : "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="Opýtaj sa svoju otázku..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Odoslať
</button>
</form>
</div>
);
}
Čo useChat vybavuje automaticky
- História správ: Akumuluje výmeny; každá správa nesie
parts(text, volania nástrojov…), zobrazuj tieto namiesto starého poľacontent - Streamovanie: Zobrazuje odpoveď počas jej generovania
- Stav požiadavky:
statusjeready, keď je možné odoslať novú správu - Spracovanie chýb: Zachytáva chyby siete a API
- Zrušenie:
stop()preruší prebiehajúce generovanie
Zodpovedajúca API ruta
Hook očakáva rutu, ktorá vráti stream UI správ. Tu je implementácia s Next.js App Router, modelovaná podľa oficiálneho príkladu 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 }),
});
}
Dve konverzie obaľujú výmenu: convertToModelMessages transformuje UI správy prijaté od klienta na správy modelu a toUIMessageStream robí opak na streamu odpovede. Metódy toUIMessageStreamResponse() na výsledku streamText stále fungujú v AI SDK 7, ale sú zastarané; čo sa týka starej toDataStreamResponse(), tá už neexistuje.
Kľúčové poznatky
- Vercel AI SDK podporuje xAI/Grok prostredníctvom balíka
@ai-sdk/xai generateTextpre synchronné odpovede,streamTextpre streamovanie- Hook
useChatspravuje kompletný stav konverzácie na klientovi createUIMessageStreamResponseatoUIMessageStreamvracajú stream očakávaný hookomuseChat;toDataStreamResponse()už neexistuje- Od verzie
@ai-sdk/xai5 poskytovateľ už nepodporuje Chat Completions:xai()využíva Responses API; ak chceš zostať na Chat Completions, použi OpenAI SDK - Poskytovateľ
createXai()automaticky deteguje API kľúč v prostredí