Vercel AI SDK i integracija s frontendom
Na ovoj stranici
Ažurirano 3. studenoga 2026. na temelju dokumentacije AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x):useChatradi sDefaultChatTransportisendMessage, poruke se prikazuju putemparts, ruta vraćacreateUIMessageStreamResponse,systempostajeinstructions, a pružatelj usluga@ai-sdk/xai5 više ne podržava Chat Completions:xai()koristi Responses API (kod verificiran TypeScript kompajlerom koristećiai7.0.162 i@ai-sdk/xai5.0.38). Prethodna verzija koristila je AI SDK 4 API (input,handleSubmit,isLoading,toDataStreamResponse). Izvori: AI SDK, Chatbot · AI SDK, xAI provider.
Vercel AI SDK za web aplikacije
Vercel AI SDK je TypeScript okvir dizajniran za integraciju AI modela u web aplikacije. Nudi React hookove, uslužne programe za strujanje (streaming) i jedinstvenu apstrakciju koja izvorno podržava xAI/Grok putem paketa @ai-sdk/xai.
Ako gradiš Next.js, Nuxt, SvelteKit ili bilo koju React aplikaciju koja treba prikazivati odgovore u stvarnom vremenu, Vercel AI SDK značajno pojednostavljuje rad.
Instalacija
Instaliraj osnovni SDK i xAI pružatelja usluga:
npm install ai @ai-sdk/xai
Konfiguriraj svoj API ključ u varijablama okruženja:
# .env.local
XAI_API_KEY=tvoj-api-kljuc
Serverska strana: Generiranje teksta
Funkcija generateText najjednostavniji je ekvivalent za client.chat.create(). Jedna se stvar promijenila, a izravno se tiče ovog tečaja: od verzije 5 pružatelja usluga @ai-sdk/xai (rujan 2026.), koja je kompatibilna s AI SDK 7, pružatelj više ne podržava krajnju točku Chat Completions. xai(model) koristi Responses API, koji xAI sada preporučuje. Metoda xai.chat(model), koju neki vodiči za migraciju još uvijek navode, postojala je samo u verziji 4 pružatelja; za kod koji mora ostati na Chat Completions, umjesto toga koristi OpenAI SDK usmjeren 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: "Ti si tehnički asistent.",
prompt: "Objasni koncept kontejnerizacije.",
});
console.log(text);
Pružatelj xai automatski čita XAI_API_KEY iz okruženja; createXai() omogućuje ti stvaranje instance s prilagođenim postavkama. Opcija instructions zamjenjuje system, koji je još uvijek prihvaćen, ali je zastario u AI SDK 7.
Strujanje na serverskoj strani
Za strujanje koristi streamText. Odgovor se čita dio po dio iz textStream:
import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";
const result = streamText({
model: xai("grok-4.7"),
instructions: "Ti si asistent za podučavanje.",
messages: [
{ role: "user", content: "Kako radi relacijska baza podataka?" },
],
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Klijentska strana: Hook useChat
Hook useChat središnji je dio na frontendu. On upravlja poviješću razgovora, strujanjem i stanjem zahtjeva; međutim, polje za unos ostaje jednostavno React stanje kojim upravljaš ti:
"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 pitanje..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Pošalji
</button>
</form>
</div>
);
}
Što useChat automatski obrađuje
- Povijest poruka: Akumulira razmjene; svaka poruka sadrži
parts(tekst, pozivi alatima…), prikazuj ove podatke umjesto starog poljacontent - Strujanje: Prikazuje odgovor dok se generira
- Stanje zahtjeva:
statusjereadykada se može poslati nova poruka - Rukovanje greškama: Presreće mrežne i API greške
- Otkazivanje:
stop()prekida generiranje u tijeku
Odgovarajuća API ruta
Hook očekuje rutu koja vraća tok UI poruka. Evo implementacije s Next.js App Routerom, modelirane prema službenom primjeru 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: "Ti si korisni asistent. Odgovaraj na engleskom.",
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Dvije konverzije obavijaju razmjenu: convertToModelMessages transformira UI poruke primljene od klijenta u modelske poruke, a toUIMessageStream radi obrnuto na toku odgovora. Metode toUIMessageStreamResponse() na rezultatu streamText još uvijek rade u AI SDK 7, ali su zastarjele; što se tiče stare toDataStreamResponse(), ona više ne postoji.
Ključne točke
- Vercel AI SDK podržava xAI/Grok putem paketa
@ai-sdk/xai generateTextza sinkrone odgovore,streamTextza strujanje- Hook
useChatupravlja cjelokupnim stanjem razgovora na klijentu createUIMessageStreamResponseitoUIMessageStreamvraćaju tok koji očekujeuseChat;toDataStreamResponse()više ne postoji- Od
@ai-sdk/xai5, pružatelj više ne podržava Chat Completions:xai()koristi Responses API; da bi ostao na Chat Completions, koristi OpenAI SDK - Pružatelj
createXai()automatski detektira API ključ u okruženju