Integrarea cu Vercel AI SDK
Pe această pagină
Actualizat la 3 noiembrie 2026, pe baza documentației AI SDK 7 și a paginii Multi-agent de la xAI:
xai()utilizează acum API-ul Responses (avertismentul din versiunea anterioară nu se mai aplică), ruta Next.js nu mai folosește funcția eliminatătoDataStreamResponse(), iar fallback-ul ținteștegrok-4.7. Maparealow/medium→ 4 agenți,high/xhigh→ 16 agenți provine din documentația xAI. Surse: AI SDK, provider xAI · xAI, Multi-agent.
Multi-agent în ecosistemul JavaScript
Vercel AI SDK (ai) a devenit standardul pentru integrarea modelelor de inteligență artificială în aplicațiile web JavaScript și TypeScript. În combinație cu providerul @ai-sdk/xai, vă oferă acces la modul multi-agent al Grok direct din Next.js, SvelteKit sau orice alt framework JavaScript, fără a părăsi abstracțiile pe care echipa dumneavoastră de front-end le cunoaște deja.
Instalare
Aveți nevoie de două pachete:
npm install ai @ai-sdk/xai
Acestea împart sarcinile: @ai-sdk/xai gestionează comunicarea cu API-ul xAI, în timp ce ai furnizează funcțiile generice generateText și streamText pe care le utilizați indiferent de provider.
Configurare de bază
import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Care sunt cele mai recente framework-uri JavaScript din 2026?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
Modul multi-agent necesită API-ul Responses de la xAI. Cu versiunile actuale (AI SDK 7 și @ai-sdk/xai 5), acesta este singurul API utilizat de provider: xai(model) trece deja prin el. Scrierea xai.responses() face această alegere explicită, protejând totodată codul care rulează pe o versiune mai veche a SDK-ului, unde xai() trecea prin Chat Completions.
Controlul numărului de agenți
Stabiliți numărul de agenți prin providerOptions.xai.reasoningEffort:
// Transmiteți ca providerOptions către generateText sau streamText
const rapide = { xai: { reasoningEffort: "low" } }; // 4 agenți
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 agenți
Maparea este aceeași pe care ați văzut-o cu OpenAI SDK: low și medium utilizează 4 agenți, în timp ce high și xhigh utilizează 16. Astfel, obțineți aceleași două moduri sub un nume diferit de parametru.
Streaming cu streamText
Într-o aplicație web, streaming-ul devine obligatoriu: o execuție de cercetare multi-agent poate dura un minut, iar nimeni nu rămâne în fața unui ecran gol atât de mult timp.
import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Analizează tendințele pieței AI în Europa",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
Într-o aplicație Next.js care folosește App Router, nici nu trebuie să consumați stream-ul pe server: o rută API îl poate returna direct către 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" },
},
});
// Stream text brut: pe client, citiți-l cu fetch,
// sau cu useChat și un TextStreamChatTransport
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
Valoarea reasoningEffort: "low" din acest exemplu este o alegere deliberată: pe o rută apelată direct din interfața utilizatorului, latența introdusă de 16 agenți ar fi greu de susținut.
Gestionarea erorilor
Deoarece multi-agent este în versiune beta, o pană de serviciu nu ar trebui să se transforme într-o pagină blocată. Modelul de mai jos prezintă cel mai simplu fallback: prindeți eroarea și repetați aceeași întrebare pe un model standard:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Întrebarea mea",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Eroare multi-agent:", error);
// Fallback pe un model standard
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "Întrebarea mea",
});
return text;
}
Fallback-ul comută pe un model standard, grok-4.7, care nu are constrângerile modului multi-agent (cu AI SDK 7, xai() utilizează de asemenea API-ul Responses). Asigurați-vă că informați utilizatorul într-un fel, deoarece răspunsul de fallback va fi mai puțin aprofundat decât cel pe care îl aștepta.
Caz de utilizare într-o aplicație web
Cazul de utilizare care valorifică cel mai bine această integrare este interfața avansată de cercetare: utilizatorul pune o întrebare complexă, aplicația dumneavoastră deschide stream-ul, iar răspunsul se scrie singur pe ecran în timp ce agenții continuă să lucreze în fundal.
Experiența rezultată este surprinzător de naturală. Textul avansează, uneori face o pauză când agenții lansează o căutare pe web, apoi reia cursul. Aceste pauze sunt departe de a fi un defect: ele îi spun utilizatorului că se desfășoară o cercetare reală—cu condiția ca interfața dumneavoastră să le asocieze un indicator vizual, în loc să sugereze o blocare.
Puncte cheie
- Utilizați
@ai-sdk/xaicuxai.responses()pentru multi-agent - Controlați numărul de agenți prin
providerOptions.xai.reasoningEffort streamTexteste ideal pentru aplicațiile web interactive- Vercel AI SDK se integrează nativ cu Next.js și alte framework-uri
- Planificați un fallback către un model standard în caz de eroare