Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Vercel AI SDK i integracija s frontendom

Lekcija 6 od 12 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Vercel AI SDK za web aplikacije
  2. Instalacija
  3. Serverska strana: Generiranje teksta
  4. Strujanje na serverskoj strani
  5. Klijentska strana: Hook useChat
  6. Odgovarajuća API ruta
  7. Ključne točke

Ažurirano 3. studenoga 2026. na temelju dokumentacije AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): useChat radi s DefaultChatTransport i sendMessage, poruke se prikazuju putem parts, ruta vraća createUIMessageStreamResponse, system postaje instructions, a pružatelj usluga @ai-sdk/xai 5 više ne podržava Chat Completions: xai() koristi Responses API (kod verificiran TypeScript kompajlerom koristeći ai 7.0.162 i @ai-sdk/xai 5.0.38). Prethodna verzija koristila je AI SDK 4 API (input, handleSubmit, isLoading, toDataStreamResponse). Izvori: AI SDK, Chatbot · AI SDK, xAI provider.

Vercel AI SDK za web aplikacije

Vercel AI SDK je TypeScript okvir dizajniran za integraciju AI modela u web aplikacije. Nudi React hookove, uslužne programe za strujanje (streaming) i jedinstvenu apstrakciju koja izvorno podržava xAI/Grok putem paketa @ai-sdk/xai.

Ako gradiš Next.js, Nuxt, SvelteKit ili bilo koju React aplikaciju koja treba prikazivati odgovore u stvarnom vremenu, Vercel AI SDK značajno pojednostavljuje rad.

Instalacija

Instaliraj osnovni SDK i xAI pružatelja usluga:

npm install ai @ai-sdk/xai

Konfiguriraj svoj API ključ u varijablama okruženja:

# .env.local
XAI_API_KEY=tvoj-api-kljuc

Serverska strana: Generiranje teksta

Funkcija generateText najjednostavniji je ekvivalent za client.chat.create(). Jedna se stvar promijenila, a izravno se tiče ovog tečaja: od verzije 5 pružatelja usluga @ai-sdk/xai (rujan 2026.), koja je kompatibilna s AI SDK 7, pružatelj više ne podržava krajnju točku Chat Completions. xai(model) koristi Responses API, koji xAI sada preporučuje. Metoda xai.chat(model), koju neki vodiči za migraciju još uvijek navode, postojala je samo u verziji 4 pružatelja; za kod koji mora ostati na Chat Completions, umjesto toga koristi OpenAI SDK usmjeren 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: "Ti si tehnički asistent.",
  prompt: "Objasni koncept kontejnerizacije.",
});

console.log(text);

Pružatelj xai automatski čita XAI_API_KEY iz okruženja; createXai() omogućuje ti stvaranje instance s prilagođenim postavkama. Opcija instructions zamjenjuje system, koji je još uvijek prihvaćen, ali je zastario u AI SDK 7.

Strujanje na serverskoj strani

Za strujanje koristi streamText. Odgovor se čita dio po dio iz textStream:

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

const result = streamText({
  model: xai("grok-4.7"),
  instructions: "Ti si asistent za podučavanje.",
  messages: [
    { role: "user", content: "Kako radi relacijska baza podataka?" },
  ],
});

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

Klijentska strana: Hook useChat

Hook useChat središnji je dio na frontendu. On upravlja poviješću razgovora, strujanjem i stanjem zahtjeva; međutim, polje za unos ostaje jednostavno React stanje kojim upravljaš ti:

"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 pitanje..."
          disabled={status !== "ready"}
        />
        <button type="submit" disabled={status !== "ready"}>
          Pošalji
        </button>
      </form>
    </div>
  );
}

Što useChat automatski obrađuje

  • Povijest poruka: Akumulira razmjene; svaka poruka sadrži parts (tekst, pozivi alatima…), prikazuj ove podatke umjesto starog polja content
  • Strujanje: Prikazuje odgovor dok se generira
  • Stanje zahtjeva: status je ready kada se može poslati nova poruka
  • Rukovanje greškama: Presreće mrežne i API greške
  • Otkazivanje: stop() prekida generiranje u tijeku

Odgovarajuća API ruta

Hook očekuje rutu koja vraća tok UI poruka. Evo implementacije s Next.js App Routerom, modelirane prema službenom primjeru 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: "Ti si korisni asistent. Odgovaraj na engleskom.",
    messages: await convertToModelMessages(messages),
  });

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

Dvije konverzije obavijaju razmjenu: convertToModelMessages transformira UI poruke primljene od klijenta u modelske poruke, a toUIMessageStream radi obrnuto na toku odgovora. Metode toUIMessageStreamResponse() na rezultatu streamText još uvijek rade u AI SDK 7, ali su zastarjele; što se tiče stare toDataStreamResponse(), ona više ne postoji.

Ključne točke

  • Vercel AI SDK podržava xAI/Grok putem paketa @ai-sdk/xai
  • generateText za sinkrone odgovore, streamText za strujanje
  • Hook useChat upravlja cjelokupnim stanjem razgovora na klijentu
  • createUIMessageStreamResponse i toUIMessageStream vraćaju tok koji očekuje useChat; toDataStreamResponse() više ne postoji
  • Od @ai-sdk/xai 5, pružatelj više ne podržava Chat Completions: xai() koristi Responses API; da bi ostao na Chat Completions, koristi OpenAI SDK
  • Pružatelj createXai() automatski detektira API ključ u okruženju