Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Vercel AI SDK en frontend-integratie

Les 6 van 12 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. De Vercel AI SDK voor webapplicaties
  2. Installatie
  3. Serverzijde: Tekst genereren
  4. Serverzijde streaming
  5. Clientzijde: De useChat-hook
  6. Bijbehorende API-route
  7. Belangrijkste punten

Bijgewerkt op 3 november 2026 op basis van de AI SDK 7-documentatie (ai 7.0.x, @ai-sdk/react 4.x): useChat werkt met DefaultChatTransport en sendMessage, berichten worden weergegeven via parts, de route retourneert createUIMessageStreamResponse, system wordt instructions, en de @ai-sdk/xai 5-provider ondersteunt geen Chat Completions meer: xai() gebruikt de Responses API (code geverifieerd met TypeScript-compiler gebruikmakend van ai 7.0.162 en @ai-sdk/xai 5.0.38). De vorige versie gebruikte de AI SDK 4-API (input, handleSubmit, isLoading, toDataStreamResponse). Bronnen: AI SDK, Chatbot · AI SDK, xAI-provider.

De Vercel AI SDK voor webapplicaties

De Vercel AI SDK is een TypeScript-framework ontworpen om AI-modellen te integreren in webapplicaties. Het biedt React-hooks, streaming-hulpmiddelen en een uniforme abstractie die xAI/Grok native ondersteunt via het @ai-sdk/xai-pakket.

Als u een Next.js-, Nuxt-, SvelteKit- of andere React-applicatie bouwt die streaming-responses moet weergeven, vereenvoudigt de Vercel AI SDK het werk aanzienlijk.

Installatie

Installeer de kern-SDK en de xAI-provider:

npm install ai @ai-sdk/xai

Configureer uw API-sleutel in de omgevingsvariabelen:

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

Serverzijde: Tekst genereren

De functie generateText is het eenvoudigste equivalent van client.chat.create(). Eén ding is veranderd, en dit betreft deze cursus direct: sinds versie 5 van de @ai-sdk/xai-provider (september 2026), compatibel met AI SDK 7, ondersteunt de provider het Chat Completions-eindpunt niet meer. xai(model) gebruikt de Responses API, die xAI nu aanbeveelt. De methode xai.chat(model), die sommige migratiegidsen nog steeds noemen, bestond alleen in provider-versie 4; voor code die op Chat Completions moet blijven, gebruikt u in plaats daarvan de OpenAI SDK die naar xAI wijst (Les 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);

De xai-provider leest XAI_API_KEY automatisch uit de omgeving; met createXai() kunt u een instantie met aangepaste instellingen maken. De optie instructions vervangt system, wat nog steeds wordt geaccepteerd maar verouderd is in AI SDK 7.

Serverzijde streaming

Gebruik voor streaming streamText. De respons wordt chunk voor chunk gelezen vanuit 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);
}

Clientzijde: De useChat-hook

De useChat-hook is het centrale onderdeel aan de frontend. Deze beheert conversatiegeschiedenis, streaming en aanvraagstatus; het invoerveld blijft echter een eenvoudige React-state die u zelf beheert:

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

Wat useChat automatisch afhandelt

  • Berichtengeschiedenis: Verzamelt uitwisselingen; elk bericht bevat parts (tekst, tool-aanroepen…), geef deze weer in plaats van het oude veld content
  • Streaming: Geeft de respons weer terwijl deze wordt gegenereerd
  • Aanvraagstatus: status is ready wanneer een nieuw bericht kan worden verzonden
  • Foutafhandeling: Onderschept netwerk- en API-fouten
  • Annulering: stop() onderbreekt een lopende generatie

Bijbehorende API-route

De hook verwacht een route die een stream van UI-berichten retourneert. Hier is de implementatie met de Next.js App Router, gemodelleerd naar het officiële AI SDK 7-voorbeeld:

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

Twee conversies omhullen de uitwisseling: convertToModelMessages transformeert UI-berichten die van de client zijn ontvangen naar modelberichten, en toUIMessageStream doet het omgekeerde op de responsstream. De methoden toUIMessageStreamResponse() op het streamText-resultaat werken nog steeds in AI SDK 7, maar zijn verouderd; wat de oude toDataStreamResponse() betreft, deze bestaat niet meer.

Belangrijkste punten

  • De Vercel AI SDK ondersteunt xAI/Grok via het @ai-sdk/xai-pakket
  • generateText voor synchrone responsen, streamText voor streaming
  • De useChat-hook beheert de volledige status van een conversatie op de client
  • createUIMessageStreamResponse en toUIMessageStream retourneren de stream die door useChat wordt verwacht; toDataStreamResponse() bestaat niet meer
  • Sinds @ai-sdk/xai 5 ondersteunt de provider geen Chat Completions meer: xai() gebruikt de Responses API; om op Chat Completions te blijven, gebruikt u de OpenAI SDK
  • De createXai()-provider detecteert de API-sleutel automatisch in de omgeving