Vercel AI SDK in integracija s frontendom
Na tej strani
Posodobljeno 3. novembra 2026 na podlagi dokumentacije AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x):useChatdeluje zDefaultChatTransportinsendMessage, sporočila se prikazujejo prekparts, pot vračacreateUIMessageStreamResponse,systempostaneinstructions, ponudnik@ai-sdk/xai5 pa ne podpira več Chat Completions:xai()uporablja Responses API (koda preverjena s TypeScript prevajalnikom z uporaboai7.0.162 in@ai-sdk/xai5.0.38). Prejšnja različica je uporabljala API AI SDK 4 (input,handleSubmit,isLoading,toDataStreamResponse). Viri: AI SDK, Chatbot · AI SDK, ponudnik xAI.
Vercel AI SDK za spletne aplikacije
Vercel AI SDK je ogrodje TypeScript, zasnovano za integracijo modelov umetne inteligence v spletne aplikacije. Zagotavlja React kaveljčke (hooks), pripomočke za pretakanje (streaming) in enotno abstrakcijo, ki izvorno podpira xAI/Grok prek paketa @ai-sdk/xai.
Če gradiš aplikacijo Next.js, Nuxt, SvelteKit ali katero koli React aplikacijo, ki mora prikazovati odzive v realnem času, ti Vercel AI SDK bistveno poenostavi delo.
Namestitev
Namesti osnovni SDK in ponudnika xAI:
npm install ai @ai-sdk/xai
Konfiguriraj svoj API ključ v spremenljivkah okolja:
# .env.local
XAI_API_KEY=tvoj-api-ključ
Strežniška stran: Generiranje besedila
Funkcija generateText je najpreprostejši ekvivalent client.chat.create(). Ena stvar se je spremenila in zadeva neposredno ta tečaj: od različice 5 ponudnika @ai-sdk/xai (september 2026), združljive z AI SDK 7, ponudnik ne podpira več končne točke Chat Completions. xai(model) uporablja Responses API, ki ga xAI zdaj priporoča. Metoda xai.chat(model), ki jo nekateri vodniki za selitev še vedno navajajo, je obstajala le v različici 4 ponudnika; za kodo, ki mora ostati na Chat Completions, namesto tega uporabi OpenAI SDK, usmerjen na xAI (Lekcija 5).
import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";
const { text } = await generateText({
model: xai("grok-4.7"), // xAI Responses API
instructions: "Si tehnični asistent.",
prompt: "Razloži koncept kontejnerizacije.",
});
console.log(text);
Ponudnik xai samodejno prebere XAI_API_KEY iz okolja; createXai() ti omogoča ustvarjanje instance s prilagojenimi nastavitvami. Možnost instructions nadomešča system, ki je še vedno sprejeta, a v AI SDK 7 zastarela.
Pretakanje na strežniški strani
Za pretakanje uporabi streamText. Odziv se bere delček za delčkom iz textStream:
import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";
const result = streamText({
model: xai("grok-4.7"),
instructions: "Si učni asistent.",
messages: [
{ role: "user", content: "Kako deluje relacijska baza podatkov?" },
],
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Odjemalska stran: Kaveljček useChat
Kaveljček useChat je osrednji element na frontendu. Upravlja zgodovino pogovora, pretakanje in stanje zahtevka; vnosno polje pa ostane preprosto stanje React, ki ga upravljaš sam:
"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" ? "Ti" : "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="Postavi svoje vprašanje..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Pošlji
</button>
</form>
</div>
);
}
Kaj useChat samodejno obravnava
- Zgodovina sporočil: Kopiči izmenjave; vsako sporočilo nosi
parts(besedilo, klici orodij …), prikaži te namesto starega poljacontent - Pretakanje: Prikazuje odziv, medtem ko se generira
- Stanje zahtevka:
statusjeready, ko je mogoče poslati novo sporočilo - Obdelava napak: Prestreže napake omrežja in API-ja
- Preklic:
stop()prekine trenutno generiranje
Ustrezna pot API-ja
Kaveljček pričakuje pot, ki vrne tok UI sporočil. Tukaj je implementacija z Next.js App Router, modelirana po uradnem primeru 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: "Si uporaben asistent. Odgovarjaj v angleščini.",
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Dve pretvorbi ovijata izmenjavo: convertToModelMessages pretvori UI sporočila, prejeta od odjemalca, v sporočila modela, toUIMessageStream pa stori obratno na toku odziva. Metode toUIMessageStreamResponse() na rezultatu streamText še vedno delujejo v AI SDK 7, vendar so zastarele; kar zadeva staro toDataStreamResponse(), ta ne obstaja več.
Ključne ugotovitve
- Vercel AI SDK podpira xAI/Grok prek paketa
@ai-sdk/xai generateTextza sinhronizirane odzive,streamTextza pretakanje- Kaveljček
useChatupravlja celotno stanje pogovora na odjemalcu createUIMessageStreamResponseintoUIMessageStreamvrneta tok, ki ga pričakujeuseChat;toDataStreamResponse()ne obstaja več- Od
@ai-sdk/xai5 ponudnik ne podpira več Chat Completions:xai()uporablja Responses API; za ostajanje na Chat Completions uporabi OpenAI SDK - Ponudnik
createXai()samodejno zazna API ključ v okolju