Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Vercel AI SDK ir integracija su sąsaja

Paskaita 6 iš 12 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. Vercel AI SDK žiniatinklio programoms
  2. Diegimas
  3. Serverio pusė: teksto generavimas
  4. Srautinis perdavimas serverio pusėje
  5. Kliento pusė: useChat kablis
  6. Atitinkamas API maršrutas
  7. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d. pagal AI SDK 7 dokumentaciją (ai 7.0.x, @ai-sdk/react 4.x): useChat veikia su DefaultChatTransport ir sendMessage, žinutės rodomos per parts, maršrutas grąžina createUIMessageStreamResponse, system pakeistas į instructions, o @ai-sdk/xai 5 tiekėjas nebepalaiko „Chat Completions“: xai() naudoja „Responses API“ (kodas patikrintas TypeScript kompiliatoriumi naudojant ai 7.0.162 ir @ai-sdk/xai 5.0.38). Ankstesnė versija naudojo AI SDK 4 API (input, handleSubmit, isLoading, toDataStreamResponse). Šaltiniai: AI SDK, Chatbot · AI SDK, xAI tiekėjas.

Vercel AI SDK žiniatinklio programoms

Vercel AI SDK yra TypeScript karkasas, sukurtas dirbtinio intelekto modeliams integruoti į žiniatinklio programas. Jis suteikia React kablius, srautinio perdavimo įrankius ir vieningą abstrakciją, kuri natūraliai palaiko xAI/Grok per @ai-sdk/xai paketą.

Jei kuriate Next.js, Nuxt, SvelteKit ar bet kurią React programą, kuriai reikia rodyti srautinius atsakymus, Vercel AI SDK žymiai supaprastina darbą.

Diegimas

Įdiekite pagrindinį SDK ir xAI tiekėją:

npm install ai @ai-sdk/xai

Sukonfigūruokite savo API raktą aplinkos kintamuosiuose:

# .env.local
XAI_API_KEY=jūsų-api-raktas

Serverio pusė: teksto generavimas

Funkcija generateText yra paprasčiausias client.chat.create() atitikmuo. Vienas dalykas pasikeitė, ir tai tiesiogiai liečia šį kursą: nuo @ai-sdk/xai tiekėjo 5 versijos (2026 m. rugsėjis), suderinamos su AI SDK 7, tiekėjas nebepalaiko „Chat Completions“ galutinio taško. xai(model) naudoja Responses API, kurį dabar rekomenduoja xAI. Metodas xai.chat(model), kurį kai kurios migracijos gairės vis dar mini, egzistavo tik 4-osios tiekėjo versijos metu; kodui, kuris turi likti prie „Chat Completions“, vietoj to naudokite xAI nukreiptą OpenAI SDK (5 pamoka).

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

const { text } = await generateText({
  model: xai("grok-4.7"), // xAI Responses API
  instructions: "Esi techninis asistentas.",
  prompt: "Paaiškink konteinerizacijos sąvoką.",
});

console.log(text);

xai tiekėjas automatiškai nuskaito XAI_API_KEY iš aplinkos; createXai() leidžia sukurti egzempliorių su tinkintais nustatymais. Parinktis instructions pakeičia system, kuris vis dar priimamas, bet AI SDK 7 yra pasenęs.

Srautinis perdavimas serverio pusėje

Srautiniam perdavimui naudokite streamText. Atsakymas skaitomas gabalas po gabalo iš textStream:

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

const result = streamText({
  model: xai("grok-4.7"),
  instructions: "Esi mokymų asistentas.",
  messages: [
    { role: "user", content: "Kaip veikia reliacinė duomenų bazė?" },
  ],
});

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

Kliento pusė: useChat kablis

Kablis useChat yra pagrindinis elementas sąsajoje. Jis tvarko pokalbių istoriją, srautinį perdavimą ir užklausos būseną; tačiau įvesties laukas lieka paprasta React būsena, kurią valdote patys:

"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" ? "Tu" : "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="Užduokite savo klausimą..."
          disabled={status !== "ready"}
        />
        <button type="submit" disabled={status !== "ready"}>
          Siųsti
        </button>
      </form>
    </div>
  );
}

Ką useChat tvarko automatiškai

  • Žinučių istorija: kaupia mainus; kiekviena žinutė turi parts (tekstas, įrankių iškvietimai…), rodykite tai, o ne senąjį content lauką
  • Srautinis perdavimas: rodo atsakymą jam generuojantis
  • Užklausos būsena: status yra ready, kai galima siųsti naują žinutę
  • Klaidų apdorojimas: perima tinklo ir API klaidas
  • Atšaukimas: stop() nutraukia vykstantį generavimą

Atitinkamas API maršrutas

Kablis tikisi maršruto, kuris grąžina UI žinučių srautą. Štai įgyvendinimas naudojant Next.js App Router, pagrįstas oficialiu AI SDK 7 pavyzdžiu:

// 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: "Esi pagalbinis asistentas. Atsakyk anglų kalba.",
    messages: await convertToModelMessages(messages),
  });

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

Du konvertavimai apgaubia mainus: convertToModelMessages paverčia iš kliento gautas UI žinutes modelio žinutėmis, o toUIMessageStream atlieka atvirkštinį veiksmą atsakymo sraute. Metodai toUIMessageStreamResponse() streamText rezultate vis dar veikia AI SDK 7, tačiau jie yra pasenę; o senojo toDataStreamResponse() nebeegzistuoja.

Svarbiausi punktai

  • Vercel AI SDK palaiko xAI/Grok per @ai-sdk/xai paketą
  • generateText skirta sinchroniniams atsakymams, streamText – srautiniam perdavimui
  • Kablis useChat valdo visą pokalbio būseną kliento pusėje
  • createUIMessageStreamResponse ir toUIMessageStream grąžina srautą, kurio tikisi useChat; toDataStreamResponse() nebeegzistuoja
  • Nuo @ai-sdk/xai 5 versijos tiekėjas nebepalaiko „Chat Completions“: xai() naudoja „Responses API“; norint likti prie „Chat Completions“, naudokite OpenAI SDK
  • Tiekėjas createXai() automatiškai aptinka API raktą aplinkoje