Level 1: AI SDK Basics — Briefing

Level 1: AI SDK Basics — Dein Einstieg in die AI-Entwicklung

TL;DR

Das AI SDK ist Dein Werkzeugkasten für AI-Anwendungen. In diesem Level lernst Du die Grundlagen: Text generieren, streamen, strukturierte Ausgaben und System Prompts. Eine API für alle Provider — Anthropic, OpenAI, Google und 20+ weitere.

Skill Tree

Was Du Lernst

Was das AI SDK ist und wie es aufgebaut ist — drei Bibliotheken, ein einheitliches Interface
Wie Du ein LLM-Modell auswaehlst und konfigurierst — Provider-System, Modell-Instanzen, Provider wechseln
Text generieren mit generateText — das Result-Objekt, Usage Tracking, Finish Reason
Text streamen mit streamText — Echtzeit-Ausgabe, Stream Events, textStream
Strukturierte Ausgaben mit Output.object, Output.array und Output.choice — typisierte JSON-Antworten statt Freitext
System Prompts für Rollenverhalten — dem LLM eine Identitaet und Regeln geben

Warum Das Wichtig Ist

Jede AI-Anwendung baut auf diesen Grundlagen auf. Ohne sie bist Du auf Copy-Paste aus ChatGPT angewiesen und kannst AI nicht programmatisch in Deine Projekte einbauen.

Das konkrete Problem: Du willst AI in Deinen Code integrieren, aber jeder Provider hat eine andere API, andere Typen, andere Fehlerbehandlung. Das AI SDK loest das — eine einheitliche API für alle Provider. Du lernst sie hier von Grund auf.

Voraussetzungen

Node.js 20+ und npm installiert — pruefe mit node -v und npm -v
TypeScript Grundkenntnisse — Typen, Interfaces, async/await
Erfahrung mit ChatGPT oder aehnlichem — Du weisst, was ein LLM ist und was es kann
Ein API-Key für mindestens einen Provider:
- Anthropic Console — API-Key unter “API Keys” erstellen (empfohlen für diesen Kurs)
- OpenAI Platform — API-Key unter “API Keys” erstellen
- Google AI Studio — API-Key erstellen

Die meisten Provider bieten ein kostenloses Startguthaben oder Free Tier. Für Level 1 reicht ein einzelner API-Key.

Bevor Du loslegst

Erstelle ein Projektverzeichnis für dieses Level. Jede Challenge wird als eigene TypeScript-Datei gespeichert, die Boss Fight kombiniert alles in einer finalen Datei.

mkdir level-1-ai-sdk && cd level-1-ai-sdk
npm init -y
npm install ai @ai-sdk/anthropic zod
npm install -D tsx typescript

Erstelle eine .env-Datei für Deinen API-Key:

echo 'ANTHROPIC_API_KEY=sk-ant-dein-key-hier' > .env

So fuehrst Du Deine TypeScript-Dateien aus:

npx tsx --env-file=.env challenge-1-1.ts

tsx ist ein TypeScript-Runner, der .ts-Dateien direkt ausfuehrt — ohne tsconfig.json, ohne Build-Schritt. Mit --env-file=.env werden Deine Umgebungsvariablen geladen (Node.js 20+ Feature). Alternativ kannst Du dotenv installieren (npm install dotenv) und am Anfang Deiner Datei import 'dotenv/config' einfuegen.

Troubleshooting

“API key not found” — Pruefe ob Deine .env-Datei existiert und der Key korrekt ist: cat .env
“Cannot use import statement” — Nutze npx tsx statt node zum Ausfuehren
“Module not found” — Pruefe ob alle Packages installiert sind: npm ls ai @ai-sdk/anthropic zod

Skip-Hinweis: Du nutzt das AI SDK bereits taeglich und kennst generateText, streamText und Output.object? Spring direkt zur Boss Fight und teste Dein Wissen.

Challenges

1.1 — Was ist das AI SDK? SDK Architektur, drei Bibliotheken, erster API-Call

1.2 — Dein erstes Modell Provider-System, Modell-Auswahl, Provider wechseln

1.3 — Text generieren `generateText` API, Result-Objekt, Usage Tracking

1.4 — Text streamen `streamText`, `textStream`, Echtzeit-Ausgabe

1.5 — Strukturierte Ausgabe `Output.object`, `Output.array`, Zod Schemas

1.6 — System Prompts `system` Parameter, Rollenverhalten, Tone Setting

Boss Fight

Baue einen CLI-Chat: Ein Terminal-Programm, das Text mit streamText in Echtzeit ausgibt und auf Anfrage strukturierte JSON-Ausgabe mit Output.object liefert. Du kombinierst alle sechs Bausteine dieses Levels in einem Projekt.