Salt la conținutul principal
Română— Alege o limbă
Meniu

Vercel AI SDK și integrarea în frontend

Lecția 6 din 12 Actualizată 3 noiembrie 2026 Dezvoltator
Pe această pagină
  1. Vercel AI SDK pentru aplicații web
  2. Instalare
  3. Latura server: Generarea textului
  4. Streaming pe partea de server
  5. Latura client: Hook-ul useChat
  6. Ruta API corespunzătoare
  7. Puncte cheie

Actualizat la 3 noiembrie 2026 pe baza documentației AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): useChat funcționează cu DefaultChatTransport și sendMessage, mesajele sunt afișate prin parts, ruta returnează createUIMessageStreamResponse, system devine instructions, iar providerul @ai-sdk/xai 5 nu mai suportă Chat Completions: xai() utilizează Responses API (cod verificat cu compilatorul TypeScript folosind ai 7.0.162 și @ai-sdk/xai 5.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âmp content.
  • Streaming: Afișează răspunsul pe măsură ce este generat.
  • Starea cererii: status este ready câ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
  • generateText pentru răspunsuri sincrone, streamText pentru streaming
  • Hook-ul useChat gestionează starea completă a unei conversații pe client
  • createUIMessageStreamResponse și toUIMessageStream returnează fluxul așteptat de useChat; toDataStreamResponse() nu mai există
  • Începând cu @ai-sdk/xai 5, 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