Vercel AI SDK ja frontend-integraatio
Tällä sivulla
Päivitetty 3. marraskuuta 2026 AI SDK 7 -dokumentaation (
ai7.0.x,@ai-sdk/react4.x) perusteella:useChattoimiiDefaultChatTransport- jasendMessage-menetelmillä, viestit näytetäänparts-kentän kautta, reitti palauttaacreateUIMessageStreamResponse-vastauksen,systemon korvattuinstructions-asetuksella, eikä@ai-sdk/xai5 -palveluntarjoaja enää tue Chat Completions -rajapintaa:xai()käyttää Responses APIa (koodi varmistettu TypeScript-kääntäjällä versioillaai7.0.162 ja@ai-sdk/xai5.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ä vanhancontent-kentän sijaan. - Suoratoisto: Näyttää vastauksen sitä mukaa kun se generoituu.
- Pyynnön tila:
statusonready, 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 generateTextsynkronisiin vastauksiin,streamTextsuoratoistoonuseChat-hookki hallitsee koko keskustelun tilan asiakaspuolellacreateUIMessageStreamResponsejatoUIMessageStreampalauttavatuseChat-hookin odottaman virran;toDataStreamResponse()ei ole enää olemassa@ai-sdk/xaiversiosta 5 lähtien palveluntarjoaja ei enää tue Chat Completions -rajapintaa:xai()käyttää Responses APIa; pysyäksesi Chat Completionsissa käytä OpenAI SDK:tacreateXai()-palveluntarjoaja havaitsee API-avaimen automaattisesti ympäristöstä