Vercel AI SDK și integrarea în frontend
Pe această pagină
Actualizat la 3 noiembrie 2026 pe baza documentației AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x):useChatfuncționează cuDefaultChatTransportșisendMessage, mesajele sunt afișate prinparts, ruta returneazăcreateUIMessageStreamResponse,systemdevineinstructions, iar providerul@ai-sdk/xai5 nu mai suportă Chat Completions:xai()utilizează Responses API (cod verificat cu compilatorul TypeScript folosindai7.0.162 și@ai-sdk/xai5.0.38). Versiunea anterioară utiliza API-ul AI SDK 4 (input,handleSubmit,isLoading,toDataStreamResponse). Surse: AI SDK, Chatbot · AI SDK, provider xAI.
Vercel AI SDK pentru aplicații web
Vercel AI SDK este un framework TypeScript conceput pentru a integra modelele de inteligență artificială în aplicațiile web. Acesta oferă hook-uri React, utilitare de streaming și o abstractizare unificată care suportă nativ xAI/Grok prin pachetul @ai-sdk/xai.
Dacă dezvoltați o aplicație Next.js, Nuxt, SvelteKit sau orice aplicație React care necesită afișarea răspunsurilor în timp real (streaming), Vercel AI SDK simplifică considerabil munca dumneavoastră.
Instalare
Instalați SDK-ul principal și providerul xAI:
npm install ai @ai-sdk/xai
Configurați cheia API în variabilele de mediu:
# .env.local
XAI_API_KEY=your-api-key
Latura server: Generarea textului
Funcția generateText este echivalentul cel mai simplu al lui client.chat.create(). Un aspect s-a schimbat și privește direct acest curs: începând cu versiunea 5 a providerului @ai-sdk/xai (septembrie 2026), compatibilă cu AI SDK 7, providerul nu mai suportă endpoint-ul Chat Completions. xai(model) utilizează Responses API, pe care xAI îl recomandă acum. Metoda xai.chat(model), citată încă în unele ghiduri de migrare, a existat doar în versiunea 4 a providerului; pentru codul care trebuie să rămână pe Chat Completions, utilizați în schimb OpenAI SDK îndreptat către xAI (Lecția 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);
Providerul xai citește automat XAI_API_KEY din mediul înconjurător; createXai() vă permite să creați o instanță cu setări personalizate. Opțiunea instructions înlocuiește system, care este încă acceptat, dar depreciat în AI SDK 7.
Streaming pe partea de server
Pentru streaming, utilizați streamText. Răspunsul se citește bucată cu bucată din 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);
}
Latura client: Hook-ul useChat
Hook-ul useChat este piesa centrală în frontend. Acesta gestionează istoricul conversației, streaming-ul și starea cererii; câmpul de input, totuși, rămâne o simplă stare React pe care o gestionați dumneavoastră:
"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>
);
}
Ce gestionează automat useChat
- Istoricul mesajelor: Acumulează schimburile; fiecare mesaj conține
parts(text, apeluri de instrumente…), afișați-le pe acestea în loc de vechiul câmpcontent. - Streaming: Afișează răspunsul pe măsură ce este generat.
- Starea cererii:
statusestereadycând poate fi trimis un nou mesaj. - Gestionarea erorilor: Interceptează erorile de rețea și de API.
- Anularea:
stop()întrerupe o generare în curs.
Ruta API corespunzătoare
Hook-ul se așteaptă la o rută care returnează un flux de mesaje UI. Iată implementarea cu Next.js App Router, modelată după exemplul oficial 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 }),
});
}
Două conversii învelesc schimbul: convertToModelMessages transformă mesajele UI primite de la client în mesaje pentru model, iar toUIMessageStream face inversul pe fluxul de răspuns. Metodele toUIMessageStreamResponse() de pe rezultatul streamText funcționează încă în AI SDK 7, dar sunt depreciate; cât despre vechea toDataStreamResponse(), aceasta nu mai există.
Puncte cheie
- Vercel AI SDK suportă xAI/Grok prin pachetul
@ai-sdk/xai generateTextpentru răspunsuri sincrone,streamTextpentru streaming- Hook-ul
useChatgestionează starea completă a unei conversații pe client createUIMessageStreamResponseșitoUIMessageStreamreturnează fluxul așteptat deuseChat;toDataStreamResponse()nu mai există- Începând cu
@ai-sdk/xai5, providerul nu mai suportă Chat Completions:xai()utilizează Responses API; pentru a rămâne pe Chat Completions, utilizați OpenAI SDK - Providerul
createXai()detectează automat cheia API în mediul înconjurător