AI SDK: TypeScript-Toolkit für KI-Apps

1. Projektübersicht

Das AI SDK (vercel/ai) ist ein anbieterunabhängiges TypeScript-Toolkit, das von Vercel und dem Next.js-Team entwickelt wurde, um KI-gestützte Anwendungen und Agenten zu erstellen. Es bietet Entwicklern eine einzige, einheitliche API zur Generierung von Text, strukturierten Daten und agentenbasierten Workflows über Dutzende von Modellanbietern und UI-Frameworks hinweg.

2. Hintergrund & Positionierung

Das AI SDK wurde entwickelt, um ein wiederkehrendes Problem in der Entwicklung von KI-Anwendungen zu lösen: Jeder Modellanbieter (OpenAI, Anthropic, Google und Dutzende mehr) liefert sein eigenes SDK, sein eigenes Anfrageformat und sein eigenes Streaming-Protokoll, was Entwickler dazu zwingt, den Integrationscode jedes Mal neu zu schreiben, wenn sie Modelle wechseln oder einen Fallback-Anbieter hinzufügen. Die Kernaufgabe des AI SDKs besteht darin, diese Unterschiede hinter einer einheitlichen Schnittstelle zu abstrahieren — generateText, streamText, generateObject und Agenten-Primitiven funktionieren alle auf dieselbe Weise, unabhängig davon, welches Modell dahintersteckt.

Im Vergleich zu ähnlichen Projekten hebt sich das AI SDK durch Folgendes ab:

Es ist auf der Client-Seite frameworkunabhängig (Next.js, React, Svelte, Vue, Angular) und bleibt gleichzeitig auf dem Server runtime-unabhängig (Node.js, Edge-Runtimes, serverlose Funktionen).
Es liefert ein eingebautes Gateway (Vercel AI Gateway), das über einen einzigen Modell-String Zugriff auf über 100 Modelle bei über 16 Anbietern bietet, ohne dass ein separates Anbieterpaket für den Einstieg erforderlich ist.
Es behandelt Agenten als erstklassiges Konzept (ToolLoopAgent) anstatt als einfachen Wrapper um Chat-Vervollständigungen, mit nativer Unterstützung für Tool-Aufrufe, langlebige Workflows und Sandbox-basierte Codeausführung.
Es wahrt eine strikte Trennung zwischen Core (Server-/Edge-Logik), UI (Client-Hooks) und RSC (Streaming React Server Components), sodass Teams nur die Schichten übernehmen können, die sie benötigen.

3. Funktionskategorien

🤖 Modellanbieter (über 40 Pakete) — Adapter, die die einheitliche API mit spezifischen LLM-Anbietern und Inferenzplattformen verbinden.
- @ai-sdk/openai, @ai-sdk/anthropic, @ai-sdk/google — die drei am häufigsten genutzten Anbieter.
- @ai-sdk/xai, @ai-sdk/mistral, @ai-sdk/groq, @ai-sdk/cohere — weitere große Anbieter von gehosteten Modellen.
- @ai-sdk/amazon-bedrock, @ai-sdk/azure, @ai-sdk/google-vertex — cloudbasierter, nativer Modellzugriff.
- @ai-sdk/openai-compatible — ein generischer Adapter für jeden OpenAI-kompatiblen Inferenz-Endpunkt (selbst gehostet oder von Drittanbietern).
🎙️ Sprache & Audio (7 Pakete) — Anbieter für Transkription und Sprachgenerierung.
- @ai-sdk/deepgram, @ai-sdk/assemblyai, @ai-sdk/revai, @ai-sdk/gladia — Sprache-zu-Text-Transkription.
- @ai-sdk/elevenlabs, @ai-sdk/cartesia, @ai-sdk/lmnt, @ai-sdk/hume — Text-zu-Sprache und Sprachsynthese.
🎨 Bild- & Videogenerierung (6 Pakete) — Anbieter für die Generierung visueller Medien.
- @ai-sdk/replicate, @ai-sdk/fal, @ai-sdk/black-forest-labs — Bildgenerierung und Inferenz gehosteter Modelle.
- @ai-sdk/luma, @ai-sdk/klingai, @ai-sdk/minimax — Video- und multimodale Generierung.
🖼️ UI-Framework-Integrationen (5 Pakete) — Client-seitige Hooks zum Erstellen von Chat- und generativen Oberflächen.
- @ai-sdk/react, @ai-sdk/vue, @ai-sdk/svelte, @ai-sdk/angular — frameworkspezifische Chat-/Vervollständigungs-Hooks.
- @ai-sdk/rsc — Streaming-React-Server-Components-Unterstützung für generative UI.
🧩 Agenten-Infrastruktur (über 10 Pakete) — Bausteine für autonome und langlebige Agenten.
- ai (Kern-ToolLoopAgent) — die Tool-aufrufende Agentenschleife, die das Herzstück des SDKs bildet.
- @ai-sdk/mcp — Model Context Protocol Client-/Server-Unterstützung für Tool-Interoperabilität.
- @ai-sdk/workflow, @ai-sdk/workflow-harness — langlebige, langlaufende Agenten-Workflows.
- @ai-sdk/sandbox-vercel, @ai-sdk/sandbox-just-bash — Sandbox-basierte Codeausführungsumgebungen für Agenten.
- @ai-sdk/harness-claude-code, @ai-sdk/harness-codex, @ai-sdk/harness-opencode — Integrationen mit beliebten Coding-Agent-Harnesses.
🛠️ Entwickler-Tools (6 Pakete) — Unterstützende Infrastruktur für die Erstellung und den Betrieb von AI-SDK-Anwendungen.
- @ai-sdk/gateway — einheitliches Routing an das Vercel AI Gateway.
- @ai-sdk/otel — OpenTelemetry-Instrumentierung für Observability.
- @ai-sdk/devtools, @ai-sdk/tui — Debugging- und Terminal-UI-Werkzeuge.
- @ai-sdk/provider, @ai-sdk/provider-utils — die Low-Level-Verträge, gegen die neue Anbieterpakete implementiert werden.

