Vercel AI SDK a integrace s frontendem
Na této stránce
Aktualizováno 3. listopadu 2026 na základě dokumentace AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x):useChatfunguje sDefaultChatTransportasendMessage, zprávy se zobrazují přesparts, route vracícreateUIMessageStreamResponse,systemse mění nainstructionsa poskytovatel@ai-sdk/xai5 již nepodporuje Chat Completions:xai()využívá Responses API (kód ověřen kompilátorem TypeScriptu pomocíai7.0.162 a@ai-sdk/xai5.0.38). Předchozí verze používala API AI SDK 4 (input,handleSubmit,isLoading,toDataStreamResponse). Zdroje: AI SDK, Chatbot · AI SDK, poskytovatel xAI.
Vercel AI SDK pro webové aplikace
Vercel AI SDK je TypeScriptový framework navržený pro integraci AI modelů do webových aplikací. Poskytuje React hooky, utility pro streamování a jednotnou abstrakci, která nativně podporuje xAI/Grok prostřednictvím balíčku @ai-sdk/xai.
Pokud stavíš aplikaci v Next.js, Nuxt, SvelteKit nebo jakoukoli React aplikaci, která potřebuje zobrazovat streamované odpovědi, Vercel AI SDK ti práci výrazně zjednoduší.
Instalace
Nainstaluj základní SDK a poskytovatele xAI:
npm install ai @ai-sdk/xai
Nakonfiguruj svůj API klíč v proměnných prostředí:
# .env.local
XAI_API_KEY=tvuj-api-klíč
Serverová strana: Generování textu
Funkce generateText je nejjednodušším ekvivalentem client.chat.create(). Jedna věc se změnila a týká se přímo tohoto kurzu: od verze 5 poskytovatele @ai-sdk/xai (září 2026), kompatibilní s AI SDK 7, tento poskytovatel již nepodporuje koncový bod Chat Completions. xai(model) využívá Responses API, které nyní xAI doporučuje. Metoda xai.chat(model), kterou některé migrační průvodce stále citují, existovala pouze ve verzi 4 poskytovatele; pro kód, který musí zůstat na Chat Completions, použij místo toho OpenAI SDK namířený na xAI (Lekce 5).
import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";
const { text } = await generateText({
model: xai("grok-4.7"), // xAI Responses API
instructions: "Jsi technický asistent.",
prompt: "Vysvětli koncept kontejnerizace.",
});
console.log(text);
Poskytovatel xai automaticky čte XAI_API_KEY z prostředí; createXai() ti umožňuje vytvořit instanci s vlastním nastavením. Možnost instructions nahrazuje system, které je stále přijímáno, ale v AI SDK 7 je zastaralé.
Streamování na serverové straně
Pro streamování použij streamText. Odpověď se čte po částech z textStream:
import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";
const result = streamText({
model: xai("grok-4.7"),
instructions: "Jsi vyučující asistent.",
messages: [
{ role: "user", content: "Jak funguje relační databáze?" },
],
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Klientská strana: Hook useChat
Hook useChat je stěžejním prvkem na frontendu. Stará se o historii konverzace, streamování a stav požadavku; vstupní pole však zůstává jednoduchým React stavem, který 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="Zeptej se na cokoli..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Odeslat
</button>
</form>
</div>
);
}
Co useChat zpracovává automaticky
- Historie zpráv: Akumuluje výměny; každá zpráva nese
parts(text, volání nástrojů…), zobrazuj tyto údaje místo starého polecontent - Streamování: Zobrazuje odpověď během jejího generování
- Stav požadavku:
statusjeready, když lze odeslat novou zprávu - Zpracování chyb: Zachytává chyby sítě a API
- Zrušení:
stop()přeruší probíhající generování
Odpovídající API Route
Hook očekává route, která vrací proud UI zpráv. Zde je implementace s Next.js App Routerem, modelovaná podle oficiálního pří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: "Jsi nápomocný asistent. Odpovídej anglicky.",
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Výměnu obalují dvě konverze: convertToModelMessages transformuje UI zprávy přijaté od klienta na zprávy modelu a toUIMessageStream dělá opak na výstupním proudu. Metody toUIMessageStreamResponse() na výsledku streamText stále fungují v AI SDK 7, ale jsou zastaralé; co se týče staré toDataStreamResponse(), ta již neexistuje.
Klíčové poznatky
- Vercel AI SDK podporuje xAI/Grok prostřednictvím balíčku
@ai-sdk/xai generateTextpro synchronní odpovědi,streamTextpro streamování- Hook
useChatspravuje kompletní stav konverzace na klientovi createUIMessageStreamResponseatoUIMessageStreamvracejí proud očekávaný hookemuseChat;toDataStreamResponse()již neexistuje- Od verze
@ai-sdk/xai5 poskytovatel již nepodporuje Chat Completions:xai()využívá Responses API; pro setrvání na Chat Completions použij OpenAI SDK - Poskytovatel
createXai()automaticky detekuje API klíč v prostředí