Lab zum Installieren eines KI-Coding-Agenten: npm, eine Konfigurationsdatei und ein Modell

Dieses Lab ist das Coding-Agent-Lab ohne Vorinstallation. Jede lernende Person installiert opencode, einen quelloffenen KI-Coding-Agenten, aus npm, liest eine Beispiel-Konfigurationsdatei und kopiert sie an ihren Platz, und nutzt den Agenten dann am selben kleinen Schulkiosk-Programm.

Die Kopie hat nur zwei Wege ins Internet: die npm-Registry, über einen Proxy, der sonst nichts durchlässt, und das Modell der Plattform. Der Agent steht denselben Personen zur Verfügung wie im ersten Lab, mit demselben Kontingent.

Was Lernende hier lernen

Dass ein Programm als Paket installiert und auf ein Release festgelegt wird, dass eine Konfigurationsdatei einem Programm sagt, wo seine Dienste sind, und dass ein Schlüssel nie in eine Datei gehört, die abgegeben wird. Das Lab eignet sich für eine erste Lektion über das Installieren und Konfigurieren von Werkzeugen.

Im Browser ausführen

Das Lab startet einen Dienst, agent, mit dem Projekt in /home/node/project und einer Beispielkonfiguration unter /home/node/opencode.example.json.

  1. Container-Seite öffnen. Wählen Sie in der Leiste „Entwickeln“ und dann „Einen Container ausführen“. Die Seite kann jeder öffnen, und das Git-Lab und das SQL-Lab starten ohne Konto. Jedes andere Lab braucht ein kostenloses Konto: Erstellen Sie eines, melden Sie sich an und wählen Sie dann „Starten“.
  2. Lab finden. Die Karte „Beispiel-Labs“ listet alle Beispiele auf. Suchen Sie „KI-Coding-Agent: selbst installieren“.
  3. „Starten“ wählen. „Starten“ führt das Lab unverändert mit einem Klick aus. „Zuerst die Datei bearbeiten“ öffnet die Compose-Datei, damit Sie sie vor dem Start ändern können.
  4. Öffnen. Wählen Sie auf der Seite des Labs „Terminal öffnen“. docker exec agent npm install -g [email protected] installiert den Agenten, docker exec agent opencode --version gibt sein Release aus, und die Lektion kopiert die Beispielkonfiguration an ihren Platz.

Was Lernende abgeben sollten

Ihre opencode.json, die Tests vor und nach der Reparatur und einen Satz dazu, was jede Zeile der Konfiguration bewirkt.

Eine Grundlagenlektion zu diesem Lab

AI Coding Agent Basics 2 ist eine kleine Lektion, die in diesem Lab nach AI Coding Agent Basics durchgearbeitet wird. Darin installiert die lernende Person den Agenten, liest und kopiert seine Konfiguration, stellt ihm eine Frage und behebt dann mit ihm den Fehler.

Kostenlose persönliche Konten haben sie im Modul „Basics“ auf der Startseite, jede Einrichtung kann sie aus dem Ordner „Basics“ der Bibliothek kopieren, und eine neue Einrichtung startet mit ihr in einem Modul namens DevOps Labs (Sample). Kopieren Sie sie in ein eigenes Modul, um sie zu ändern.

Der Code auf GitHub

Die Compose-Datei enthält kein Dockerfile: Sie führt das offizielle node-Image, auf eine Version festgelegt, als Benutzer ohne Sonderrechte aus. opencode steht unter der MIT-Lizenz und wird von der lernenden Person installiert, nicht von uns verteilt. Das Projekt und die Konfiguration liegen in einem benannten Volume; der Agent nicht, er wird also nach einem Neustart erneut installiert.

Als Arbeit stellen

Beschreiben Sie in der Aufgabe, was abzugeben ist.

  1. Lab erstellen. Fügen Sie in Ihrem Modul eine Aufgabe hinzu und wählen Sie die Karte „Container-Lab“, dann „In einem GitHub-Repository“. Geben Sie https://github.com/mitsurutech/lab-ai-agent-install mit dem Branch main an. Die Compose-Datei ist standardmäßig compose.yaml. Forken Sie das Repository zuerst, wenn Sie sie ändern möchten.
  2. Veröffentlichen und ausprobieren. „Veröffentlichen“ legt den Commit fest, der Ihnen gezeigt wurde, sodass eine spätere Änderung im Repository ein bereits gestelltes Lab nicht verändert. Starten Sie zuerst Ihre eigene Kopie.
  3. Zuweisen. Weisen Sie es wie jede Aufgabe zu, auf Wunsch mit einem Fälligkeitsdatum, und beschreiben Sie in der Aufgabe, was zu tun ist und was abgegeben werden soll.
  4. Abgaben bewerten. Öffnen Sie die Kopie einer lernenden Person und ihre Abgabe, bewerten Sie sie und geben Sie sie mit einer Begründung zur Überarbeitung zurück, wenn mehr nötig ist.

Häufige Fragen

Woher bezieht npm den Agenten, wenn das Lab keinen Weg nach außen hat?
Aus der npm-Registry, über einen Proxy neben der Kopie, der die Registry durchlässt und jede andere Adresse abweist.
Warum steht als Schlüssel in der Konfiguration nur das Wort lab?
Das Lab fügt den echten auf dem Weg nach außen hinzu, sodass er nie in einer Datei steht, die eine lernende Person sehen oder abgeben kann. Alles, was dort eingetippt wird, wird ersetzt.
Warum muss der Agent nach einem Neustart erneut installiert werden?
Er ist etwa 140 MB groß, mehr, als eine Kopie behalten darf. Das Projekt und die Konfiguration bleiben erhalten, die Installation ist also der einzige Schritt, der wiederholt werden muss.