Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Vercel AI SDK a integrace s frontendem

Lekce 6 z 12 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Vercel AI SDK pro webové aplikace
  2. Instalace
  3. Serverová strana: Generování textu
  4. Streamování na serverové straně
  5. Klientská strana: Hook useChat
  6. Odpovídající API Route
  7. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě dokumentace AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): useChat funguje s DefaultChatTransport a sendMessage, zprávy se zobrazují přes parts, route vrací createUIMessageStreamResponse, system se mění na instructions a poskytovatel @ai-sdk/xai 5 již nepodporuje Chat Completions: xai() využívá Responses API (kód ověřen kompilátorem TypeScriptu pomocí ai 7.0.162 a @ai-sdk/xai 5.0.38). Předchozí verze používala API AI SDK 4 (input, handleSubmit, isLoading, toDataStreamResponse). Zdroje: AI SDK, Chatbot · AI SDK, poskytovatel xAI.

Vercel AI SDK pro webové aplikace

Vercel AI SDK je TypeScriptový framework navržený pro integraci AI modelů do webových aplikací. Poskytuje React hooky, utility pro streamování a jednotnou abstrakci, která nativně podporuje xAI/Grok prostřednictvím balíčku @ai-sdk/xai.

Pokud stavíš aplikaci v Next.js, Nuxt, SvelteKit nebo jakoukoli React aplikaci, která potřebuje zobrazovat streamované odpovědi, Vercel AI SDK ti práci výrazně zjednoduší.

Instalace

Nainstaluj základní SDK a poskytovatele xAI:

npm install ai @ai-sdk/xai

Nakonfiguruj svůj API klíč v proměnných prostředí:

# .env.local
XAI_API_KEY=tvuj-api-klíč

Serverová strana: Generování textu

Funkce generateText je nejjednodušším ekvivalentem client.chat.create(). Jedna věc se změnila a týká se přímo tohoto kurzu: od verze 5 poskytovatele @ai-sdk/xai (září 2026), kompatibilní s AI SDK 7, tento poskytovatel již nepodporuje koncový bod Chat Completions. xai(model) využívá Responses API, které nyní xAI doporučuje. Metoda xai.chat(model), kterou některé migrační průvodce stále citují, existovala pouze ve verzi 4 poskytovatele; pro kód, který musí zůstat na Chat Completions, použij místo toho OpenAI SDK namířený na xAI (Lekce 5).

import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";

const { text } = await generateText({
  model: xai("grok-4.7"), // xAI Responses API
  instructions: "Jsi technický asistent.",
  prompt: "Vysvětli koncept kontejnerizace.",
});

console.log(text);

Poskytovatel xai automaticky čte XAI_API_KEY z prostředí; createXai() ti umožňuje vytvořit instanci s vlastním nastavením. Možnost instructions nahrazuje system, které je stále přijímáno, ale v AI SDK 7 je zastaralé.

Streamování na serverové straně

Pro streamování použij streamText. Odpověď se čte po částech z textStream:

import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";

const result = streamText({
  model: xai("grok-4.7"),
  instructions: "Jsi vyučující asistent.",
  messages: [
    { role: "user", content: "Jak funguje relační databáze?" },
  ],
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

Klientská strana: Hook useChat

Hook useChat je stěžejním prvkem na frontendu. Stará se o historii konverzace, streamování a stav požadavku; vstupní pole však zůstává jednoduchým React stavem, který 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="Zeptej se na cokoli..."
          disabled={status !== "ready"}
        />
        <button type="submit" disabled={status !== "ready"}>
          Odeslat
        </button>
      </form>
    </div>
  );
}

Co useChat zpracovává automaticky

  • Historie zpráv: Akumuluje výměny; každá zpráva nese parts (text, volání nástrojů…), zobrazuj tyto údaje místo starého pole content
  • Streamování: Zobrazuje odpověď během jejího generování
  • Stav požadavku: status je ready, když lze odeslat novou zprávu
  • Zpracování chyb: Zachytává chyby sítě a API
  • Zrušení: stop() přeruší probíhající generování

Odpovídající API Route

Hook očekává route, která vrací proud UI zpráv. Zde je implementace s Next.js App Routerem, modelovaná podle oficiálního pří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: "Jsi nápomocný asistent. Odpovídej anglicky.",
    messages: await convertToModelMessages(messages),
  });

  return createUIMessageStreamResponse({
    stream: toUIMessageStream({ stream: result.stream }),
  });
}

Výměnu obalují dvě konverze: convertToModelMessages transformuje UI zprávy přijaté od klienta na zprávy modelu a toUIMessageStream dělá opak na výstupním proudu. Metody toUIMessageStreamResponse() na výsledku streamText stále fungují v AI SDK 7, ale jsou zastaralé; co se týče staré toDataStreamResponse(), ta již neexistuje.

Klíčové poznatky

  • Vercel AI SDK podporuje xAI/Grok prostřednictvím balíčku @ai-sdk/xai
  • generateText pro synchronní odpovědi, streamText pro streamování
  • Hook useChat spravuje kompletní stav konverzace na klientovi
  • createUIMessageStreamResponse a toUIMessageStream vracejí proud očekávaný hookem useChat; toDataStreamResponse() již neexistuje
  • Od verze @ai-sdk/xai 5 poskytovatel již nepodporuje Chat Completions: xai() využívá Responses API; pro setrvání na Chat Completions použij OpenAI SDK
  • Poskytovatel createXai() automaticky detekuje API klíč v prostředí