Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Vercel AI SDK un integrācija ar frontendu

Nodarbība 6 no 12 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Vercel AI SDK tīmekļa lietotnēm
  2. Instalācija
  3. Servera puse: teksta ģenerēšana
  4. Straumēšana servera pusē
  5. Klienta puse: āķis useChat
  6. Atbilstošais API maršruts
  7. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz AI SDK 7 dokumentāciju (ai 7.0.x, @ai-sdk/react 4.x): useChat darbojas ar DefaultChatTransport un sendMessage, ziņojumi tiek attēloti, izmantojot parts, maršruts atgriež createUIMessageStreamResponse, system ir aizstāts ar instructions, un @ai-sdk/xai 5 nodrošinātājs vairs neatbalsta Chat Completions: xai() izmanto Responses API (kods verificēts ar TypeScript kompilatoru, izmantojot ai 7.0.162 un @ai-sdk/xai 5.0.38). Iepriekšējā versija izmantoja AI SDK 4 API (input, handleSubmit, isLoading, toDataStreamResponse). Avoti: AI SDK, Chatbot · AI SDK, xAI provider.

Vercel AI SDK tīmekļa lietotnēm

Vercel AI SDK ir TypeScript ietvars, kas izstrādāts, lai integrētu AI modeļus tīmekļa lietotnēs. Tas nodrošina React āķus (hooks), straumēšanas utilītprogrammas un vienotu abstrakciju, kas natīvi atbalsta xAI/Grok, izmantojot pakotni @ai-sdk/xai.

Ja veido Next.js, Nuxt, SvelteKit vai jebkuru React lietotni, kurai jāattēlo straumētas atbildes, Vercel AI SDK ievērojami vienkāršo darbu.

Instalācija

Instalē galveno SDK un xAI nodrošinātāju:

npm install ai @ai-sdk/xai

Konfigurē savu API atslēgu vides mainīgajos:

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

Servera puse: teksta ģenerēšana

Funkcija generateText ir vienkāršākais ekvivalents client.chat.create(). Viena lieta ir mainījusies, un tā attiecas tieši uz šo kursu: kopš @ai-sdk/xai nodrošinātāja 5. versijas (2026. gada septembris), kas ir saderīga ar AI SDK 7, nodrošinātājs vairs neatbalsta Chat Completions galapunktu. xai(model) izmanto Responses API, ko xAI tagad iesaka. Metode xai.chat(model), ko daži migrācijas ceļveži joprojām min, eksistēja tikai nodrošinātāja 4. versijā; kodam, kam jāpaliek pie Chat Completions, tā vietā izmanto OpenAI SDK, norādot uz xAI (5. nodarbība).

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

Nodrošinātājs xai automātiski nolasī XAI_API_KEY no vides; createXai() ļauj izveidot instanci ar pielāgotiem iestatījumiem. Opcija instructions aizstāj system, kas joprojām tiek pieņemta, bet AI SDK 7 ir uzskatāma par novecojušu.

Straumēšana servera pusē

Straumēšanai izmanto streamText. Atbilde tiek lasīta pa gabaliem no 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);
}

Klienta puse: āķis useChat

Āķis useChat ir centrālais elements frontendā. Tas apstrādā sarunu vēsturi, straumēšanu un pieprasījuma stāvokli; tomēr ievades lauks paliek vienkāršs React stāvoklis, ko pārvaldi pats:

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

Ko useChat apstrādā automātiski

  • Ziņojumu vēsture: Uzkrāj apmaiņas; katrs ziņojums satur parts (teksts, rīku izsaukumi utt.); attēlo šos datus, nevis veco lauku content.
  • Straumēšana: Attēlo atbildi tās ģenerēšanas laikā.
  • Pieprasījuma stāvoklis: status ir ready, kad var nosūtīt jaunu ziņojumu.
  • Kļūdu apstrāde: Pārtver tīkla un API kļūdas.
  • Atcelšana: stop() pārtrauc notiekošo ģenerēšanu.

Atbilstošais API maršruts

Āķis sagaida maršrutu, kas atgriež UI ziņojumu straumi. Lūk, implementācija, izmantojot Next.js App Router, veidota pēc oficiālā AI SDK 7 parauga:

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

Divas konversijas aptver apmaiņu: convertToModelMessages pārveido no klienta saņemtos UI ziņojumus par modeļa ziņojumiem, bet toUIMessageStream veic pretējo darbību ar atbildes straumi. Metodes toUIMessageStreamResponse() rezultātā no streamText AI SDK 7 joprojām darbojas, taču tās ir novecojušas; savukārt vecā toDataStreamResponse() vairs neeksistē.

Galvenās atziņas

  • Vercel AI SDK atbalsta xAI/Grok, izmantojot pakotni @ai-sdk/xai.
  • generateText sinhronām atbildēm, streamText straumēšanai.
  • Āķis useChat pārvalda pilnu sarunas stāvokli klienta pusē.
  • createUIMessageStreamResponse un toUIMessageStream atgriež straumi, ko sagaida useChat; toDataStreamResponse() vairs neeksistē.
  • Kopš @ai-sdk/xai 5. versijas nodrošinātājs vairs neatbalsta Chat Completions: xai() izmanto Responses API; lai paliktu pie Chat Completions, izmanto OpenAI SDK.
  • Nodrošinātājs createXai() automātiski nosaka API atslēgu vidē.