Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Vercel AI SDK a integrácia s frontendom

Lekcia 6 z 12 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Vercel AI SDK pre webové aplikácie
  2. Inštalácia
  3. Serverová strana: Generovanie textu
  4. Streamovanie na strane servera
  5. Klientská strana: Hook useChat
  6. Zodpovedajúca API ruta
  7. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe dokumentácie AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): useChat funguje s DefaultChatTransport a sendMessage, správy sa zobrazujú cez parts, ruta vracia createUIMessageStreamResponse, system sa mení na instructions a poskytovateľ @ai-sdk/xai 5 už nepodporuje Chat Completions: xai() využíva Responses API (kód overený kompilátorom TypeScript s použitím ai 7.0.162 a @ai-sdk/xai 5.0.38). Predchádzajúca verzia používala API AI SDK 4 (input, handleSubmit, isLoading, toDataStreamResponse). Zdroje: AI SDK, Chatbot · AI SDK, poskytovateľ xAI.

Vercel AI SDK pre webové aplikácie

Vercel AI SDK je TypeScript framework navrhnutý na integráciu modelov umelej inteligencie do webových aplikácií. Poskytuje React hooky, nástroje pre streamovanie a jednotnú abstrakciu, ktorá natívne podporuje xAI/Grok prostredníctvom balíka @ai-sdk/xai.

Ak buduješ aplikáciu v Next.js, Nuxt, SvelteKit alebo akúkoľvek React aplikáciu, ktorá potrebuje zobrazovať streamované odpovede, Vercel AI SDK ti prácu výrazne zjednoduší.

Inštalácia

Nainštaluj základné SDK a poskytovateľa xAI:

npm install ai @ai-sdk/xai

Nakonfiguruj svoj API kľúč v premenných prostredia:

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

Serverová strana: Generovanie textu

Funkcia generateText je najjednoduchším ekvivalentom client.chat.create(). Jedna vec sa zmenila a týka sa priamo tohto kurzu: od verzie 5 poskytovateľa @ai-sdk/xai (september 2026), kompatibilnej s AI SDK 7, tento poskytovateľ už nepodporuje koncový bod Chat Completions. xai(model) využíva Responses API, ktoré xAI teraz odporúča. Metóda xai.chat(model), ktorú niektoré sprievodcovia migráciou stále uvádzajú, existovala len vo verzii 4 poskytovateľa; pre kód, ktorý musí zostať na Chat Completions, namiesto toho použi OpenAI SDK nasmerované na xAI (Lekcia 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);

Poskytovateľ xai automaticky číta XAI_API_KEY z prostredia; createXai() ti umožňuje vytvoriť inštanciu s vlastnými nastaveniami. Možnosť instructions nahrádza system, ktoré je stále akceptované, ale v AI SDK 7 je zastarané.

Streamovanie na strane servera

Pre streamovanie použi streamText. Odpoveď sa číta po častiach z 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);
}

Klientská strana: Hook useChat

Hook useChat je ústredným bodom na fronte. Spravuje históriu konverzácie, streamovanie a stav požiadavky; vstupné pole však zostáva jednoduchým stavom React, ktorý spravuješ sám:

"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" ? "Ty" : "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="Opýtaj sa svoju otázku..."
          disabled={status !== "ready"}
        />
        <button type="submit" disabled={status !== "ready"}>
          Odoslať
        </button>
      </form>
    </div>
  );
}

Čo useChat vybavuje automaticky

  • História správ: Akumuluje výmeny; každá správa nesie parts (text, volania nástrojov…), zobrazuj tieto namiesto starého poľa content
  • Streamovanie: Zobrazuje odpoveď počas jej generovania
  • Stav požiadavky: status je ready, keď je možné odoslať novú správu
  • Spracovanie chýb: Zachytáva chyby siete a API
  • Zrušenie: stop() preruší prebiehajúce generovanie

Zodpovedajúca API ruta

Hook očakáva rutu, ktorá vráti stream UI správ. Tu je implementácia s Next.js App Router, modelovaná podľa oficiálneho príkladu 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 }),
  });
}

Dve konverzie obaľujú výmenu: convertToModelMessages transformuje UI správy prijaté od klienta na správy modelu a toUIMessageStream robí opak na streamu odpovede. Metódy toUIMessageStreamResponse() na výsledku streamText stále fungujú v AI SDK 7, ale sú zastarané; čo sa týka starej toDataStreamResponse(), tá už neexistuje.

Kľúčové poznatky

  • Vercel AI SDK podporuje xAI/Grok prostredníctvom balíka @ai-sdk/xai
  • generateText pre synchronné odpovede, streamText pre streamovanie
  • Hook useChat spravuje kompletný stav konverzácie na klientovi
  • createUIMessageStreamResponse a toUIMessageStream vracajú stream očakávaný hookom useChat; toDataStreamResponse() už neexistuje
  • Od verzie @ai-sdk/xai 5 poskytovateľ už nepodporuje Chat Completions: xai() využíva Responses API; ak chceš zostať na Chat Completions, použi OpenAI SDK
  • Poskytovateľ createXai() automaticky deteguje API kľúč v prostredí