Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Integrointi Vercel AI SDK:hon

Oppitunti 7 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Moniagenttisuus JavaScript-ekosysteemissä
  2. Asennus
  3. Perusasetukset
  4. Agenttien määrän ohjaus
  5. Striimaus streamText-funktiolla
  6. Virheenkäsittely
  7. Käyttötapaus verkkosovelluksessa
  8. Keskeiset asiat

Päivitetty 3. marraskuuta 2026 AI SDK 7 -dokumentaation ja xAI:n Multi-agent-sivun perusteella: xai() käyttää nyt Responses API:a (edellisen version varoitus ei enää päde), Next.js-reitti ei enää käytä poistettua toDataStreamResponse()-funktiota, ja varasuunnitelma kohdistuu malliin grok-4.7. Karttaus low/medium → 4 agenttia, high/xhigh → 16 agenttia perustuu xAI:n dokumentaatioon. Lähteet: AI SDK, xAI provider · xAI, Multi-agent.

Moniagenttisuus JavaScript-ekosysteemissä

Vercel AI SDK (ai) on vakiinnuttanut asemansa standardina tekoälymallien integroinnissa JavaScript- ja TypeScript-pohjaisiin verkkosovelluksiin. Yhdessä @ai-sdk/xai-palveluntarjoajan kanssa se antaa sinulle pääsyn Grokin moniagenttitilaan Next.js:ssä, SvelteKitissä tai missä tahansa muussa JavaScript-kehyksessä poistumatta abstraktioista, joita front end -tiimisi jo tuntee.

Asennus

Tarvitset kaksi pakettia:

npm install ai @ai-sdk/xai

Ne jakavat työn: @ai-sdk/xai hoitaa viestinnän xAI API:n kanssa, kun taas ai tarjoaa yleiskäyttöiset generateText- ja streamText-funktiot, joita käytät palveluntarjoajasta riippumatta.

Perusasetukset

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

const { text } = await generateText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "Mitkä ovat vuoden 2026 uusimmat JavaScript-kehykset?",
  providerOptions: {
    xai: { reasoningEffort: "low" },
  },
});

console.log(text);

Moniagenttisuus vaatii xAI:n Responses API:a. Nykyisillä versioilla (AI SDK 7 ja @ai-sdk/xai 5) se on ainoa API, jota palveluntarjoaja käyttää: xai(model) kulkee sen kautta jo oletuksena. Funktion kirjoittaminen muodossa xai.responses() tekee tämän valinnan eksplisiittiseksi, mikä suojaa myös koodia, joka suoritetaan vanhempaa SDK-versiota vasten, jossa xai() kulki Chat Completions -rajapinnan kautta.

Agenttien määrän ohjaus

Määrität agenttien määrän parametrilla providerOptions.xai.reasoningEffort:

// Välitä generateText- tai streamText-funktiolle providerOptions-objektina
const rapide = { xai: { reasoningEffort: "low" } };       // 4 agenttia
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 agenttia

Karttaus on sama, jonka näit OpenAI SDK:n kohdalla: low ja medium käyttävät 4 agenttia, kun taas high ja xhigh käyttävät 16. Saat siis samat kaksi tilaa eri parametrinimen alla.

Striimaus streamText-funktiolla

Verkkosovelluksessa striimaus on pakollista: moniagenttinen tutkimusajo voi kestää minuutin, eikä kukaan jaksa odottaa tyhjän näytön edessä niin kauan.

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

const result = streamText({
  model: xai.responses("grok-4.20-multi-agent-0309"),
  prompt: "Analysoi tekoälymarkkinoiden trendejä Euroopassa",
  providerOptions: {
    xai: { reasoningEffort: "medium" },
  },
});

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

App Routeria käyttävässä Next.js-sovelluksessa sinun ei edes tarvitse kuluttaa striimiä palvelimella: API-reitti voi palauttaa sen suoraan selaimelle.

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

  // Raaka tekstistriimi: lue se asiakaspuolella fetchillä
  // tai käytä useChat-hookkia ja TextStreamChatTransportia
  return createTextStreamResponse({
    stream: toTextStream({ stream: result.stream }),
  });
}

Tässä esimerkissä reasoningEffort: "low" on tietoinen valinta: reitillä, jota kutsutaan suoraan käyttöliittymästä, 16 agentin aiheuttama viive olisi vaikea ylläpitää.

Virheenkäsittely

Koska moniagenttisuus on beetavaiheessa, palvelukatkos ei saisi johtaa rikkinäiseen sivuun. Alla oleva malli esittää yksinkertaisimman varasuunnitelman: sieppaa virhe ja toista sama kysymys vakiomallilla.

try {
  const { text } = await generateText({
    model: xai.responses("grok-4.20-multi-agent-0309"),
    prompt: "Kysymykseni",
    providerOptions: {
      xai: { reasoningEffort: "low" },
    },
  });
  return text;
} catch (error) {
  console.error("Moniagenttivirhe:", error);
  // Siirry vakiomalliin
  const { text } = await generateText({
    model: xai("grok-4.7"),
    prompt: "Kysymykseni",
  });
  return text;
}

Varasuunnitelma vaihtaa vakiomalliin grok-4.7, jolla ei ole moniagenttitilan rajoituksia (AI SDK 7:ssä myös xai() käyttää Responses API:a). Ilmoita käyttäjälle tavalla tai toisella tilanteesta, sillä varasuunnitelman antama vastaus on vähemmän perusteellinen kuin mitä hän odotti.

Käyttötapaus verkkosovelluksessa

Tämä integraatio tuottaa suurimman hyödyn edistyneessä tutkimuskäyttöliittymässä: käyttäjä esittää monimutkaisen kysymyksen, sovelluksesi avaa striimin ja vastaus kirjoittuu näytölle samalla kun agentit jatkavat työskentelyä taustalla.

Tuloksena oleva kokemus on yllättävän luonteva. Teksti etenee, joskus pysähtyy agenttien käynnistäessä verkkohakua ja jatkuu sen jälkeen. Nämä tauot eivät ole virhe: ne kertovat käyttäjälle, että todellinen tutkimus on käynnissä – edellyttäen että käyttöliittymäsi yhdistää ne indikaattoriin sen sijaan, että ne näyttäisivät jumitukselta.

Keskeiset asiat

  • Käytä @ai-sdk/xai:ää ja xai.responses()-funktiota moniagenttitilassa
  • Ohjaa agenttien määrää parametrilla providerOptions.xai.reasoningEffort
  • streamText on ihanteellinen vuorovaikutteisiin verkkosovelluksiin
  • Vercel AI SDK integroituu natiivisti Next.jsään ja muihin kehyksiin
  • Suunnittele varasuunnitelma vakiomallille virhetilanteiden varalle