Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Vercel AI SDK ja kasutajaliidese integreerimine

Õppetund 6 / 12 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Vercel AI SDK veebirakendustele
  2. Paigaldamine
  3. Serveripoolne: teksti genereerimine
  4. Serveripoolne voogedastus
  5. Kliendipoolne: useChat konks
  6. Vastav API ruut
  7. Peamised punktid

Uuendatud 3. novembril 2026 vastavalt AI SDK 7 dokumentatsioonile (ai 7.0.x, @ai-sdk/react 4.x): useChat töötab koos DefaultChatTransport ja sendMessage-ga, sõnumeid kuvatakse parts kaudu, ruut tagastab createUIMessageStreamResponse, system asendub instructions-ga ning @ai-sdk/xai 5 pakkuja ei toeta enam Chat Completionsi: xai() kasutab Responses API-t (kood on kontrollitud TypeScripti kompilaatoriga, kasutades ai 7.0.162 ja @ai-sdk/xai 5.0.38). Eelmine versioon kasutas AI SDK 4 API-t (input, handleSubmit, isLoading, toDataStreamResponse). Allikad: AI SDK, Chatbot · AI SDK, xAI pakkuja.

Vercel AI SDK veebirakendustele

Vercel AI SDK on TypeScripti raamistik, mis on loodud tehisintellekti mudelite veebirakendustesse integreerimiseks. See pakub Reacti konksu (hooks), voogedastusvahendeid ja ühtset abstraktsiooni, mis toob kaasa xAI/Groki toe paketi @ai-sdk/xai kaudu.

Kui ehitate Next.js, Nuxt, SvelteKit või mõnda muud Reacti rakendust, mis peab kuvama voogedastatavaid vastuseid, lihtsustab Vercel AI SDK tööd oluliselt.

Paigaldamine

Paigaldage põhiline SDK ja xAI pakkuja:

npm install ai @ai-sdk/xai

Seadistage oma API-võti keskkonnamuutujates:

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

Serveripoolne: teksti genereerimine

Funktsioon generateText on lihtsaim vaste client.chat.create()-le. Üks asi on muutunud ja see puudutab otseselt seda kursust: alates @ai-sdk/xai pakkuja 5. versioonist (september 2026), mis ühildub AI SDK 7-ga, ei toeta pakkuja enam Chat Completionsi lõpp-punkti. xai(model) kasutab Responses API-t, mida xAI nüüd soovitab. Meetod xai.chat(model), mida mõned migratsioonijuhendid endiselt mainivad, eksisteeris ainult pakkuja 4. versioonis; koodi jaoks, mis peab jääma Chat Completionsi juurde, kasutage selle asemel xAI-le suunatud OpenAI SDK-d (Õppetund 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);

xai pakkuja loeb XAI_API_KEY automaatselt keskkonnast; createXai() võimaldab luua instantsi kohandatud seadetega. Valik instructions asendab system-i, mida AI SDK 7-s endiselt aktsepteeritakse, kuid mida peetakse iganenuks.

Serveripoolne voogedastus

Voogedastuseks kasutage streamText. Vastust loetakse textStream-ist tükkhaaval:

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

Kliendipoolne: useChat konks

Konks useChat on kasutajaliideses keskne element. See haldab vestluse ajalugu, voogedastust ja päringu olekut; sisendväli on aga lihtne Reacti olek, mida haldad ise:

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

Mida useChat automaatselt haldab

  • Sõnumite ajalugu: Kogub vahetusi; iga sõnum kannab parts (tekst, tööriista väljakutsed jne), kuva neid vana content välja asemel.
  • Voogedastus: Kuvab vastuse selle genereerimise käigus.
  • Päringu olek: status on ready, kui uus sõnum saab saata.
  • Veahaldus: Püüab kinni võrgu- ja API-vigad.
  • Tühistamine: stop() katkestab käimasoleva genereerimise.

Vastav API ruut

Konks eeldab ruutu, mis tagastab kasutajaliidese sõnumite voogu. Siin on implementeerimine koos Next.js App Routeriga, modelleeritud ametliku AI SDK 7 näite järgi:

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

Vahetust ümbritsevad kaks teisendust: convertToModelMessages teisendab kliendilt saadud kasutajaliidese sõnumid mudeli sõnumiteks ja toUIMessageStream teeb vastupidist vastuse voos. Meetodid toUIMessageStreamResponse() streamText tulemusel töötavad AI SDK 7-s endiselt, kuid need on iganenud; vana toDataStreamResponse() enam ei eksisteeri.

Peamised punktid

  • Vercel AI SDK toetab xAI/Groki paketi @ai-sdk/xai kaudu
  • generateText sünkroonsete vastuste jaoks, streamText voogedastuse jaoks
  • Konks useChat haldab kliendil kogu vestluse olekut
  • createUIMessageStreamResponse ja toUIMessageStream tagastavad useChat-i oodatava voo; toDataStreamResponse() enam ei eksisteeri
  • Alates @ai-sdk/xai 5 versioonist ei toeta pakkuja enam Chat Completionsi: xai() kasutab Responses API-t; Chat Completionsi juurde jäämiseks kasutage OpenAI SDK-d
  • Pakkuja createXai() tuvastab API-võtme automaatselt keskkonnast