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.

Zuerst Stufe 0 offline ausführen→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.

Der Kurs selbst ist auf Englisch. Die Website gibt es in neun Sprachen, aber die Stufenanleitungen, die Café-Karte und die zwanzig Testfälle sind nicht übersetzt: die gemessenen Eingaben zu übersetzen würde die Übung verändern — derselbe Grund, aus dem die Fälle im Labor englisch bleiben.

Bevor Sie beginnen

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

Sie haben das Labor schon abgeschlossen? Die Stufen 1–4 sind eine Wiederholung — diesmal schreiben Sie den Code selbst.

Zuerst Stufe 0 offline ausführen

  1. 1. Klonen und installieren

    Klonen Sie das öffentliche Repository, wechseln Sie hinein und installieren Sie exakt die gesperrten Abhängigkeiten.

    Klon und Installation holen die ganze Website — mehrere hundert Megabyte, weil der Kurs sich das Manifest der Website teilt. Der Kurs selbst importiert ein einziges Paket. Rechnen Sie bei langsamer Verbindung mit ein paar Minuten.

    git clone https://github.com/HUDongpin/agent-edu.git
cd agent-edu
npm ci

  2. 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. 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 kann diese Datei nicht beobachten und zeigt für Teil 3 deshalb weder einen Prozentsatz noch den Zustand Fortsetzen — nur das, was Sie unten für sich selbst notieren.

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

Auf dieser Seite prüft nichts Ihre Arbeit. Wenn Sie die Stufen abgeschlossen haben, können Sie das für sich selbst notieren. Die Notiz bleibt in diesem Browser, wird nirgendwohin gesendet, und Sie können sie jederzeit wieder entfernen.

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ückkehrenTypeScript-Kurs öffnen↗