Documentación
Guías cortas y directas para poner VCodePro a funcionar en tu colegio: instalación, modo aula, creación de agentes de inteligencia artificial, evaluación con rúbricas y solución de problemas.
Guía 1
Primeros pasos
-
Instala el editor
Descarga el instalador de tu sistema operativo desde la página de descargas. En Windows, para una sala de cómputo usa el instalador de sistema; para un equipo personal, el de usuario.
-
Activa la licencia
Abre Ayuda › Licencia y escribe la clave institucional, o hazlo desde el portal de licencias. La activación habilita el modo aula, las rúbricas y el estudio de agentes.
-
Elige el idioma y el tema
La interfaz viene en español. Para preparar los exámenes en inglés, cámbiala desde Preferencias › Idioma sin perder los proyectos.
-
Crea el primer proyecto
Usa Archivo › Nuevo proyecto del aula y elige una plantilla del banco. Cada plantilla trae el enunciado, los archivos base y las pruebas.
Consejo. En la sala de cómputo, activa la licencia en un equipo, exporta el
archivo aula.config y cópialo al resto: los demás computadores heredan la
configuración sin volver a escribir la clave.
Guía 2
Modo aula
El modo aula conecta los equipos de la sala con el del docente. Funciona en la red local del colegio y no requiere servidores adicionales.
Crear un curso
En la barra lateral, abre Aula y pulsa Nuevo curso. Define el nombre del grupo, el nivel y el docente responsable. El sistema genera un código de clase de seis caracteres que los estudiantes escriben una sola vez.
# También puedes crearlo desde la terminal integrada
vcodepro aula crear --nombre "9B Diseño" --nivel 9
vcodepro aula invitar --curso "9B Diseño" --lista estudiantes.csvRepartir un proyecto
Abre el proyecto plantilla y pulsa Compartir con el curso. Cada estudiante recibe su copia con los archivos base, el enunciado y las pruebas. Los cambios que hagas después en la plantilla no sobrescriben el trabajo ya iniciado.
Seguir la clase en vivo
El tablero muestra una tarjeta por estudiante con el archivo abierto, el resultado de las pruebas y si pidió ayuda. Al hacer clic en una tarjeta puedes ver su pantalla; para escribir en su código necesitas que acepte la solicitud.
Recibir entregas
Define una fecha límite al compartir el proyecto. Al vencer, VCodePro toma la última versión de cada estudiante, la marca como entrega y la deja lista para evaluar. Las entregas tardías quedan señaladas, no bloqueadas.
Guía 3
Crear tu primer agente de inteligencia artificial
Un agente es un asistente con un propósito definido, un conjunto de herramientas y unos límites. Crearlo es una actividad de clase completa: exige delimitar el problema, probar y documentar.
-
Abre el estudio de agentes
Barra lateral › Agentes › Nuevo agente. Elige empezar con el formulario guiado o directamente con el archivo de definición.
-
Escribe el propósito
Una o dos frases: a quién ayuda, en qué y qué no debe hacer. Es la parte que más discusión genera en clase y la más evaluable.
-
Habilita herramientas
Solo las necesarias. Cada herramienta amplía lo que el agente puede ver y hacer, y queda registrada en el archivo de definición.
-
Prueba con casos
Agrega casos al banco de evaluación: entrada esperada, respuesta aceptable y criterios. El agente debe superarlos antes de publicarse.
-
Publica para el curso
El docente revisa la definición y aprueba. El agente aparece en la barra lateral de todo el grupo, con cuota de uso semanal.
Anatomía de un archivo de agente
# agentes/tutor-algoritmos.agent.yaml
nombre: Tutor de Algoritmos
modelo: vcp-tutor-1
modo: pedagogico
instrucciones: |
Acompañas a estudiantes de 9.° grado en ejercicios de algoritmos.
Nunca entregues la solución completa.
Responde con una pregunta que acerque al siguiente paso.
herramientas:
- leer_proyecto # archivos de la carpeta actual
- ejecutar_pruebas # corre las pruebas y lee el resultado
- buscar_en_apuntes # material del curso
limites:
mensajes_por_sesion: 30
tokens_por_semana: 50000
bloquear_en_examen: true
evaluacion:
casos: pruebas/tutor-algoritmos/
minimo_aprobado: 0.85Comandos útiles
vcodepro agente probar tutor-algoritmos # corre el banco de casos
vcodepro agente publicar tutor-algoritmos --curso "9B"
vcodepro agente registro --curso "9B" --exportar csv
vcodepro aula examen --activar # desactiva toda la IABuena práctica. Pide a los estudiantes que expliquen por qué habilitaron cada herramienta. Esa justificación es evidencia directa del criterio de diseño y evita agentes con permisos innecesarios.
Guía 4
Evaluar con las rúbricas del IB
Cada proyecto puede llevar asociada una rúbrica con los criterios del programa. El estudiante la ve desde el primer día y la usa para autoevaluarse antes de entregar.
| Criterio | Qué evalúa | Evidencia automática |
|---|---|---|
| A · Indagar y analizar | Investigación y planteamiento del problema | Notas de la bitácora y fuentes registradas |
| B · Desarrollar ideas | Especificaciones y diseño de la solución | Diagramas, versiones y justificación de decisiones |
| C · Crear la solución | Plan de trabajo y producto final | Historial de cambios, pruebas superadas y demostración |
| D · Evaluar | Pruebas con usuarios y mejoras propuestas | Resultados de pruebas y reflexión final |
Exportar las notas
vcodepro notas exportar --curso "9B Diseño" --formato csv
vcodepro notas exportar --curso "9B Diseño" --formato pdf --con-evidenciasEl archivo CSV usa punto y coma como separador y codificación UTF-8, compatible con los sistemas académicos más usados en los colegios.
Referencia
Requisitos y compatibilidad
| Elemento | Detalle |
|---|---|
| Sistemas operativos | Windows 10 y 11, macOS 11 o superior, Debian, Ubuntu, Fedora, RHEL y SUSE |
| Arquitecturas | x64 y ARM64 |
| Memoria mínima | 4 GB, recomendado 8 GB |
| Lenguajes incluidos | Python, JavaScript, HTML, CSS, Java y C++ |
| Red para el modo aula | Red local del colegio; 10 Mb/s por sala para la IA |
| Puertos del modo aula | 7845 y 7846 en la red local (TCP) |
| Trabajo sin conexión | Editor, proyectos y rúbricas; la IA requiere conexión |
Referencia
Atajos de teclado
| Acción | Atajo |
|---|---|
| Paleta de comandos | Ctrl + Shift + P |
| Ejecutar el proyecto | F5 |
| Ejecutar las pruebas | Ctrl + Shift + T |
| Abrir el asistente de IA | Ctrl + I |
| Abrir el estudio de agentes | Ctrl + Shift + A |
| Explicar la selección | Ctrl + Alt + E |
| Levantar la mano digital | Ctrl + Shift + H |
| Abrir la bitácora de diseño | Ctrl + Shift + B |
| Entregar el proyecto | Ctrl + Shift + Enter |
| Terminal integrada | Ctrl + Ñ |
Soporte
Solución de problemas
Los estudiantes no ven el curso en el tablero
Verifica que todos los equipos estén en la misma red local y que los puertos 7845 y 7846 no estén bloqueados por el cortafuegos. Si la sala usa redes separadas para docentes y estudiantes, pide al área de sistemas que permita el tráfico entre ellas.
La licencia aparece como no válida
Revisa que la clave esté completa: cuatro bloques de cuatro caracteres
después de VCP. Si el mensaje indica que el dígito de control no coincide, hubo
un error al escribirla. Puedes verificarla sin activarla en el
portal de licencias.
El asistente de IA no responde
Comprueba si el curso está en modo examen: en ese estado toda la IA queda desactivada a propósito. Si no lo está, revisa la conexión a internet y la cuota semanal del grupo en el panel del docente.
Un agente publicado no aparece para los estudiantes
Un agente solo se publica cuando supera el mínimo del banco de casos y
el docente lo aprueba. Ejecuta vcodepro agente probar para ver qué casos fallan.
La instalación silenciosa falla en la sala
Usa el instalador de sistema, no el de usuario, y ejecútalo con permisos de administrador. Revisa la guía de despliegue masivo con los comandos de cada sistema operativo.
¿No encontraste lo que buscabas?
El equipo de soporte responde en menos de dos días hábiles, en español, alemán o inglés.
Escribir a soporte