Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Vercel AI SDK u l-Integrazzjoni mal-Frontend

Lezzjoni 6 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Il-Vercel AI SDK għall-Applikazzjonijiet Web
  2. Installazzjoni
  3. Naħa tas-Server: Ġenerazzjoni tat-Test
  4. Streaming fuq in-Naħa tas-Server
  5. Naħa tal-Klijent: Il-Hook useChat
  6. Ir-Rotta tal-API Korrispondenti
  7. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru 2026 abbażi tad-dokumentazzjoni tal-AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): useChat jaħdem ma’ DefaultChatTransport u sendMessage, il-messaġġi jintwerew permezz ta’ parts, ir-rotta tirritorna createUIMessageStreamResponse, system isir instructions, u l-provider @ai-sdk/xai 5 ma jappoġġjax aktar il-Chat Completions: xai() juża r-Responses API (kodiċi vverifikat mal-kompilatur TypeScript bl-użu ta’ ai 7.0.162 u @ai-sdk/xai 5.0.38). Il-verżjoni preċedenti kienet tuża l-API tal-AI SDK 4 (input, handleSubmit, isLoading, toDataStreamResponse). Sorsi: AI SDK, Chatbot · AI SDK, xAI provider.

Il-Vercel AI SDK għall-Applikazzjonijiet Web

Il-Vercel AI SDK huwa qafas TypeScript iddisinjat biex jintegra mudelli tal-AI f’applikazzjonijiet web. Jipprovdi hooks ta’ React, utilitajiet ta’ streaming, u astrazzjoni unifikata li tappoġġja nattivament lil xAI/Grok permezz tal-pakkett @ai-sdk/xai.

Jekk qed tibni applikazzjoni Next.js, Nuxt, SvelteKit, jew kwalunkwe applikazzjoni React li teħtieġ turi risposti f’temp reali (streaming), il-Vercel AI SDK jissimplifika x-xogħol b’mod sinifikanti.

Installazzjoni

Installa l-SDK ewlieni u l-provider ta’ xAI:

npm install ai @ai-sdk/xai

Ikkonfigura ċ-ċavetta tal-API tiegħek fil-varjabbli tal-ambjent:

# .env.local
XAI_API_KEY=your-api-key

Naħa tas-Server: Ġenerazzjoni tat-Test

Il-funzjoni generateText hija l-ekwivalenti l-aktar sempliċi ta’ client.chat.create(). Hemm affarijiet waħda li nbidlet, u taffettwa dan il-kors direttament: mill-verżjoni 5 tal-provider @ai-sdk/xai (Settembru 2026), kompatibbli mal-AI SDK 7, il-provider ma jappoġġjax aktar l-endpoint tal-Chat Completions. xai(model) juża r-Responses API, li xAI jirrakkomanda issa. Il-metodu xai.chat(model), li xi gwidi ta’ migrazzjoni għadhom jissemmu, eżista biss fil-verżjoni 4 tal-provider; għal kodiċi li jrid jibqa’ fuq il-Chat Completions, uża l-OpenAI SDK immirat lejn xAI minflok (Lezzjoni 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);

Il-provider xai jaqra awtomatikament XAI_API_KEY mill-ambjent; createXai() jippermettilek toħloq istanza b’settinji personalizzati. L-għażla instructions tissostitwixxi system, li għadha aċċettata iżda skaduta fl-AI SDK 7.

Streaming fuq in-Naħa tas-Server

Għall-streaming, uża streamText. Ir-risposta taqra biċċa biċċa minn 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);
}

Naħa tal-Klijent: Il-Hook useChat

Il-hook useChat huwa ċ-ċentru tal-attenzjoni fuq il-frontend. Jimmaniġġja l-istorja tal-konversazzjoni, l-istreaming, u l-istat tat-talba; il-qasam tal-input, madankollu, jibqa’ stat sempliċi ta’ React li timmaniġġja int:

"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>
  );
}

X’jimmaniġġja useChat Awtomatikament

  • Storja tal-messaġġi: Jakkwista l-iskambji; kull messaġġ iġorr parts (test, sejħiet ta’ għodod…), uri dawn minflok il-qasam antik content
  • Streaming: Juri r-risposta hekk kif tiġi ġġenerata
  • Stat tat-talba: status ikun ready meta tista’ tintbagħat messaġġ ġdid
  • Ġestjoni tal-iżbalji: Jinterċetta żbalji tan-netwerk u tal-API
  • Kanċellazzjoni: stop() jinterrompi ġenerazzjoni li għaddejja

Ir-Rotta tal-API Korrispondenti

Il-hook jistenna rotta li tirritorna fluss ta’ messaġġi tal-UI. Hawnhekk hija l-implimentazzjoni b’Next.js App Router, immudellata wara l-eżempju uffiċjali tal-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 }),
  });
}

Żewġ konverżjonijiet jdawru l-iskambju: convertToModelMessages tittrasforma l-messaġġi tal-UI li waslu mill-klijent f’messaġġi tal-mudell, u toUIMessageStream tagħmel l-oppost fuq l-istreaming tar-risposta. Il-metodi toUIMessageStreamResponse() fuq ir-riżultat ta’ streamText għadhom jaħdmu fl-AI SDK 7, iżda huma skaduti; fir-rigward ta’ toDataStreamResponse() antik, dan ma jeżistix aktar.

Punti Ewlenin

  • Il-Vercel AI SDK jappoġġja lil xAI/Grok permezz tal-pakkett @ai-sdk/xai
  • generateText għal risposti sinkroni, streamText għall-istreaming
  • Il-hook useChat jimmaniġġja l-istat sħiħ ta’ konversazzjoni fuq il-klijent
  • createUIMessageStreamResponse u toUIMessageStream jirritornaw l-istreaming mistenni minn useChat; toDataStreamResponse() ma jeżistix aktar
  • Minn @ai-sdk/xai 5, il-provider ma jappoġġjax aktar il-Chat Completions: xai() juża r-Responses API; biex tibqa’ fuq il-Chat Completions, uża l-OpenAI SDK
  • Il-provider createXai() jiskopri awtomatikament iċ-ċavetta tal-API fl-ambjent