Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Integrācija ar Vercel AI SDK

Nodarbība 7 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Vairāku aģentu izmantošana JavaScript ekosistēmā
  2. Instalācija
  3. Pamata konfigurācija
  4. Aģentu skaita kontrole
  5. Straumēšana ar streamText
  6. Kļūdu apstrāde
  7. Lietošanas gadījums tīmekļa lietotnē
  8. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz AI SDK 7 dokumentāciju un xAI Multi-agent lapu: xai() tagad izmanto Responses API (brīdinājums no iepriekšējās versijas vairs nav spēkā), Next.js maršruts vairs neizmanto dzēsto toDataStreamResponse(), un rezerves variants ir paredzēts grok-4.7. Kartēšana low/medium → 4 aģenti, high/xhigh → 16 aģenti ir ņemta no xAI dokumentācijas. Avoti: AI SDK, xAI provider · xAI, Multi-agent.

Vairāku aģentu izmantošana JavaScript ekosistēmā

Vercel AI SDK (ai) ir kļuvis par standartu AI modeļu integrēšanai JavaScript un TypeScript tīmekļa lietotnēs. Apvienojumā ar @ai-sdk/xai nodrošinātāju tas ļauj piekļūt Grok vairāku aģentu režīmam no Next.js, SvelteKit vai jebkura cita JavaScript ietvara, neatstājot abstrakcijas, ko tava front-end komanda jau pazīst.

Instalācija

Tei vajadzīgas divas pakotnes:

npm install ai @ai-sdk/xai

Tās sadala darbu: @ai-sdk/xai nodrošina saziņu ar xAI API, savukārt ai piedāvā vispārīgās funkcijas generateText un streamText, ko izmanto neatkarīgi no nodrošinātāja.

Pamata konfigurācija

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

const { text } = await generateText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "Kādi ir jaunākie JavaScript ietvari 2026. gadā?",
  providerOptions: {
    xai: { reasoningEffort: "low" },
  },
});

console.log(text);

Vairāku aģentu režīms prasa xAI Responses API. Pašreizējās versijās (AI SDK 7 un @ai-sdk/xai 5) tas ir vienīgais API, ko nodrošinātājs izmanto: xai(model) jau iet caur to. Rakstot xai.responses(), tu šo izvēli padari eksplicītu, kas arī aizsargā kodu, kas darbojas pret vecāku SDK versiju, kur xai() gāja caur Chat Completions.

Aģentu skaita kontrole

Aģentu skaitu iestati, izmantojot providerOptions.xai.reasoningEffort:

// Nodod kā providerOptions funkcijām generateText vai streamText
const rapide = { xai: { reasoningEffort: "low" } };       // 4 aģenti
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 aģenti

Kartēšana ir tāda pati, ko redzēji ar OpenAI SDK: low un medium izmanto 4 aģentus, bet high un xhigh izmanto 16. Tātad tu iegūsti tos pašus divus režīmus zem cita parametra nosaukuma.

Straumēšana ar streamText

Tīmekļa lietotnē straumēšana kļūst obligāta: vairāku aģentu pētniecības izpilde var ilgt minūti, un neviens nestāvēs tik ilgi tukša ekrāna priekšā.

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

const result = streamText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "Analizē AI tirgus tendences Eiropā",
  providerOptions: {
    xai: { reasoningEffort: "medium" },
  },
});

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

Next.js lietotnē, izmantojot App Router, tev pat nav jāapstrādā straume serverī: API maršruts to var atgriezt tieši pārlūkprogrammai.

// app/api/research/route.ts
import { xai } from "@ai-sdk/xai";
import { createTextStreamResponse, streamText, toTextStream } from "ai";

export async function POST(req: Request) {
  const { query } = await req.json();

  const result = streamText({
    model: xai.responses("grok-4.20-multi-agent-0309"),
    prompt: query,
    providerOptions: {
      xai: { reasoningEffort: "low" },
    },
  });

  // Neapstrādāta teksta straume: klientā lasi to ar fetch
  // vai ar useChat un TextStreamChatTransport
  return createTextStreamResponse({
    stream: toTextStream({ stream: result.stream }),
  });
}

reasoningEffort: "low" šajā piemērā ir apzināta izvēle: maršrutā, ko izsauc tieši no lietotāja saskarnes, 16 aģentu latentums būtu grūti uzturams.

Kļūdu apstrāde

Tā kā vairāku aģentu režīms ir beta versijā, pārtraukums nedrīkst pārvērsties par bojātu lapu. Zemāk redzamais paraugs parāda vienkāršāko rezerves variantu: noķer kļūdu un atkārto to pašu jautājumu standarta modelim:

try {
  const { text } = await generateText({
    model: xai.responses("grok-4.20-multi-agent-0309"),
    prompt: "Mans jautājums",
    providerOptions: {
      xai: { reasoningEffort: "low" },
    },
  });
  return text;
} catch (error) {
  console.error("Vairāku aģentu kļūda:", error);
  // Pārej uz rezerves standarta modeli
  const { text } = await generateText({
    model: xai("grok-4.7"),
    prompt: "Mans jautājums",
  });
  return text;
}

Rezerves variants pārslēdzas uz standarta modeli grok-4.7, kam nav vairāku aģentu ierobežojumu (ar AI SDK 7 arī xai() izmanto Responses API). Noteikti informē lietotāju kādā veidā, jo rezerves atbilde būs mazāk detalizēta nekā tā, ko viņš sagaidīja.

Lietošanas gadījums tīmekļa lietotnē

Lietošanas gadījums, kas no šīs integrācijas gūst vislielāko labumu, ir uzlabota pētniecības saskarne: lietotājs uzdod sarežģītu jautājumu, tava lietotne atver straumi, un atbilde tiek rakstīta ekrānā, kamēr aģenti turpina darbu fonā.

Iegūtā pieredze ir pārsteidzoši dabiska. Teksts virzās uz priekšu, dažreiz apstājas, kad aģenti uzsāk tīmekļa meklēšanu, un pēc tam atsākās. Šīs pauzes nebūt nav trūkums: tās signalizē lietotājam, ka notiek īsta pētniecība – ar nosacījumu, ka tava saskarne tās papildina ar indikatoru, nevis liek izskatīties pēc aizķeršanās.

Galvenās atziņas

  • Izmanto @ai-sdk/xai kopā ar xai.responses() vairāku aģentu režīmam
  • Kontrolē aģentu skaitu ar providerOptions.xai.reasoningEffort
  • streamText ir ideāls interaktīvām tīmekļa lietotnēm
  • Vercel AI SDK integrējas natīvi ar Next.js un citiem ietvariem
  • Plāno rezerves variantu uz standarta modeli kļūdas gadījumā