Премини към основното съдържание
Български— Изберете език
Меню

Vercel AI SDK и интеграция с фронтенд

Урок 6 от 12 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Vercel AI SDK за уеб приложения
  2. Инсталация
  3. Сървърна страна: Генериране на текст
  4. Стрийминг на сървърна страна
  5. Клиентска страна: Куката useChat
  6. Съответстващ API маршрут
  7. Ключови изводи

Обновено на 3 ноември 2026 г. въз основа на документацията за AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): useChat работи с DefaultChatTransport и sendMessage, съобщенията се показват чрез parts, маршрутът връща createUIMessageStreamResponse, system става instructions, а доставчикът @ai-sdk/xai 5 вече не поддържа Chat Completions: xai() използва Responses API (кодът е проверен с TypeScript компилатор, използващ ai 7.0.162 и @ai-sdk/xai 5.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/xai 5 насам, доставчикът вече не поддържа Chat Completions: xai() използва Responses API; за да останете на Chat Completions, използвайте OpenAI SDK
  • Доставчикът createXai() автоматично открива API ключа в средата