4. Wichtigste Highlights

Einheitliche Modell-API — Wechseln Sie zwischen OpenAI, Anthropic, Google und über 100 weiteren Modellen, indem Sie einen einzigen String ändern, ohne die Anwendungslogik neu zu schreiben.
Vercel AI Gateway als Standard — Out-of-the-Box-Zugriff auf wichtige Anbieter ohne die Installation separater Anbieter-SDKs, zuzüglich zentraler Ratenbegrenzung und Fallback-Routing.
ToolLoopAgent-Primitive — Eine erstklassige Agenten-Abstraktion mit Reasoning-Kontrolle, Tool-Aufrufen und Runtime-Kontext, anstatt einer manuellen Chat-Vervollständigungsschleife.
Generierung strukturierter Ausgaben — generateObject/Output.object erzeugen über Zod (oder Valibot) schema-validiertes JSON und eliminieren so fehleranfälliges, prompt-basiertes JSON-Parsing.
Langlebige Workflows und Sandbox — Langlaufende Agenten-Workflows, die Neustarts überstehen, gekoppelt mit Sandbox-Ausführungsumgebungen für Agenten, die Code sicher ausführen müssen.
Frameworkunabhängige Streaming-UI — Dieselben Streaming-Chat-/Generativen-UI-Hooks funktionieren über Next.js, React, Svelte, Vue und Angular hinweg.

5. Anwendungsfälle nach Rolle

Allgemeine Entwickler — Erstellen Sie Chatbots, Copiloten und generative UI-Funktionen in Next.js-/React-/Vue-/Svelte-Anwendungen mit einer konsistenten API, unabhängig vom zugrunde liegenden Modell.
DevOps/SRE — Nutzen Sie @ai-sdk/otel für Observability und das Vercel AI Gateway für zentrale Ratenbegrenzung, Fallback und Kostenverfolgung über Modellanbieter hinweg.
Daten-/Forschungswissenschaftler — Prototypisieren Sie die Extraktion strukturierter Daten und mehrstufige Reasoning-Pipelines mit generateObject und ToolLoopAgent, ohne anbieterspezifische Anfrageformate manuell zu erstellen.
Projektmanager — Bewerten Sie die Reife des Projekts anhand seiner großen Basis an Mitwirkenden, des wöchentlichen Download-Volumens und des aktiven Veröffentlichungstakts (AI SDK 6/7) als Indikator für langfristige Wartung.

6. Erste Schritte

Finden Sie, was Sie benötigen — Durchstöbern Sie das Anbieterverzeichnis und die API-Referenz, um das Anbieterpaket oder die Primitive (generateText, streamText, ToolLoopAgent) zu identifizieren, die zu Ihrem Anwendungsfall passen.

Installieren und integrieren

npm install ai
npm install @ai-sdk/openai @ai-sdk/anthropic @ai-sdk/google

import { generateText } from 'ai';

const { text } = await generateText({
  model: 'openai/gpt-5.4', // wird über das Vercel AI Gateway geroutet
  prompt: 'Was ist ein Agent?',
});

Nutzer von Coding-Agenten können den AI-Skill auch direkt mit npx skills add vercel/ai zu einem Repository hinzufügen.

Beitragen — Lesen Sie CONTRIBUTING.md; das Projekt priorisiert derzeit hochwertige Issues (klare Reproduktionen, fehlschlagende Tests) gegenüber unaufgeforderten, großen Pull Requests. Prüfen Sie daher den Issue-Tracker, bevor Sie mit umfangreichen Arbeiten beginnen.

7. Projektstruktur

