Develop AI Functions Example
Offizieller Vercel-Skill zum Entwickeln, Prüfen und Strukturieren von AI-SDK-Beispielen.
- Skill Road
- Develop AI Functions Example
Kategorien
Develop AI Functions Example ist ein offizieller Skill aus dem Repository vercel/ai von Vercel. Laut Anbieter unterstützt er beim Erstellen, Ausführen und Ändern von Beispielen im Verzeichnis examples/ai-functions/src. Die Beispiele dienen dazu, Provider-Unterstützung zu validieren, Funktionen des AI SDK zu demonstrieren und Test-Fixtures zu erzeugen. Der Skill ist deshalb eine Entwicklungsanleitung und kein eigenständiger Modellanbieter, kein Hostingdienst und kein fertiges Produktivsystem. Er richtet sich an Personen, die den AI SDK in TypeScript-Projekten nachvollziehbar ausprobieren oder Änderungen an der Bibliothek mit kleinen, reproduzierbaren Beispielen absichern möchten.
Zweck und Auslöser
Die offizielle Beschreibung nennt drei typische Aufgaben. Ein Beispiel kann neue Provider-Unterstützung prüfen, eine neue Funktion mit einem konkreten Provider demonstrieren oder einen Fehler in einer isolierten Datei reproduzieren. Auch provider-spezifische Optionen und API-Antwort-Fixtures gehören zum vorgesehenen Bereich. Diese Grenze ist wichtig: Der Skill soll nicht automatisch eine vollständige Anwendung entwerfen, beliebige Infrastruktur verändern oder Geheimnisse beschaffen. Er liefert Kontext für den Beispielordner und unterstützt eine fokussierte technische Untersuchung.
Abgedeckte Funktionen
Laut Anbieter enthält der Beispielbereich unter anderem nicht gestreamte Textgenerierung mit generateText, Streaming mit streamText, strukturierte Ausgaben mit generateObject und streamObject sowie agentische Abläufe mit ToolLoopAgent. Hinzu kommen einzelne und gebündelte Embeddings, Bildgenerierung, Sprachausgabe, Transkription, Reranking, Middleware, Provider-Registry, Telemetrie, komplexe Zusammenspiele, wiederverwendbare Werkzeuge und gemeinsame Hilfsfunktionen. Die Einordnung nach Funktion verhindert flache Sammeldateien und macht sichtbar, welches Verhalten ein Beispiel tatsächlich prüft.
Aufbau und Arbeitsweise
Die Quelle empfiehlt, Beispiele nach Funktion und Provider zu gruppieren. Ein grundlegendes Beispiel soll basic.ts heißen; zusätzliche Dateien erhalten beschreibende kebab-case-Namen. Alle Beispiele verwenden laut Anbieter den run-Wrapper aus lib/run.ts. Dieser lädt Umgebungswerte aus einer lokalen Konfiguration und stellt eine ausführliche Fehlerbehandlung für API-Fehler bereit. Für Streams gibt es eine Hilfsfunktion zur vollständigen Ausgabe, während Druckwerkzeuge undefinierte Werte aus Ergebnissen entfernen können. Ein Beispiel sollte einen klaren Prompt, ein realistisches Modellkennzeichen und genau ein nachvollziehbares Merkmal zeigen.
Verzeichnisstruktur und Namensschema
Die Beispiele liegen in examples/ai-functions/src, gegliedert nach AI-SDK-Funktion, etwa generate-text, stream-text, generate-object, agent, embed, generate-image und transcribe. Dateien folgen dem Muster <funktion>/<anbieter>/<merkmal>.ts. Das Einstiegsbeispiel heißt basic.ts, weitere Beispiele tragen sprechende Namen in Kleinschreibung mit Bindestrichen. Flache Dateien wie generate-text/openai.ts sollen vermieden werden. Ausgeführt wird ein Beispiel im Ordner examples/ai-functions mit pnpm tsx, zum Beispiel pnpm tsx src/generate-text/openai/basic.ts. Alle Beispiele nutzen den Wrapper run() aus lib/run.ts, der Umgebungsvariablen lädt und Fehler behandelt.
Sicherheit, Grenzen und E-E-A-T
Beispiele können externe Modellanbieter aufrufen und dabei Prompts, Dateien oder API-Antworten verarbeiten. Zugangsdaten, Tokens, private Schlüssel und echte personenbezogene Daten gehören nicht in Quelltext, Fixture-Dateien oder Kataloginhalte. Lokales Ausführen bedeutet nicht automatisch, dass Daten lokal bleiben, weil der ausgewählte Provider und das Modell Inhalte verarbeiten können. Der run-Wrapper erleichtert Fehlerberichte, ersetzt aber keine Prüfung von Datenschutz, Kostenkontrolle, Berechtigungen oder Prompt-Injection. Laut Anbieter ist die Skill-Datei eine praktische Anleitung im offiziellen Repository; die Primärquelle und die AI-SDK-Dokumentation sind für aktuelle API-Details maßgeblich. Das Repository nennt Apache-2.0 als Lizenz. Der Eintrag behauptet weder Kompatibilität mit jedem Provider noch Produktionsreife jedes Beispiels und nennt keine konkreten Preise. Teams sollten die aktuelle Anbieter-Dokumentation, Modellverfügbarkeit und Kontobedingungen vor einer Ausführung prüfen.
Installationsanleitung
Die Develop AI Functions Example ist ein internes Skill innerhalb des offiziellen Vercel AI SDK Repositoriums auf GitHub. Es richtet sich nicht an Endanwender einer fertigen App, sondern an Entwicklerinnen und Entwickler, die selbst am AI SDK mitarbeiten und im Ordner examples/ai-functions eigene Beispielskripte für einzelne SDK-Funktionen pflegen. Ein Skill in diesem Sinn ist eine SKILL.md Datei mit einer kurzen Beschreibung, wann ein KI-Coding-Assistent wie Claude Code sie automatisch heranziehen soll. Laut Anbieter ist dieses konkrete Skill als internal markiert, es wird also nicht als eigenständiges Produkt vertrieben, sondern dient als Nachschlagewerk, das der Assistent im Kontext des Vercel Repositoriums lädt, sobald jemand neue Beispiele unter examples/ai-functions/src anlegen, ausführen oder ändern möchte.
Wofür das Skill konkret gedacht ist
Kernaufgabe ist es, Provider-Unterstützung zu validieren, Funktionen zu demonstrieren und Testfixtures zu erzeugen. Die Beispiele sind nach SDK-Funktion gegliedert, etwa generateText für nicht-streamende Textgenerierung, streamText für Streaming-Antworten, generateObject und streamObject für strukturierte Ausgaben nach einem Schema, dazu Bereiche für Agenten mit Werkzeugschleifen, für Embeddings einzeln und in Stapeln, für Bild- und Sprachgenerierung, Transkription, Reranking von Dokumenten sowie für Middleware, Provider-Registrierung und OpenTelemetry-Integration. Diese Struktur hilft dabei, schnell zu erkennen, wo ein neues Beispiel für einen bestimmten Anwendungsfall hingehört, statt Dateien wahllos zu verstreuen.
Namenskonvention und Aufbau
Das Skill schreibt eine klare Dateibenennung vor: Das Einstiegsbeispiel einer Funktion heißt immer basic.ts, weitere Beispiele folgen einem Muster aus Funktion, Anbieter und optional Unteranbieter oder Feature, etwa stream-text für den Anbieter openai mit der Datei tool-call.ts für ein bestimmtes Werkzeugaufruf-Szenario. Flache Dateien ohne Unterordner pro Anbieter sind ausdrücklich untersagt, damit die Struktur über Dutzende Provider hinweg konsistent bleibt. Jedes Beispiel nutzt einen gemeinsamen run Wrapper aus einer Bibliotheksdatei, der Umgebungsvariablen aus einer env Datei lädt und Fehler mit detaillierten API-Meldungen protokolliert, sodass beim Testen eines neuen Modells sofort ersichtlich ist, woran ein fehlgeschlagener Aufruf liegt.
Schritt 1: Voraussetzungen für die Nutzung
Um dieses Skill sinnvoll einzusetzen, braucht man einen lokalen Klon des vercel/ai Repositoriums, eine funktionierende Node.js- und TypeScript-Umgebung sowie gültige API-Schlüssel der jeweiligen Modellanbieter in einer lokalen env Datei. Das Skill selbst wird nicht separat installiert, sondern liegt bereits im Repository und wird von einem kompatiblen Coding-Agenten automatisch erkannt, wenn dessen Beschreibung zum aktuellen Arbeitskontext passt.
Sicherheit und Umgang mit Zugangsdaten
Weil die Beispiele reale API-Aufrufe gegen Modellanbieter ausführen, landen Schlüssel und Zugangsdaten in einer lokalen env Datei, die niemals eingecheckt werden sollte. Wer neue Beispiele nach diesem Muster erstellt, sollte zusätzlich prüfen, dass keine echten Kundendaten oder internen Geheimnisse in Prompt-Strings landen, da diese Dateien im Repository dauerhaft sichtbar bleiben.
Praxisnutzen und Grenzen
Der praktische Nutzen liegt vor allem darin, dass neue Mitwirkende am AI SDK sofort eine einheitliche Struktur vorfinden und ein KI-Assistent beim Anlegen neuer Beispiele automatisch die richtigen Namensmuster und Vorlagen anwendet, was Codereviews beschleunigt. Die Grenze ist ebenso klar: Dieses Skill ist kein allgemeines Werkzeug für eigene Projekte, sondern ausschließlich für die Pflege des Vercel AI SDK Beispielordners gedacht, und ohne den Kontext dieses konkreten Repositoriums bietet es keinen Mehrwert. Wer ein eigenes SDK oder eine eigene Beispielsammlung pflegt, kann sich aber die Grundidee abschauen: klare Namenskonventionen plus ein gemeinsamer Wrapper für Umgebungsvariablen und Fehlerbehandlung sparen in jedem größeren Repository viel Abstimmungsaufwand.
- Anbieter
- Vercel
- Lizenz
- Apache-2.0
- Zuletzt geprüft
- 09.09.2026
Repository und Dokumentation
Kategorien
Kompatibel mit
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.