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

Integrazzjoni mal-Vercel AI SDK

Lezzjoni 7 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Multi-agent fl-ekosistema JavaScript
  2. Installazzjoni
  3. Konfigurazzjoni bażika
  4. Kontroll tan-numru ta’ aġenti
  5. Streaming b’streamText
  6. Ġestjoni tal-iżbalji
  7. Każ ta’ użu f’applikazzjoni web
  8. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026, ibbażat fuq id-dokumentazzjoni tal-AI SDK 7 u l-paġna Multi-agent ta’ xAI: xai() issa tuża r-Responses API (it-twissija mill-verżjoni preċedenti ma tapplikax aktar), ir-route ta’ Next.js ma tużax il-funzjoni mneħħija toDataStreamResponse(), u l-fallback jimmira lejn grok-4.7. Il-mappatura low/medium → 4 aġenti, high/xhigh → 16-il aġent tiġi mid-dokumentazzjoni ta’ xAI. Sorsi: AI SDK, xAI provider · xAI, Multi-agent.

Multi-agent fl-ekosistema JavaScript

Il-Vercel AI SDK (ai) sar standard għall-integrazzjoni ta’ mudelli tal-AI f’applikazzjonijiet web JavaScript u TypeScript. Meta tingħaqad mal-provider @ai-sdk/xai, tagħtik aċċess għall-modalità multi-agent ta’ Grok minn Next.js, SvelteKit, jew kwalunkwe qafas JavaScript ieħor, mingħajr ma toħroġ mill-astrazzjonijiet li t-tim tal-front-end tiegħek diġà jaf.

Installazzjoni

Għandek bżonn żewġ pakketti:

npm install ai @ai-sdk/xai

Huma jaqsmu x-xogħol: @ai-sdk/xai jimmaniġġja l-komunikazzjoni mal-API ta’ xAI, filwaqt li ai jipprovdi l-funzjonijiet ġeneriċi generateText u streamText li tuża irrispettivament mill-provider.

Konfigurazzjoni bażika

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

const { text } = await generateText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "X'inhu l-aħħar frameworks JavaScript tal-2026?",
  providerOptions: {
    xai: { reasoningEffort: "low" },
  },
});

console.log(text);

Il-multi-agent jeħtieġ ir-Responses API ta’ xAI. Bil-verżjonijiet attwali (AI SDK 7 u @ai-sdk/xai 5), din hija l-unika API li l-provider juża: xai(model) diġà tgħaddi minnha. Il-kitba ta’ xai.responses() tagħmel dik il-għażla espliċita, li tipproteġi wkoll il-kodiċi li qed jiġi eżegwit kontra verżjoni eqdem tal-SDK fejn xai() kienet tgħaddi mill-Chat Completions.

Kontroll tan-numru ta’ aġenti

Tistabbilixxi n-numru ta’ aġenti b’providerOptions.xai.reasoningEffort:

// Għaddiha bħala providerOptions lil generateText jew streamText
const rapide = { xai: { reasoningEffort: "low" } };       // 4 aġenti
const approfondie = { xai: { reasoningEffort: "high" } }; // 16-il aġent

Il-mappatura hija l-istess waħda li rajt mas-SDK ta’ OpenAI: low u medium jużaw 4 aġenti, filwaqt li high u xhigh jużaw 16-il aġent. Allura tikseb l-istess żewġ modalitajiet taħt isem ta’ parametru differenti.

Streaming b’streamText

F’applikazzjoni web, l-istreaming isir obbligatorju: sessjoni ta’ riċerka multi-agent tista’ tieħu minuta, u ħadd ma jibqa’ quddiem skrin vojt daqshekk.

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

const result = streamText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "Analizza x-xejriet tas-suq tal-AI fl-Ewropa",
  providerOptions: {
    xai: { reasoningEffort: "medium" },
  },
});

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

F’applikazzjoni Next.js li tuża l-App Router, m’għandekx għalfejn tikkonsma l-istreaming fuq is-server: route tal-API tista’ tirritornah direttament lill-browser.

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

  // Raw text stream: fuq il-klijent, aqrah b'fetch,
  // jew b'useChat u TextStreamChatTransport
  return createTextStreamResponse({
    stream: toTextStream({ stream: result.stream }),
  });
}

Ir-reasoningEffort: "low" f’dan l-eżempju huwa għażla deliberata: fuq route msejjaħ direttament mill-UI, il-latency ta’ 16-il aġent tkun diffiċli biex tinżamm.

Ġestjoni tal-iżbalji

Peress li l-multi-agent qiegħed fil-beta, ħsara fis-servizz m’għandhiex issir paġna miksura. Il-mudell hawn taħt juri l-aktar fallback sempliċi: qbad l-iżball u erġa’ għamel l-istess mistoqsija fuq mudell standard:

try {
  const { text } = await generateText({
    model: xai.responses("grok-4.20-multi-agent-0309"),
    prompt: "Il-mistoqsija tiegħi",
    providerOptions: {
      xai: { reasoningEffort: "low" },
    },
  });
  return text;
} catch (error) {
  console.error("Żball multi-agent:", error);
  // Mur lura għal mudell standard
  const { text } = await generateText({
    model: xai("grok-4.7"),
    prompt: "Il-mistoqsija tiegħi",
  });
  return text;
}

Il-fallback ibiddel għal mudell standard, grok-4.7, li m’għandux il-limitazzjonijiet tal-multi-agent (mal-AI SDK 7, xai() tuża wkoll ir-Responses API). Ħalli lill-utent tiegħek jaf b’xi mod ukoll, għax it-tweġiba tal-fallback tkun inqas dettaljata minn dik li kien jistenna.

Każ ta’ użu f’applikazzjoni web

Il-każ ta’ użu li joħroġ l-aħjar minn din l-integrazzjoni huwa l-interfaċċa avvanzata tar-riċerka: l-utent jagħmel mistoqsija kumplessa, l-applikazzjoni tiegħek tiftaħ l-istreaming, u t-tweġiba tikteb lilha nnifisha fuq l-iskrin filwaqt li l-aġenti jkomplu jaħdmu fl-isfond.

L-esperjenza li tirriżulta hija sorprendentement naturali. It-test javvanza, kultant jieqaf meta l-aġenti jneddu tfittxija fuq il-web, imbagħad ikompli. Dawn il-waqfiet huma ‘l bogħod milli jkunu difett: jgħidu lill-utent li qed issir riċerka reali—sakemm l-interfaċċa tiegħek tgħaqqadhom ma’ indikatur minflok ma tagħmilhom jidhru bħala tfixkil.

Punti Ewlenin

  • Uża @ai-sdk/xai ma’ xai.responses() għall-multi-agent
  • Ikkontrolla n-numru ta’ aġenti b’providerOptions.xai.reasoningEffort
  • streamText huwa ideali għal applikazzjonijiet web interattivi
  • Il-Vercel AI SDK jintegra nativament ma’ Next.js u qafas oħra
  • Ippjana fallback għal mudell standard fil-każ ta’ żball