Vercel AI SDK un integrācija ar frontendu
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz AI SDK 7 dokumentāciju (
ai7.0.x,@ai-sdk/react4.x):useChatdarbojas arDefaultChatTransportunsendMessage, ziņojumi tiek attēloti, izmantojotparts, maršruts atgriežcreateUIMessageStreamResponse,systemir aizstāts arinstructions, un@ai-sdk/xai5 nodrošinātājs vairs neatbalsta Chat Completions:xai()izmanto Responses API (kods verificēts ar TypeScript kompilatoru, izmantojotai7.0.162 un@ai-sdk/xai5.0.38). Iepriekšējā versija izmantoja AI SDK 4 API (input,handleSubmit,isLoading,toDataStreamResponse). Avoti: AI SDK, Chatbot · AI SDK, xAI provider.
Vercel AI SDK tīmekļa lietotnēm
Vercel AI SDK ir TypeScript ietvars, kas izstrādāts, lai integrētu AI modeļus tīmekļa lietotnēs. Tas nodrošina React āķus (hooks), straumēšanas utilītprogrammas un vienotu abstrakciju, kas natīvi atbalsta xAI/Grok, izmantojot pakotni @ai-sdk/xai.
Ja veido Next.js, Nuxt, SvelteKit vai jebkuru React lietotni, kurai jāattēlo straumētas atbildes, Vercel AI SDK ievērojami vienkāršo darbu.
Instalācija
Instalē galveno SDK un xAI nodrošinātāju:
npm install ai @ai-sdk/xai
Konfigurē savu API atslēgu vides mainīgajos:
# .env.local
XAI_API_KEY=your-api-key
Servera puse: teksta ģenerēšana
Funkcija generateText ir vienkāršākais ekvivalents client.chat.create(). Viena lieta ir mainījusies, un tā attiecas tieši uz šo kursu: kopš @ai-sdk/xai nodrošinātāja 5. versijas (2026. gada septembris), kas ir saderīga ar AI SDK 7, nodrošinātājs vairs neatbalsta Chat Completions galapunktu. xai(model) izmanto Responses API, ko xAI tagad iesaka. Metode xai.chat(model), ko daži migrācijas ceļveži joprojām min, eksistēja tikai nodrošinātāja 4. versijā; kodam, kam jāpaliek pie Chat Completions, tā vietā izmanto OpenAI SDK, norādot uz xAI (5. nodarbība).
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);
Nodrošinātājs xai automātiski nolasī XAI_API_KEY no vides; createXai() ļauj izveidot instanci ar pielāgotiem iestatījumiem. Opcija instructions aizstāj system, kas joprojām tiek pieņemta, bet AI SDK 7 ir uzskatāma par novecojušu.
Straumēšana servera pusē
Straumēšanai izmanto streamText. Atbilde tiek lasīta pa gabaliem no 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);
}
Klienta puse: āķis useChat
Āķis useChat ir centrālais elements frontendā. Tas apstrādā sarunu vēsturi, straumēšanu un pieprasījuma stāvokli; tomēr ievades lauks paliek vienkāršs React stāvoklis, ko pārvaldi pats:
"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>
);
}
Ko useChat apstrādā automātiski
- Ziņojumu vēsture: Uzkrāj apmaiņas; katrs ziņojums satur
parts(teksts, rīku izsaukumi utt.); attēlo šos datus, nevis veco laukucontent. - Straumēšana: Attēlo atbildi tās ģenerēšanas laikā.
- Pieprasījuma stāvoklis:
statusirready, kad var nosūtīt jaunu ziņojumu. - Kļūdu apstrāde: Pārtver tīkla un API kļūdas.
- Atcelšana:
stop()pārtrauc notiekošo ģenerēšanu.
Atbilstošais API maršruts
Āķis sagaida maršrutu, kas atgriež UI ziņojumu straumi. Lūk, implementācija, izmantojot Next.js App Router, veidota pēc oficiālā AI SDK 7 parauga:
// 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 }),
});
}
Divas konversijas aptver apmaiņu: convertToModelMessages pārveido no klienta saņemtos UI ziņojumus par modeļa ziņojumiem, bet toUIMessageStream veic pretējo darbību ar atbildes straumi. Metodes toUIMessageStreamResponse() rezultātā no streamText AI SDK 7 joprojām darbojas, taču tās ir novecojušas; savukārt vecā toDataStreamResponse() vairs neeksistē.
Galvenās atziņas
- Vercel AI SDK atbalsta xAI/Grok, izmantojot pakotni
@ai-sdk/xai. generateTextsinhronām atbildēm,streamTextstraumēšanai.- Āķis
useChatpārvalda pilnu sarunas stāvokli klienta pusē. createUIMessageStreamResponseuntoUIMessageStreamatgriež straumi, ko sagaidauseChat;toDataStreamResponse()vairs neeksistē.- Kopš
@ai-sdk/xai5. versijas nodrošinātājs vairs neatbalsta Chat Completions:xai()izmanto Responses API; lai paliktu pie Chat Completions, izmanto OpenAI SDK. - Nodrošinātājs
createXai()automātiski nosaka API atslēgu vidē.