Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Vercel AI SDK in integracija s frontendom

Lekcija 6 od 12 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Vercel AI SDK za spletne aplikacije
  2. Namestitev
  3. Strežniška stran: Generiranje besedila
  4. Pretakanje na strežniški strani
  5. Odjemalska stran: Kaveljček useChat
  6. Ustrezna pot API-ja
  7. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi dokumentacije AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): useChat deluje z DefaultChatTransport in sendMessage, sporočila se prikazujejo prek parts, pot vrača createUIMessageStreamResponse, system postane instructions, ponudnik @ai-sdk/xai 5 pa ne podpira več Chat Completions: xai() uporablja Responses API (koda preverjena s TypeScript prevajalnikom z uporabo ai 7.0.162 in @ai-sdk/xai 5.0.38). Prejšnja različica je uporabljala API AI SDK 4 (input, handleSubmit, isLoading, toDataStreamResponse). Viri: AI SDK, Chatbot · AI SDK, ponudnik xAI.

Vercel AI SDK za spletne aplikacije

Vercel AI SDK je ogrodje TypeScript, zasnovano za integracijo modelov umetne inteligence v spletne aplikacije. Zagotavlja React kaveljčke (hooks), pripomočke za pretakanje (streaming) in enotno abstrakcijo, ki izvorno podpira xAI/Grok prek paketa @ai-sdk/xai.

Če gradiš aplikacijo Next.js, Nuxt, SvelteKit ali katero koli React aplikacijo, ki mora prikazovati odzive v realnem času, ti Vercel AI SDK bistveno poenostavi delo.

Namestitev

Namesti osnovni SDK in ponudnika xAI:

npm install ai @ai-sdk/xai

Konfiguriraj svoj API ključ v spremenljivkah okolja:

# .env.local
XAI_API_KEY=tvoj-api-ključ

Strežniška stran: Generiranje besedila

Funkcija generateText je najpreprostejši ekvivalent client.chat.create(). Ena stvar se je spremenila in zadeva neposredno ta tečaj: od različice 5 ponudnika @ai-sdk/xai (september 2026), združljive z AI SDK 7, ponudnik ne podpira več končne točke Chat Completions. xai(model) uporablja Responses API, ki ga xAI zdaj priporoča. Metoda xai.chat(model), ki jo nekateri vodniki za selitev še vedno navajajo, je obstajala le v različici 4 ponudnika; za kodo, ki mora ostati na Chat Completions, namesto tega uporabi OpenAI SDK, usmerjen na xAI (Lekcija 5).

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

const { text } = await generateText({
  model: xai("grok-4.7"), // xAI Responses API
  instructions: "Si tehnični asistent.",
  prompt: "Razloži koncept kontejnerizacije.",
});

console.log(text);

Ponudnik xai samodejno prebere XAI_API_KEY iz okolja; createXai() ti omogoča ustvarjanje instance s prilagojenimi nastavitvami. Možnost instructions nadomešča system, ki je še vedno sprejeta, a v AI SDK 7 zastarela.

Pretakanje na strežniški strani

Za pretakanje uporabi streamText. Odziv se bere delček za delčkom iz textStream:

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

const result = streamText({
  model: xai("grok-4.7"),
  instructions: "Si učni asistent.",
  messages: [
    { role: "user", content: "Kako deluje relacijska baza podatkov?" },
  ],
});

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

Odjemalska stran: Kaveljček useChat

Kaveljček useChat je osrednji element na frontendu. Upravlja zgodovino pogovora, pretakanje in stanje zahtevka; vnosno polje pa ostane preprosto stanje React, ki ga upravljaš sam:

"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" ? "Ti" : "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="Postavi svoje vprašanje..."
          disabled={status !== "ready"}
        />
        <button type="submit" disabled={status !== "ready"}>
          Pošlji
        </button>
      </form>
    </div>
  );
}

Kaj useChat samodejno obravnava

  • Zgodovina sporočil: Kopiči izmenjave; vsako sporočilo nosi parts (besedilo, klici orodij …), prikaži te namesto starega polja content
  • Pretakanje: Prikazuje odziv, medtem ko se generira
  • Stanje zahtevka: status je ready, ko je mogoče poslati novo sporočilo
  • Obdelava napak: Prestreže napake omrežja in API-ja
  • Preklic: stop() prekine trenutno generiranje

Ustrezna pot API-ja

Kaveljček pričakuje pot, ki vrne tok UI sporočil. Tukaj je implementacija z Next.js App Router, modelirana po uradnem primeru 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: "Si uporaben asistent. Odgovarjaj v angleščini.",
    messages: await convertToModelMessages(messages),
  });

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

Dve pretvorbi ovijata izmenjavo: convertToModelMessages pretvori UI sporočila, prejeta od odjemalca, v sporočila modela, toUIMessageStream pa stori obratno na toku odziva. Metode toUIMessageStreamResponse() na rezultatu streamText še vedno delujejo v AI SDK 7, vendar so zastarele; kar zadeva staro toDataStreamResponse(), ta ne obstaja več.

Ključne ugotovitve

  • Vercel AI SDK podpira xAI/Grok prek paketa @ai-sdk/xai
  • generateText za sinhronizirane odzive, streamText za pretakanje
  • Kaveljček useChat upravlja celotno stanje pogovora na odjemalcu
  • createUIMessageStreamResponse in toUIMessageStream vrneta tok, ki ga pričakuje useChat; toDataStreamResponse() ne obstaja več
  • Od @ai-sdk/xai 5 ponudnik ne podpira več Chat Completions: xai() uporablja Responses API; za ostajanje na Chat Completions uporabi OpenAI SDK
  • Ponudnik createXai() samodejno zazna API ključ v okolju