Integrace s Vercel AI SDK
Na této stránce
Aktualizováno 3. listopadu 2026 na základě dokumentace AI SDK 7 a stránky Multi-agent od xAI:
xai()nyní využívá Responses API (varování z předchozí verze již neplatí), trasa v Next.js již nepoužívá odstraněnou funkcitoDataStreamResponse()a záložní řešení cílí nagrok-4.7. Mapovánílow/medium→ 4 agenti,high/xhigh→ 16 agentů vychází z dokumentace xAI. Zdroje: AI SDK, poskytovatel xAI · xAI, Multi-agent.
Multi-agent v ekosystému JavaScriptu
Vercel AI SDK (ai) se stalo standardem pro integraci modelů umělé inteligence do webových aplikací v JavaScriptu a TypeScriptu. V kombinaci s poskytovatelem @ai-sdk/xai ti umožňuje přístup k režimu multi-agent modelu Grok přímo z prostředí Next.js, SvelteKit nebo jakéhokoli jiného JavaScriptového frameworku, aniž bys musel opustit abstrakce, které tvůj front-end tým již dobře zná.
Instalace
Budeš potřebovat dva balíčky:
npm install ai @ai-sdk/xai
Rozdělují si práci: @ai-sdk/xai se stará o komunikaci s API xAI, zatímco ai poskytuje obecné funkce generateText a streamText, které používáš bez ohledu na konkrétního poskytovatele.
Základní konfigurace
import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Jaké jsou nejnovější JavaScriptové frameworky roku 2026?",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
console.log(text);
Režim multi-agent vyžaduje Responses API od xAI. U současných verzí (AI SDK 7 a @ai-sdk/xai 5) je to jediné API, které tento poskytovatel využívá: xai(model) již přes něj probíhá. Zápis xai.responses() tuto volbu činí explicitní, což také chrání kód běžící proti starší verzi SDK, kde xai() procházelo přes Chat Completions.
Řízení počtu agentů
Počet agentů nastavuješ pomocí providerOptions.xai.reasoningEffort:
// Předáno jako providerOptions do generateText nebo streamText
const rapide = { xai: { reasoningEffort: "low" } }; // 4 agenti
const approfondie = { xai: { reasoningEffort: "high" } }; // 16 agentů
Mapování je stejné, jaké jsi viděl u OpenAI SDK: low a medium využívají 4 agenty, zatímco high a xhigh využívají 16 agentů. Získáváš tak stejné dva režimy pod jiným názvem parametru.
Streamování pomocí streamText
Ve webové aplikaci se streamování stává nezbytností: běh výzkumu s více agenty může trvat minutu a nikdo nevydrží tak dlouho koukat na prázdnou obrazovku.
import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";
const result = streamText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Analyzuj trendy na trhu s AI v Evropě",
providerOptions: {
xai: { reasoningEffort: "medium" },
},
});
for await (const chunk of result.textStream) {
process.stdout.write(chunk);
}
V aplikaci Next.js využívající App Router nemusíš stream ani konsumovat na serveru: API trasa jej může vrátit přímo do prohlížeče.
// 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" },
},
});
// Surový textový stream: na klientovi jej čti pomocí fetch
// nebo s useChat a TextStreamChatTransport
return createTextStreamResponse({
stream: toTextStream({ stream: result.stream }),
});
}
Hodnota reasoningEffort: "low" v tomto příkladu je záměrná volba: u trasy volané přímo z uživatelského rozhraní by latenci 16 agentů bylo těžké udržet.
Zpracování chyb
Protože je multi-agent stále v beta verzi, výpadek by neměl vést k nefunkční stránce. Níže uvedený vzor ukazuje nejjednodušší záložní řešení: zachyť chybu a znovu zahraj stejnou otázku na standardním modelu:
try {
const { text } = await generateText({
model: xai.responses("grok-4.20-multi-agent-0309"),
prompt: "Moje otázka",
providerOptions: {
xai: { reasoningEffort: "low" },
},
});
return text;
} catch (error) {
console.error("Chyba multi-agent:", error);
// Přepnutí na standardní model
const { text } = await generateText({
model: xai("grok-4.7"),
prompt: "Moje otázka",
});
return text;
}
Záložní řešení přepne na standardní model grok-4.7, který nemá omezení režimu multi-agent (s AI SDK 7 používá xai() také Responses API). Nezapomeň uživatele nějakým způsobem informovat, protože odpověď ze záložního modelu bude méně důkladná, než očekával.
Využití ve webové aplikaci
Případ použití, který z této integrace vytěží nejvíce, je pokročilé rozhraní pro výzkum: uživatel položí složitou otázku, tvá aplikace otevře stream a odpověď se sama vypisuje na obrazovku, zatímco agenti pokračují v práci na pozadí.
Výsledná zkušenost je překvapivě přirozená. Text postupuje, někdy se zastaví, když agenti spustí vyhledávání na webu, a poté pokračuje. Tyto pauzy nejsou chybou: dávají uživateli najevo, že probíhá skutečný výzkum – za předpokladu, že je ve tvém rozhraní doplníš indikátorem, aby nevypadaly jako zaseknutí.
Klíčové poznatky
- Pro multi-agent používej
@ai-sdk/xaisxai.responses() - Počet agentů řiď pomocí
providerOptions.xai.reasoningEffort streamTextje ideální pro interaktivní webové aplikace- Vercel AI SDK se nativně integruje s Next.js a dalšími frameworky
- Naplánuj si záložní přepnutí na standardní model pro případ chyby