Vercel AI SDK ir integracija su sąsaja
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d. pagal AI SDK 7 dokumentaciją (
ai7.0.x,@ai-sdk/react4.x):useChatveikia suDefaultChatTransportirsendMessage, žinutės rodomos perparts, maršrutas grąžinacreateUIMessageStreamResponse,systempakeistas įinstructions, o@ai-sdk/xai5 tiekėjas nebepalaiko „Chat Completions“:xai()naudoja „Responses API“ (kodas patikrintas TypeScript kompiliatoriumi naudojantai7.0.162 ir@ai-sdk/xai5.0.38). Ankstesnė versija naudojo AI SDK 4 API (input,handleSubmit,isLoading,toDataStreamResponse). Šaltiniai: AI SDK, Chatbot · AI SDK, xAI tiekėjas.
Vercel AI SDK žiniatinklio programoms
Vercel AI SDK yra TypeScript karkasas, sukurtas dirbtinio intelekto modeliams integruoti į žiniatinklio programas. Jis suteikia React kablius, srautinio perdavimo įrankius ir vieningą abstrakciją, kuri natūraliai palaiko xAI/Grok per @ai-sdk/xai paketą.
Jei kuriate Next.js, Nuxt, SvelteKit ar bet kurią React programą, kuriai reikia rodyti srautinius atsakymus, Vercel AI SDK žymiai supaprastina darbą.
Diegimas
Įdiekite pagrindinį SDK ir xAI tiekėją:
npm install ai @ai-sdk/xai
Sukonfigūruokite savo API raktą aplinkos kintamuosiuose:
# .env.local
XAI_API_KEY=jūsų-api-raktas
Serverio pusė: teksto generavimas
Funkcija generateText yra paprasčiausias client.chat.create() atitikmuo. Vienas dalykas pasikeitė, ir tai tiesiogiai liečia šį kursą: nuo @ai-sdk/xai tiekėjo 5 versijos (2026 m. rugsėjis), suderinamos su AI SDK 7, tiekėjas nebepalaiko „Chat Completions“ galutinio taško. xai(model) naudoja Responses API, kurį dabar rekomenduoja xAI. Metodas xai.chat(model), kurį kai kurios migracijos gairės vis dar mini, egzistavo tik 4-osios tiekėjo versijos metu; kodui, kuris turi likti prie „Chat Completions“, vietoj to naudokite xAI nukreiptą OpenAI SDK (5 pamoka).
import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";
const { text } = await generateText({
model: xai("grok-4.7"), // xAI Responses API
instructions: "Esi techninis asistentas.",
prompt: "Paaiškink konteinerizacijos sąvoką.",
});
console.log(text);
xai tiekėjas automatiškai nuskaito XAI_API_KEY iš aplinkos; createXai() leidžia sukurti egzempliorių su tinkintais nustatymais. Parinktis instructions pakeičia system, kuris vis dar priimamas, bet AI SDK 7 yra pasenęs.
Srautinis perdavimas serverio pusėje
Srautiniam perdavimui naudokite streamText. Atsakymas skaitomas gabalas po gabalo iš textStream:
import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";
const result = streamText({
model: xai("grok-4.7"),
instructions: "Esi mokymų asistentas.",
messages: [
{ role: "user", content: "Kaip veikia reliacinė duomenų bazė?" },
],
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Kliento pusė: useChat kablis
Kablis useChat yra pagrindinis elementas sąsajoje. Jis tvarko pokalbių istoriją, srautinį perdavimą ir užklausos būseną; tačiau įvesties laukas lieka paprasta React būsena, kurią valdote patys:
"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" ? "Tu" : "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="Užduokite savo klausimą..."
disabled={status !== "ready"}
/>
<button type="submit" disabled={status !== "ready"}>
Siųsti
</button>
</form>
</div>
);
}
Ką useChat tvarko automatiškai
- Žinučių istorija: kaupia mainus; kiekviena žinutė turi
parts(tekstas, įrankių iškvietimai…), rodykite tai, o ne senąjįcontentlauką - Srautinis perdavimas: rodo atsakymą jam generuojantis
- Užklausos būsena:
statusyraready, kai galima siųsti naują žinutę - Klaidų apdorojimas: perima tinklo ir API klaidas
- Atšaukimas:
stop()nutraukia vykstantį generavimą
Atitinkamas API maršrutas
Kablis tikisi maršruto, kuris grąžina UI žinučių srautą. Štai įgyvendinimas naudojant Next.js App Router, pagrįstas oficialiu AI SDK 7 pavyzdžiu:
// 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: "Esi pagalbinis asistentas. Atsakyk anglų kalba.",
messages: await convertToModelMessages(messages),
});
return createUIMessageStreamResponse({
stream: toUIMessageStream({ stream: result.stream }),
});
}
Du konvertavimai apgaubia mainus: convertToModelMessages paverčia iš kliento gautas UI žinutes modelio žinutėmis, o toUIMessageStream atlieka atvirkštinį veiksmą atsakymo sraute. Metodai toUIMessageStreamResponse() streamText rezultate vis dar veikia AI SDK 7, tačiau jie yra pasenę; o senojo toDataStreamResponse() nebeegzistuoja.
Svarbiausi punktai
- Vercel AI SDK palaiko xAI/Grok per
@ai-sdk/xaipaketą generateTextskirta sinchroniniams atsakymams,streamText– srautiniam perdavimui- Kablis
useChatvaldo visą pokalbio būseną kliento pusėje createUIMessageStreamResponseirtoUIMessageStreamgrąžina srautą, kurio tikisiuseChat;toDataStreamResponse()nebeegzistuoja- Nuo
@ai-sdk/xai5 versijos tiekėjas nebepalaiko „Chat Completions“:xai()naudoja „Responses API“; norint likti prie „Chat Completions“, naudokite OpenAI SDK - Tiekėjas
createXai()automatiškai aptinka API raktą aplinkoje