ai/
├── packages/              # Alle veröffentlichten Pakete (Core, Anbieter, UI, Agenten)
│   ├── ai/                 # Core-SDK: generateText, streamText, ToolLoopAgent
│   ├── openai/ anthropic/ google/ ...  # Modellanbieter-Adapter
│   ├── react/ vue/ svelte/ angular/ rsc/  # UI-Framework-Integrationen
│   ├── mcp/ workflow/ sandbox-vercel/     # Agenten-Infrastruktur
│   └── provider/ provider-utils/          # Verträge zum Erstellen neuer Anbieter
├── apps/
│   └── docs/               # ai-sdk.dev Dokumentationsseite
├── content/                # Dokumentations-Quellinhalt
├── examples/               # Ausführbare Beispielanwendungen
├── skills/                 # Coding-Agent-Skill-Definitionen
├── tools/                  # Interne Build-/Dev-Werkzeuge
└── CONTRIBUTING.md

Jeder Ordner unter packages/ ist ein unabhängig versioniertes npm-Paket; Anbieterpakete implementieren den in packages/provider definierten gemeinsamen Vertrag, sodass sie in dieselbe generateText/streamText-API integriert werden.

8. Verwandtes Ökosystem

Next.js — das Framework, das parallel zum AI SDK entwickelt wird und mit dem es am häufigsten eingesetzt wird.
Vercel AI Gateway — die Standard-Routing-Schicht, die Zugriff auf über 100 Modelle ohne pro-Anbieter-Setup bietet.
Vercel Sandbox — die sichere Ausführungsumgebung, die von @ai-sdk/sandbox-vercel für die Codeausführung von Agenten verwendet wird.
Zod / Valibot — Schema-Validierungsbibliotheken, die für die Generierung strukturierter Ausgaben verwendet werden.
Model Context Protocol (MCP) — das offene Protokoll, das @ai-sdk/mcp für Tool-Interoperabilität über Agenten-Ökosysteme hinweg implementiert.
LangChain / LlamaIndex — als optionale Orchestrierungsschichten über dedizierte Adapterpakete unterstützt.

9. Lizenz

Das Projekt wird unter der Apache License 2.0 vertrieben.

✅ Frei nutzbar, modifizierbar und verteilbar, auch in kommerziellen und Closed-Source-Produkten.
✅ Enthält eine ausdrückliche Patentgewährung von den Mitwirkenden.
❌ Kommt ohne Gewährleistung; Mitwirkende haften nicht für Schäden, die aus der Nutzung entstehen.
ℹ️ Modifizierte Dateien müssen einen Hinweis tragen, dass Änderungen vorgenommen wurden, und der Lizenz-/Copyright-Hinweis muss in Distributionen erhalten bleiben.

10. FAQ

F: Benötige ich für jeden Modellanbieter einen separaten API-Schlüssel?
A: Nein — standardmäßig routet das AI SDK Anfragen über das Vercel AI Gateway unter Verwendung eines einzigen Modell-Strings (z. B. 'anthropic/claude-opus-4.6'), Sie können jedoch auch ein spezifisches Anbieterpaket wie @ai-sdk/anthropic installieren, um eine direkte Verbindung herzustellen.

F: Kann ich eine strukturierte, schema-validierte Ausgabe anstelle von rohem Text erhalten?
A: Ja — verwenden Sie generateText mit Output.object (oder generateObject) und einem Zod-Schema, um typisiertes, validiertes JSON vom Modell zurückzuerhalten.

F: Welche Frontend-Frameworks unterstützt das AI SDK?
A: Next.js, React, Svelte, Vue und Angular verfügen alle über dedizierte UI-Hook-Pakete, und die zentralen Streaming-Primitiven sind frameworkunabhängig.

F: Wie erstelle ich einen Agenten, der Code ausführen oder Tools nutzen kann?
A: Verwenden Sie ToolLoopAgent aus dem Kernpaket ai, definieren Sie Tools direkt oder über @ai-sdk/mcp für Model Context Protocol Tool-Server; kombinieren Sie es mit @ai-sdk/sandbox-vercel für Sandbox-basierte Codeausführung.

F: Was ist der beste Weg, um beizutragen?
A: Prüfen Sie zuerst CONTRIBUTING.md — die Maintainer priorisieren derzeit klare Fehlerberichte, minimale Reproduktionen und fehlschlagende Tests gegenüber unaufgeforderten Pull Requests für vollständige Implementierungen.

11. Schnelllinks

Repository: https://github.com/vercel/ai
Offizielle Dokumentation: https://ai-sdk.dev/docs
Beitragsleitfaden: https://github.com/vercel/ai/blob/main/CONTRIBUTING.md
Community: https://vercel.community

12. Zusammenfassung

Das AI SDK gibt TypeScript-Entwicklern eine konsistente Möglichkeit, jedes große LLM aufzurufen, strukturierte Daten zu generieren und Tool-nutzende Agenten zu erstellen — unterstützt durch ein großes Anbieter-Ökosystem, native Framework-Integrationen und Vercels Gateway-/Sandbox-Infrastruktur. Es eignet sich am besten für Teams, die produktionsreife KI-Funktionen entwickeln und eine Anbieterbindung vermeiden möchten, Modelle mit einer einzeiligen Änderung austauschen und von einem einfachen Chatbot bis hin zu langlebigen, Sandbox-basierten Agenten-Workflows skalieren möchten, ohne das Toolkit zu wechseln.