Integrointi Vercel AI SDK:hon
Tällä sivulla
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ä poistettuatoDataStreamResponse()-funktiota, ja varasuunnitelma kohdistuu malliingrok-4.7. Karttauslow/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:ää jaxai.responses()-funktiota moniagenttitilassa - Ohjaa agenttien määrää parametrilla
providerOptions.xai.reasoningEffort streamTexton ihanteellinen vuorovaikutteisiin verkkosovelluksiin- Vercel AI SDK integroituu natiivisti Next.jsään ja muihin kehyksiin
- Suunnittele varasuunnitelma vakiomallille virhetilanteiden varalle