Vercel AI SDK и интеграция с фронтенд
На тази страница
Обновено на 3 ноември 2026 г. въз основа на документацията за AI SDK 7 (
ai7.0.x,@ai-sdk/react4.x):useChatработи сDefaultChatTransportиsendMessage, съобщенията се показват чрезparts, маршрутът връщаcreateUIMessageStreamResponse,systemставаinstructions, а доставчикът@ai-sdk/xai5 вече не поддържа Chat Completions:xai()използва Responses API (кодът е проверен с TypeScript компилатор, използващai7.0.162 и@ai-sdk/xai5.0.38). Предишната версия използваше API на AI SDK 4 (input,handleSubmit,isLoading,toDataStreamResponse). Източници: AI SDK, Chatbot · AI SDK, xAI provider.
Vercel AI SDK за уеб приложения
Vercel AI SDK е TypeScript рамка, проектирана да интегрира AI модели в уеб приложения. Тя предоставя React куки (hooks), инструменти за стрийминг и единна абстракция, която поддържа нативно xAI/Grok чрез пакета @ai-sdk/xai.
Ако изграждате приложение с Next.js, Nuxt, SvelteKit или всяко React приложение, което трябва да показва стрийминг отговори, Vercel AI SDK значително опростява работата.
Инсталация
Инсталирайте основния SDK и доставчика за xAI:
npm install ai @ai-sdk/xai
Конфигурирайте своя API ключ в променливите на средата:
# .env.local
XAI_API_KEY=your-api-key
Сървърна страна: Генериране на текст
Функцията generateText е най-простият еквивалент на client.chat.create(). Има една промяна, която засяга директно този курс: от версия 5 на доставчика @ai-sdk/xai (септември 2026 г.), съвместима с AI SDK 7, доставчикът вече не поддържа крайната точка Chat Completions. xai(model) използва Responses API, което xAI вече препоръчва. Методът xai.chat(model), който някои ръководства за миграция все още цитират, съществуваше само във версия 4 на доставчика; за код, който трябва да остане на Chat Completions, използвайте вместо това OpenAI SDK, насочен към xAI (Урок 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 автоматично чете XAI_API_KEY от средата; createXai() Ви позволява да създадете инстанция с персонализирани настройки. Опцията instructions замества system, която все още се приема, но е остаряла в AI SDK 7.
Стрийминг на сървърна страна
За стрийминг използвайте streamText. Отговорът се чете парче по парче от 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);
}
Клиентска страна: Куката useChat
Куката useChat е основният елемент във фронтенда. Тя управлява историята на разговора, стрийминга и състоянието на заявката; полето за въвеждане обаче остава просто React състояние, което Вие управлявате:
"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>
);
}
Какво управлява useChat автоматично
- История на съобщенията: Натрупва размените; всяко съобщение носи
parts(текст, извиквания на инструменти…), показвайте тях, а не старото полеcontent - Стрийминг: Показва отговора, докато се генерира
- Състояние на заявката:
statusеready, когато може да се изпрати ново съобщение - Обработка на грешки: Прихваща мрежови и API грешки
- Отказ:
stop()прекъсва текущата генерация
Съответстващ API маршрут
Куката очаква маршрут, който връща поток от UI съобщения. Ето реализацията с Next.js App Router, моделирана след официалния пример за AI SDK 7:
// 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 }),
});
}
Две конверсии обгръщат размяната: convertToModelMessages трансформира UI съобщенията, получени от клиента, в моделни съобщения, а toUIMessageStream прави обратното в потока с отговори. Методите toUIMessageStreamResponse() върху резултата от streamText все още работят в AI SDK 7, но са остарели; що се отнася до стария toDataStreamResponse(), той вече не съществува.
Ключови изводи
- Vercel AI SDK поддържа xAI/Grok чрез пакета
@ai-sdk/xai generateTextза синхронни отговори,streamTextза стрийминг- Куката
useChatуправлява пълното състояние на разговора на клиента createUIMessageStreamResponseиtoUIMessageStreamвръщат потока, очакван отuseChat;toDataStreamResponse()вече не съществува- От
@ai-sdk/xai5 насам, доставчикът вече не поддържа Chat Completions:xai()използва Responses API; за да останете на Chat Completions, използвайте OpenAI SDK - Доставчикът
createXai()автоматично открива API ключа в средата