Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Vercel AI SDK és frontend integráció

6. lecke 12 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. A Vercel AI SDK webalkalmazásokhoz
  2. Telepítés
  3. Szerveroldal: Szöveg generálása
  4. Szerveroldali streamelés
  5. Kliensoldal: A useChat Hook
  6. A megfelelő API útvonal
  7. Főbb megállapítások

Frissítve: 2026. november 3. az AI SDK 7 dokumentációja alapján (ai 7.0.x, @ai-sdk/react 4.x): a useChat a DefaultChatTransport és a sendMessage függvénnyel működik, az üzenetek megjelenítése a parts segítségével történik, az útvonal a createUIMessageStreamResponse értéket adja vissza, a system paramétert az instructions váltotta fel, és az @ai-sdk/xai 5-ös szolgáltató már nem támogatja a Chat Completions végpontot: az xai() a Responses API-t használja (a kódot a TypeScript fordító ellenőrizte az ai 7.0.162 és az @ai-sdk/xai 5.0.38 verziókkal). Az előző verzió az AI SDK 4 API-ját használta (input, handleSubmit, isLoading, toDataStreamResponse). Források: AI SDK, Chatbot · AI SDK, xAI szolgáltató.

A Vercel AI SDK webalkalmazásokhoz

A Vercel AI SDK egy TypeScript keretrendszer, amelyet arra terveztek, hogy mesterséges intelligencia modelleket integráljon webalkalmazásokba. React hookokat, streamelési segédeszközöket és egységes absztrakciót biztosít, amely natívan támogatja az xAI/Grok modelleket az @ai-sdk/xai csomagon keresztül.

Ha Next.js, Nuxt, SvelteKit vagy bármilyen React alkalmazást építesz, amelynek streamelt válaszokat kell megjelenítenie, a Vercel AI SDK jelentősen leegyszerűsíti a munkát.

Telepítés

Telepítsd a core SDK-t és az xAI szolgáltatót:

npm install ai @ai-sdk/xai

Állítsd be az API-kulcsodat a környezeti változókban:

# .env.local
XAI_API_KEY=your-api-key

Szerveroldal: Szöveg generálása

A generateText függvény a client.chat.create() legegyszerűbb megfelelője. Egy dolog megváltozott, ami közvetlenül érinti ezt a tananyagot: az @ai-sdk/xai szolgáltató 5-ös verziója óta (2026. szeptember), amely kompatibilis az AI SDK 7-tel, a szolgáltató már nem támogatja a Chat Completions végpontot. Az xai(model) a Responses API-t használja, amit az xAI most ajánl. Az xai.chat(model) metódus, amelyet egyes migrációs útmutatók még említenek, csak a szolgáltató 4-es verziójában létezett; ha a kódodnak a Chat Completions végponton kell maradnia, használd helyette az xAI-ra irányított OpenAI SDK-t (5. lecke).

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);

Az xai szolgáltató automatikusan beolvassa az XAI_API_KEY értékét a környezetből; a createXai() lehetővé teszi egy példány létrehozását egyedi beállításokkal. Az instructions opció váltja fel a system paramétert, amelyet az AI SDK 7 még elfogad, de elavultnak (deprecated) minősít.

Szerveroldali streamelés

Streameléshez használd a streamText függvényt. A válasz darabonként olvasható a textStreamből:

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);
}

Kliensoldal: A useChat Hook

A useChat hook a frontend központi eleme. Kezeli a beszélgetés előzményeit, a streamelést és a kérés állapotát; a beviteli mező azonban egy egyszerű React állapot marad, amelyet neked kell kezelned:

"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>
  );
}

Mit kezel automatikusan a useChat

  • Üzenetelőzmények: Felhalmozza a cseréket; minden üzenet tartalmaz parts elemeket (szöveg, eszköz hívások stb.), ezeket jelenítsd meg a régi content mező helyett.
  • Streamelés: Megjeleníti a választ generálás közben.
  • Kérés állapota: A status értéke ready, ha új üzenet küldhető.
  • Hibakezelés: Elfogja a hálózati és API hibákat.
  • Megszakítás: A stop() megszakítja a folyamatban lévő generálást.

A megfelelő API útvonal

A hook egy olyan útvonalat vár, amely UI üzenetek streamjét adja vissza. Íme a megvalósítás a Next.js App Routerrel, a hivatalos AI SDK 7 példa alapján:

// 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 }),
  });
}

Két konverzió veszi körül a cserét: a convertToModelMessages átalakítja a klienstől kapott UI üzeneteket modell üzenetekká, a toUIMessageStream pedig fordítva jár el a válasz streamen. A streamText eredményén található toUIMessageStreamResponse() metódusok még működnek az AI SDK 7-ben, de elavultak; ami a régi toDataStreamResponse()-t illeti, az már nem létezik.

Főbb megállapítások

  • A Vercel AI SDK támogatja az xAI/Grok modelleket az @ai-sdk/xai csomagon keresztül
  • A generateText szinkron válaszokhoz, a streamText streameléshez való
  • A useChat hook kezeli a beszélgetés teljes állapotát a kliens oldalon
  • A createUIMessageStreamResponse és a toUIMessageStream adja vissza a useChat által várt streamet; a toDataStreamResponse() már nem létezik
  • Az @ai-sdk/xai 5-ös verziója óta a szolgáltató már nem támogatja a Chat Completions végpontot: az xai() a Responses API-t használja; ha a Chat Completions végponton akarsz maradni, használd az OpenAI SDK-t
  • A createXai() szolgáltató automatikusan észleli az API-kulcsot a környezetben