Un ordinateur neuf, vide
Dans la leçon précédente, l'agent était prêt et t'attendait. Au travail, on démarre souvent avec un ordinateur où il n'y a rien. Aujourd'hui, tu installes l'agent toi-même, tu lui dis où se trouve son modèle, et tu t'en sers de nouveau sur le programme de la caisse de la cafétéria.
À la fin de cette leçon
Remarque
Je peux installer un agent de code et le relier à un modèle.
Mots clés
- Paquet (« package ») : un programme emballé pour pouvoir être installé.
- npm : l'outil qui installe les paquets JavaScript.
- Fichier de configuration : un fichier de réglages qu'un programme lit au démarrage.
- Endpoint (point d'accès) : l'adresse web à laquelle un programme envoie ses requêtes.
- Proxy : un intermédiaire qui décide quelles adresses on peut joindre.
Avant de commencer
Remarque
Appuie sur Démarrer le lab dans la barre en haut de cette leçon et attends qu'il indique qu'il tourne. Le lab est un seul service appelé agent, et le terminal l'atteint par ce nom. Chaque bouton Exécuter ci-dessous tape sa commande dans le terminal de ton lab, l'une après l'autre dans la même session. Pour les suivre, ou pour taper tes propres commandes, appuie sur Ouvrir le terminal (nouvel onglet) dans la barre.
1. Rien n’est installé
npm ls -g liste les paquets installés pour tous les projets de cet ordinateur. La liste est vide : il n'y a pas encore d'agent.
docker exec agent npm ls -gAffichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
2. Installer l’agent
Le @1.19.3 à la fin fixe une version exacte, pour que toute la classe ait le même agent. L'installation prend environ une minute. Si elle s'arrête avec le mot Killed, le lab a manqué de mémoire pendant que npm écrivait les fichiers : relance-la. Demande ensuite à l'agent quelle est sa version.
docker exec agent npm install -g --no-fund --no-audit [email protected]Affichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
docker exec agent opencode --versionAffichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
Comment npm est sorti du lab
Remarque
Ce lab n'a pas d'accès à Internet. npm a obtenu le paquet par un proxy à l'adresse http://ai:3128, qui laisse passer le registre npm et rien d'autre. Toute autre adresse est refusée.
3. Dire à l’agent où est son modèle
L'agent ne sait pas quel modèle utiliser tant qu'un fichier de configuration ne le lui dit pas. Lis l'exemple. baseURL est l'endpoint, le modèle de la plateforme à ai:4000. model le choisit par son nom, lab/lab. permission fait que l'agent te demande avant de modifier un fichier ou de lancer une commande. Ensuite, crée le dossier et copie-y le fichier.
docker exec agent cat /home/node/opencode.example.jsonAffichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
docker exec agent mkdir -p /home/node/.config/opencodeAffichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
docker exec agent cp /home/node/opencode.example.json /home/node/.config/opencode/opencode.jsonAffichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
Une erreur courante
Attention
Beaucoup de gens croient qu'un agent a besoin d'une clé secrète dans sa configuration pour joindre un modèle. Ici, la clé est lab, une valeur de remplacement. Le lab ajoute la vraie clé au passage, donc elle n'est jamais dans un fichier que tu pourrais partager par erreur. Ne colle jamais une vraie clé dans une configuration que tu rends.
4. Utiliser ton agent
D'abord une question, pour montrer que la configuration marche. Ensuite, ouvre l'écran de l'agent et demande-lui de corriger le bug dans total, comme dans la leçon précédente : lis chaque modification avant de l'autoriser, et appuie deux fois sur Ctrl+C pour le fermer. Puis lance les tests.
docker exec -w /home/node/project agent opencode run "In one sentence, what does shop.js do?"Affichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
docker exec -it -w /home/node/project agent opencodeAffichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
docker exec -w /home/node/project agent node --testAffichée ici, non exécutée. Créez un compte gratuit pour appuyer sur Exécuter et la saisir dans le terminal de votre propre labo.
Questions auxquelles répondre
- Pourquoi l'installation indique-t-elle une version exacte,
@1.19.3? - Quelle ligne de la configuration dit où est le modèle ?
- Comment npm a-t-il joint le registre alors que le lab n'a pas d'accès à Internet ?
- Pourquoi n'y a-t-il pas de vraie clé dans ta configuration ?
- Après un arrêt et un redémarrage, que dois-tu refaire, et pourquoi ?
Pour les enseignants
Astuce
Cette leçon est un petit exemple de leçon travaillée dans un lab : les étapes et les boutons Exécuter sont la leçon, et le lab est la copie personnelle de chaque élève. Le lab est celui de la première leçon, mais vide : l'élève installe opencode depuis npm par un proxy à liste d'adresses autorisées, puis copie une configuration à sa place. Points clés : 1. Un programme s'installe comme un paquet, fixé sur une version. 2. Un fichier de configuration dit à un agent où est son modèle. 3. Une clé ne va jamais dans un fichier qu'on rend. Guettez l'élève qui croit que l'agent marche sans configuration, et demandez-lui de le lancer avant la copie. L'élève rend son opencode.json, les tests avant et après, et ses réponses. Copiez-la dans votre propre module et modifiez-la, ou construisez-en une de zéro avec le menu Lab du créateur de leçons.