Salt la conținutul principal
Română— Alege o limbă
Meniu

Integrarea cu Vercel AI SDK

Lecția 7 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Multi-agent în ecosistemul JavaScript
  2. Instalare
  3. Configurare de bază
  4. Controlul numărului de agenți
  5. Streaming cu streamText
  6. Gestionarea erorilor
  7. Caz de utilizare într-o aplicație web
  8. Puncte cheie

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ște grok-4.7. Maparea low/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/xai cu xai.responses() pentru multi-agent
  • Controlați numărul de agenți prin providerOptions.xai.reasoningEffort
  • streamText este 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