Laboratorio para instalar un agente de programación con IA: npm, un archivo de configuración y un modelo

Este laboratorio es el del agente de programación sin nada instalado. Cada alumno instala opencode, un agente de programación con IA de código abierto, desde npm, lee un archivo de configuración de ejemplo y lo copia a su sitio, y después usa el agente con el mismo pequeño programa de caja de la cafetería.

La copia no tiene más salida a internet que dos: el registro de npm, a través de un proxy que no deja pasar nada más, y el modelo de la plataforma. El agente funciona para las mismas personas que en el primer laboratorio, con la misma asignación.

Qué aprenden los alumnos

Que un programa se instala como paquete y se fija a una versión, que un archivo de configuración le dice a un programa dónde están sus servicios y que una clave nunca va en un archivo que se entrega. Encaja en una primera clase sobre instalar y configurar herramientas.

Ejecútalo en tu navegador

El laboratorio inicia un solo servicio, agent, con el proyecto en /home/node/project y una configuración de ejemplo en /home/node/opencode.example.json.

  1. Abre la página Contenedor. Abre «Crear» en la barra y elige «Ejecutar un contenedor». Cualquiera puede abrir la página, y el laboratorio de Git y el de SQL se inician sin cuenta. Todos los demás laboratorios necesitan una cuenta gratuita: crea una, inicia sesión y pulsa «Iniciar».
  2. Busca el laboratorio. La tarjeta «Laboratorios de ejemplo» lista todos los ejemplos. Busca el agente de programación que se instala uno mismo.
  3. Pulsa «Iniciar». «Iniciar» lo ejecuta tal cual, con una sola pulsación. «Editar el archivo primero» abre el archivo compose para que lo cambies antes de iniciarlo.
  4. Ábrelo. En la página del laboratorio, pulsa «Abrir terminal». docker exec agent npm install -g [email protected] instala el agente, docker exec agent opencode --version muestra su versión, y la lección copia la configuración de ejemplo a su sitio.

Qué pedir a los alumnos que entreguen

Su opencode.json, las pruebas antes y después de la corrección y una frase sobre qué hace cada línea de la configuración.

Una lección básica en este laboratorio

AI Coding Agent Basics 2 es una pequeña lección que se trabaja en este laboratorio, después de AI Coding Agent Basics. En ella el alumno instala el agente, lee y copia su configuración, le hace una pregunta y después corrige el error con él.

Las cuentas personales gratuitas la tienen en el módulo Basics, que está en «Inicio», cada centro puede copiarla desde la carpeta Basics de la Biblioteca, y un centro nuevo la tiene en un módulo llamado DevOps Labs (Sample). Cópiala en un módulo tuyo para cambiarla.

El código en GitHub

El archivo compose no tiene Dockerfile: ejecuta la imagen oficial de node, fijada a una versión, con un usuario sin privilegios. opencode tiene licencia MIT; lo instala el alumno y no lo distribuimos nosotros. El proyecto y la configuración se guardan en un volumen con nombre; el agente no, así que se instala de nuevo tras un reinicio.

Asígnalo como trabajo

Indica en la tarea qué hay que entregar.

  1. Crea el laboratorio. En tu módulo añade una tarea y elige la tarjeta «Laboratorio de contenedores», y después «En un repositorio de GitHub». Indica https://github.com/mitsurutech/lab-ai-agent-install con la rama main. El archivo compose es el predeterminado, compose.yaml. Haz un fork del repositorio antes si quieres modificarlo.
  2. Publica y pruébalo. «Publicar» fija el commit que te mostraron, así que un cambio posterior en el repositorio no altera un laboratorio que ya has asignado. Inicia primero tu propia copia.
  3. Asígnalo. Asígnalo como cualquier tarea, con una fecha de entrega si quieres, e indica en la tarea qué hacer y qué entregar.
  4. Califica lo entregado. Abre la copia de un alumno y el trabajo que ha entregado, califícalo y devuélvelo con un motivo si necesita más.

Preguntas frecuentes

¿De dónde saca npm el agente, si el laboratorio no tiene salida?
Del registro de npm, a través de un proxy junto a la copia que deja pasar el registro y rechaza cualquier otra dirección.
¿Por qué la clave de la configuración es solo la palabra lab?
El laboratorio añade la clave real por el camino, así que nunca está en un archivo que un alumno pueda ver o entregar. Lo que se escriba ahí se sustituye.
¿Por qué hay que instalar el agente de nuevo tras un reinicio?
Ocupa unos 140 MB, más de lo que una copia puede guardar. El proyecto y la configuración se conservan, así que la instalación es el único paso que hay que repetir.