Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Vercel AI SDK agus Comhtháthú Frontend

Ceacht 6 as 12 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Vercel AI SDK do Fheidhmchláir Ghréasáin
  2. Suiteáil
  3. Taobh Freastalaí: Téacs a Ghiniúint
  4. Sruthú ar Thaobh an Fhreastalaí
  5. Taobh an Chliaint: An Hook useChat
  6. An Rútar API Comhfhreagrach
  7. Príomhphointí

Nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú AI SDK 7 (ai 7.0.x, @ai-sdk/react 4.x): oibríonn useChat le DefaultChatTransport agus sendMessage, taispeántar teachtaireachtaí trí parts, filleann an rútar createUIMessageStreamResponse, éiríonn system ina instructions, agus ní thacaíonn an soláthraí @ai-sdk/xai 5 le Chat Completions a thuilleadh: úsáideann xai() an Responses API (fíoraíodh an cód le tiomsaitheoir TypeScript ag baint úsáide as ai 7.0.162 agus @ai-sdk/xai 5.0.38). Bhain an leagan roimhe seo úsáid as API AI SDK 4 (input, handleSubmit, isLoading, toDataStreamResponse). Foinse: AI SDK, Chatbot · AI SDK, soláthraí xAI.

Vercel AI SDK do Fheidhmchláir Ghréasáin

Is creatlach TypeScript é Vercel AI SDK atá deartha chun samhlacha AI a chomhtháthú i bhfeidhmchláir ghréasáin. Soláthraíonn sé hookanna React, áiseanna sruthaithe, agus teibíocht aontaithe a thacaíonn go dúchasach le xAI/Grok tríd an bpacáiste @ai-sdk/xai.

Má tá tú ag tógáil feidhmchláir Next.js, Nuxt, SvelteKit, nó aon fheidhmchlár React a bhfuil gá aige le freagairtí sruthaithe a thaispeáint, déanann Vercel AI SDK an obair i bhfad níos simplí.

Suiteáil

Suiteáil an SDK bunúsach agus an soláthraí xAI:

npm install ai @ai-sdk/xai

Cumraigh do eochair API sna hathróga timpeallachta:

# .env.local
XAI_API_KEY=do-eochair-api

Taobh Freastalaí: Téacs a Ghiniúint

Is é an fheidhm generateText an coibhéis is simplí de client.chat.create(). Tá rud amháin athraithe, agus baineann sé go díreach leis an gcúrsa seo: ó leagan 5 den soláthraí @ai-sdk/xai (Meán Fómhair 2026), atá comhoiriúnach le AI SDK 7, ní thacaíonn an soláthraí leis an bpointe deiridh Chat Completions a thuilleadh. Úsáideann xai(model) an Responses API, a mholann xAI anois. Ní raibh an modh xai.chat(model), a luaann roinnt treoracha imirce fós, ann ach i leagan 4 den soláthraí; maidir le cód nach mór a choinneáil ar Chat Completions, úsáid an OpenAI SDK atá dírithe ar xAI ina ionad sin (Ceacht 5).

import { generateText } from "ai";
import { xai } from "@ai-sdk/xai";

const { text } = await generateText({
  model: xai("grok-4.7"), // xAI Responses API
  instructions: "Is tú cúntóir teicniúil.",
  prompt: "Mínigh coincheap na gcoimeádán.",
});

console.log(text);

Léann an soláthraí xai XAI_API_KEY go huathoibríoch ón timpeallacht; ligeann createXai() duit sampla a chruthú le socruithe saincheaptha. Cuireann an rogha instructions in ionad system, a nglactar leis fós ach atá as dáta in AI SDK 7.

Sruthú ar Thaobh an Fhreastalaí

Chun sruthú a dhéanamh, úsáid streamText. Léann an fhreagairt píosa ar phíosa ó textStream:

import { streamText } from "ai";
import { xai } from "@ai-sdk/xai";

const result = streamText({
  model: xai("grok-4.7"),
  instructions: "Is tú cúntóir teagaisc.",
  messages: [
    { role: "user", content: "Conas a oibríonn bunachar sonraí gaolmhar?" },
  ],
});

for await (const chunk of result.textStream) {
  process.stdout.write(chunk);
}

Taobh an Chliaint: An Hook useChat

Is é an hook useChat an phríomhghné ar an bhfrontend. Déileálann sé le stair na comhráite, leis an sruthú, agus le stát na n-iarratas; fanann an réimse ionchuir, áfach, ina stát React simplí a bhainistíonn tusa féin:

"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" ? "Tusa" : "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="Cuir do cheist..."
          disabled={status !== "ready"}
        />
        <button type="submit" disabled={status !== "ready"}>
          Seol
        </button>
      </form>
    </div>
  );
}

Cad a Láimhseálann useChat go Huathoibríoch

  • Stair na dteachtaireachtaí: Carnann sé malartuithe; iompraíonn gach teachtaireacht parts (téacs, glaonna uirlisí…), taispeáin iad seo seachas an seanghalla content
  • Sruthú: Taispeánann sé an fhreagairt de réir mar a ghintear í
  • Stát an iarratais: Tá status mar ready nuair is féidir teachtaireacht nua a sheoladh
  • Láimhseáil earráidí: Gabhann sé earráidí líonra agus API
  • Cealú: Briseann stop() giniúint atá ar siúl

An Rútar API Comhfhreagrach

Tá súil ag an hook le rútar a fhilleann sruth de theachtaireachtaí UI. Seo an cur i bhfeidhm le Next.js App Router, samhaltaithe ar shampla oifigiúil 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: "Is tú cúntóir cabhrach. Freagair i mBéarla.",
    messages: await convertToModelMessages(messages),
  });

  return createUIMessageStreamResponse({
    stream: toUIMessageStream({ stream: result.stream }),
  });
}

Cuimsíonn dhá thiontú an malartú: déanann convertToModelMessages teachtaireachtaí UI a fuarthas ón gcliant a thiontú ina dteachtaireachtaí samhaltacha, agus déanann toUIMessageStream an rud céanna ar ais ar an sruth freagartha. Fós oibríonn na modhanna toUIMessageStreamResponse() ar an toradh streamText in AI SDK 7, ach tá siad as dáta; maidir leis an sean toDataStreamResponse(), níl sé ann a thuilleadh.

Príomhphointí

  • Tacaíonn Vercel AI SDK le xAI/Grok tríd an bpacáiste @ai-sdk/xai
  • generateText le haghaidh freagairtí comhthreomhara, streamText le haghaidh sruthaithe
  • Bainistíonn an hook useChat stát iomlán comhrá ar an gcliant
  • Filleann createUIMessageStreamResponse agus toUIMessageStream an sruth a bhfuil súil ag useChat leis; níl toDataStreamResponse() ann a thuilleadh
  • Ó @ai-sdk/xai 5, ní thacaíonn an soláthraí le Chat Completions a thuilleadh: úsáideann xai() an Responses API; chun fanacht ar Chat Completions, úsáid an OpenAI SDK
  • Braitheann an soláthraí createXai() an eochair API sa timpeallacht go huathoibríoch