Lab installer un agent de code IA : npm, un fichier de configuration et un modèle

Ce lab est le lab de l’agent de code, sans rien d’installé. Chaque élève installe opencode, un agent de code IA libre, depuis npm, lit un exemple de fichier de configuration et le copie à sa place, puis utilise l’agent sur le même petit programme de caisse de cafétéria.

La copie n’a que deux sorties vers internet : le registre npm, par un proxy qui ne laisse rien passer d’autre, et le modèle de la plateforme. L’agent fonctionne pour les mêmes personnes que dans le premier lab, avec le même quota.

Ce que les élèves apprennent

Qu’un programme s’installe sous forme de paquet et se fige à une version, qu’un fichier de configuration indique à un programme où se trouvent ses services, et qu’une clé ne va jamais dans un fichier qu’on rend. Il convient à une première séance sur l’installation et la configuration d’outils.

Le lancer dans votre navigateur

Le lab démarre un seul service, agent, avec le projet dans /home/node/project et un exemple de configuration dans /home/node/opencode.example.json.

  1. Ouvrir la page Conteneur. Ouvrez « Créer » dans la barre et choisissez « Lancer un conteneur ». Tout le monde peut ouvrir la page, et le lab Git et le lab SQL se lancent sans compte. Tous les autres labs demandent un compte gratuit : créez-en un, connectez-vous, puis appuyez sur « Démarrer ».
  2. Trouver le lab. La carte « Laboratoires d’exemple » liste tous les exemples. Trouvez l’agent de code à installer soi-même.
  3. Appuyer sur Démarrer. « Démarrer » le lance tel quel, en un clic. « Modifier le fichier d’abord » ouvre le fichier compose pour que vous puissiez le changer avant de démarrer.
  4. L’ouvrir. Sur la page du lab, appuyez sur « Ouvrir le terminal ». docker exec agent npm install -g [email protected] installe l’agent, docker exec agent opencode --version affiche sa version, et la leçon copie l’exemple de configuration à sa place.

Que demander aux élèves de rendre

Leur opencode.json, les tests avant et après la correction, et une phrase sur ce que fait chaque ligne de la configuration.

Une leçon de base sur ce lab

AI Coding Agent Basics 2 est une petite leçon qui se fait dans ce lab, après AI Coding Agent Basics. L’élève y installe l’agent, lit et copie sa configuration, lui pose une question, puis corrige le bug avec lui.

Les comptes personnels gratuits l’ont dans le module Basics, qui se trouve sur l’« Accueil », chaque établissement peut la copier depuis le dossier Basics de la Bibliothèque, et un nouvel établissement l’a dans un module appelé DevOps Labs (Sample). Copiez-la dans un module à vous pour la modifier.

Le code sur GitHub

Le fichier compose n’a pas de Dockerfile : il lance l’image officielle node, figée à une version, avec un utilisateur sans privilèges. opencode est sous licence MIT ; c’est l’élève qui l’installe, il n’est pas distribué par nous. Le projet et la configuration sont conservés dans un volume nommé ; l’agent ne l’est pas, il est donc réinstallé après un redémarrage.

En faire un travail

Indiquez dans la tâche ce qu’il faut rendre.

  1. Créer le lab. Dans votre module, ajoutez une tâche et choisissez la carte « Lab de conteneurs », puis « Dans un dépôt GitHub ». Indiquez https://github.com/mitsurutech/lab-ai-agent-install avec la branche main. Le fichier compose par défaut est compose.yaml. Faites d’abord un fork du dépôt si vous voulez le modifier.
  2. Publier et l’essayer. « Publier » fige le commit qui vous a été montré : un changement ultérieur dans le dépôt ne modifie donc pas un lab que vous avez déjà proposé. Démarrez d’abord votre propre copie.
  3. Le distribuer. Attribuez-le comme n’importe quelle tâche, avec une échéance si vous le souhaitez, et indiquez dans la tâche ce qu’il faut faire et ce qu’il faut rendre.
  4. Noter ce qui est rendu. Ouvrez la copie d’un élève et le travail rendu, notez-le et renvoyez-le avec un motif s’il demande un complément.

Questions fréquentes

D’où npm tire-t-il l’agent, si le lab n’a pas de sortie ?
Du registre npm, par un proxy placé à côté de la copie, qui laisse passer le registre et refuse toute autre adresse.
Pourquoi la clé dans la configuration est-elle simplement le mot lab ?
Le lab ajoute la vraie clé au passage, si bien qu’elle ne se trouve jamais dans un fichier qu’un élève peut voir ou rendre. Tout ce qui est tapé à cet endroit est remplacé.
Pourquoi faut-il réinstaller l’agent après un redémarrage ?
Il pèse environ 140 Mo, plus qu’une copie ne peut en conserver. Le projet et la configuration sont conservés : l’installation est donc la seule étape à refaire.