Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Vercel AI SDK ja frontend-integraatio

Oppitunti 6 / 12 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Vercel AI SDK verkkosovelluksille
  2. Asennus
  3. Palvelinpuoli: Tekstin generointi
  4. Palvelinpuolen suoratoisto
  5. Asiakaspuoli: useChat-hookki
  6. Vastaava API-reitti
  7. Keskeiset asiat

Päivitetty 3. marraskuuta 2026 AI SDK 7 -dokumentaation (ai 7.0.x, @ai-sdk/react 4.x) perusteella: useChat toimii DefaultChatTransport- ja sendMessage-menetelmillä, viestit näytetään parts-kentän kautta, reitti palauttaa createUIMessageStreamResponse-vastauksen, system on korvattu instructions-asetuksella, eikä @ai-sdk/xai 5 -palveluntarjoaja enää tue Chat Completions -rajapintaa: xai() käyttää Responses APIa (koodi varmistettu TypeScript-kääntäjällä versioilla ai 7.0.162 ja @ai-sdk/xai 5.0.38). Edellinen versio käytti AI SDK 4 -rajapintaa (input, handleSubmit, isLoading, toDataStreamResponse). Lähteet: AI SDK, Chatbot · AI SDK, xAI-palveluntarjoaja.

Vercel AI SDK verkkosovelluksille

Vercel AI SDK on TypeScript-kehys, joka on suunniteltu integroimaan tekoälymalleja verkkosovelluksiin. Se tarjoaa React-hookkeja, suoratoistoapuvälineitä ja yhtenäisen abstraktion, joka tukee natiivisti xAI/Grok-palveluita @ai-sdk/xai-paketin kautta.

Jos rakennat Next.js-, Nuxt-, SvelteKit- tai mitä tahansa React-sovellusta, jonka tarvitsee näyttää suoratoistettavia vastauksia, Vercel AI SDK helpottaa työtä merkittävästi.

Asennus

Asenna ydin-SDK ja xAI-palveluntarjoaja:

npm install ai @ai-sdk/xai

Määritä API-avain ympäristömuuttujiin:

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

Palvelinpuoli: Tekstin generointi

generateText-funktio on yksinkertaisin vastine client.chat.create()-metodille. Yksi asia on muuttunut, ja se koskee suoraan tätä kurssia: @ai-sdk/xai-palveluntarjoajan versiosta 5 (syyskuu 2026) lähtien, joka yhteensopiva AI SDK 7:n kanssa, palveluntarjoaja ei enää tue Chat Completions -päätepistettä. xai(model) käyttää Responses APIa, jota xAI nyt suosittelee. xai.chat(model)-metodi, jota jotkin migraatio-oppaat edelleen mainitsevat, oli olemassa vain palveluntarjoajan versiossa 4; koodille, jonka täytyy pysyä Chat Completions -rajapinnassa, käytä sen sijaan xAI:hon osoitettua OpenAI SDK:ta (oppitunti 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);

xai-palveluntarjoaja lukee XAI_API_KEY-avaimen automaattisesti ympäristöstä; createXai() mahdollistaa instanssin luomisen mukautetuilla asetuksilla. instructions-asetus korvaa system-asetuksen, joka hyväksytään edelleen, mutta on vanhentunut AI SDK 7:ssä.

Palvelinpuolen suoratoisto

Käytä suoratoistoon streamText-funktiota. Vastaus luetaan pala kerrallaan textStream-virrasta:

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

Asiakaspuoli: useChat-hookki

useChat-hookki on frontendin keskeisin osa. Se hallitsee keskusteluhistoriaa, suoratoistoa ja pyynnön tilaa; syöttökenttä on kuitenkin yksinkertainen React-tila, jota hallinnoit itse:

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

Mitä useChat hoitaa automaattisesti

  • Viestihistoria: Kerää vuorovaikutukset; jokainen viesti sisältää parts-kentän (teksti, työkalukutsut jne.), näytä nämä vanhan content-kentän sijaan.
  • Suoratoisto: Näyttää vastauksen sitä mukaa kun se generoituu.
  • Pyynnön tila: status on ready, kun uusi viesti voidaan lähettää.
  • Virheenkäsittely: Sieppaa verkko- ja API-virheet.
  • Peruutus: stop() keskeyttää käynnissä olevan generoinnin.

Vastaava API-reitti

Hookki odottaa reittiä, joka palauttaa UI-viestien virran. Tässä on toteutus Next.js App Routerilla, mallinnettu virallisen AI SDK 7 -esimerkin mukaan:

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

Kaksi muunnosta kietoo vuorovaikutuksen: convertToModelMessages muuntaa asiakkaalta vastaanotetut UI-viestit malliviesteiksi, ja toUIMessageStream tekee käänteisen muunnoksen vastausvirralle. streamText-tuloksen toUIMessageStreamResponse()-metodit toimivat edelleen AI SDK 7:ssä, mutta ne ovat vanhentuneita; vanha toDataStreamResponse() ei ole enää olemassa.

Keskeiset asiat

  • Vercel AI SDK tukee xAI/Grok-palveluita @ai-sdk/xai-paketin kautta
  • generateText synkronisiin vastauksiin, streamText suoratoistoon
  • useChat-hookki hallitsee koko keskustelun tilan asiakaspuolella
  • createUIMessageStreamResponse ja toUIMessageStream palauttavat useChat-hookin odottaman virran; toDataStreamResponse() ei ole enää olemassa
  • @ai-sdk/xai versiosta 5 lähtien palveluntarjoaja ei enää tue Chat Completions -rajapintaa: xai() käyttää Responses APIa; pysyäksesi Chat Completionsissa käytä OpenAI SDK:ta
  • createXai()-palveluntarjoaja havaitsee API-avaimen automaattisesti ympäristöstä