Teil 3 · Bauen

Den Agenten auf Ihrem eigenen Rechner bauen

Teil 3 umfasst neun geführte TypeScript-Stufen (0–8) plus ein Transferprojekt in Stufe 9. Diese Seite richtet die lokalen Werkzeuge ein, weist Stufe 0 offline nach und führt Sie dann zum Repository, ohne vorzugeben, die Website könne Ihren Fortschritt sehen.

TypeScript-Kurs öffnen↗Zum Browser-Labor zurückkehren

Eine Startrampe, keine Online-IDE

Ihr Code, Ihre Modellschlüssel, Ausgaben und Fortschritte bleiben in Ihrem lokalen Klon. Diese statische Website führt den Kurs weder aus noch liest sie course/progress.json.

Bevor Sie beginnen

Sie können einfaches TypeScript lesen und bearbeiten: Funktionen, Objekte, Schleifen und await.
Sie haben Git, Node.js 20.9 oder neuer, ein Terminal und einen Code-Editor.
Planen Sie für die neun geführten Stufen (0–8) zwei bis drei Stunden ein; das Transferprojekt in Stufe 9 ist offen angelegt, und Sie können später zurückkehren.

Zuerst Stufe 0 offline ausführen

1. Klonen und installieren
Klonen Sie das öffentliche Repository, wechseln Sie hinein und installieren Sie exakt die gesperrten Abhängigkeiten.
```
git clone https://github.com/HUDongpin/agent-edu.git
cd agent-edu
npm ci
```
2. Die eine Änderung in Stufe 0 vornehmen
Öffnen Sie course/stage0-hello/run.ts und ersetzen Sie die leere Zeichenkette QUESTION durch eine eigene Frage.
```
export const QUESTION = "What should I notice about an API?";
```
3. Ohne Schlüssel ausführen und prüfen
Der Offline-Modus verwendet einen mitgelieferten deterministischen Ersatz. Er ist die sicherste Vorabprüfung: keine Anbieteranfrage, keine private Aufzeichnung und keine Tokenkosten.
```
npm run course:offline
npx tsx course/stage0-hello/run.ts --offline
npx tsx course/check.ts 0 --offline
```

Die Prüfung ist erfolgreich, wenn Sie Folgendes sehen

PASS  you asked the model something
PASS  an answer came back

  stage 0 complete.

Wählen Sie erst einen Anbieter, wenn Sie bereit sind

Vorgegebener Offline-Modus

Benötigt keinen Schlüssel und stellt keine kostenpflichtige Anfrage. Er weist den Codepfad nach, kann jedoch keine Modellvariation zeigen.

--offline

DeepSeek

Der standardmäßige Live-Anbieter. Ihr Terminalprozess liest DEEPSEEK_API_KEY; Live-Stufen verursachen DeepSeek-Kosten und geben die gemessenen Ausgaben aus.

export DEEPSEEK_API_KEY=your_key_here

Claude

Ein optionaler lokaler Anbieter zum Vergleichen. Setzen Sie den Schlüssel und CAFE_PROVIDER. Claude kann deutlich teurer sein; prüfen Sie daher vor einer Ausführung die ausgegebene Schätzung.

export ANTHROPIC_API_KEY=your_key_here
export CAFE_PROVIDER=anthropic

Kosten entstehen beim Anbieter

Offline ist kostenlos. Live-Summen variieren je nach ausgewähltem Modell, Token, Cache und aktuellen Anbieterpreisen. Betrachten Sie jede Kursschätzung als datiert; das Anbieter-Dashboard ist der Abrechnungsnachweis.

Der Fortschritt gehört zu diesem Klon

Der Kursprüfer schreibt course/progress.json lokal. Die Website zeigt für Teil 3 weder Prozentsatz noch die Zustände Fortsetzen oder Abgeschlossen, da sie diese Datei nicht beobachten kann.

npx tsx course/report.ts
# reads course/progress.json in this clone

Was Sie mitnehmen

Stufe 9 fordert Sie auf, das Café hinter sich zu lassen und einen Agenten in einem vertrauten Bereich zu dokumentieren. Eine prüfbare Abgabe enthält:

die Problemgrenze und die Entscheidungen, die das Modell treffen darf;
eine realistische Fehlereingabe, an der die einfachen Regeln scheitern;
einen kleinen Evaluationssatz mit Nachweisen, nicht nur ausgewählte gute Ausgaben;
eine im Code erzwungene Schranke vor der unumkehrbarsten Aktion;
die Grenzen für Anbieter, Werkzeuge und nicht vertrauenswürdige Eingaben;
eine kurze Rückschau auf Fehler, Kompromisse und den nächsten Test.

Falls die lokale Einrichtung zu anspruchsvoll ist

Kehren Sie zum Browser-Labor zurück und üben Sie zuerst Regeln → Prompt → Evaluation. Es vermittelt dieselbe Kontrollübergabe, ohne dass Sie eine Entwicklungsumgebung installieren müssen.

Zum Browser-Labor zurückkehren TypeScript-Kurs öffnen↗