Modo guionizado sin conexión
No necesita clave ni realiza solicitudes de pago. Comprueba la ruta de código, pero no puede demostrar la variación del modelo.
--offlineConstruye el agente en tu propio equipo
La parte 3 tiene nueve etapas guiadas de TypeScript (0–8), más un proyecto de transferencia en la etapa 9. Esta página prepara las herramientas locales, verifica sin conexión la etapa 0 y después te dirige al repositorio sin fingir que el sitio web puede ver tu progreso.
Un punto de partida, no un IDE en línea
Tu código, las claves de los modelos, los resultados y el progreso permanecen en tu clon local. Este sitio web estático no ejecuta el curso ni lee course/progress.json.
El curso en sí está en inglés. El sitio está en nueve idiomas, pero las guías de las etapas, el menú del café y los veinte casos de prueba no se traducen: traducir las entradas medidas cambiaría el ejercicio, que es la misma razón por la que los casos del Laboratorio siguen en inglés.
Antes de empezar
- Puedes leer y editar TypeScript básico: funciones, objetos, bucles y await.
- Tienes Git, Node.js 24, una terminal y un editor de código.
- Reserva unas cuatro horas para las nueve etapas guiadas (0–8); el proyecto de transferencia de la etapa 9 es de final abierto y puedes parar y volver más tarde.
¿Ya terminaste el Laboratorio? Las etapas 1–4 serán un repaso: esta vez el código lo escribes tú.
Ejecuta primero la etapa 0 sin conexión
1. Clonar e instalar
Clona el repositorio público, entra en él e instala exactamente las dependencias bloqueadas.
Ese clon y esa instalación se traen el sitio entero —varios cientos de megabytes, porque el curso comparte el manifiesto del sitio—. El curso en sí importa un solo paquete. Dale unos minutos con una conexión lenta.
git clone https://github.com/HUDongpin/agent-edu.git cd agent-edu npm ci2. Haz el único cambio de la etapa 0
Abre course/stage0-hello/run.ts y sustituye la cadena QUESTION vacía por una pregunta propia.
export const QUESTION = "What should I notice about an API?";3. Ejecútalo y compruébalo sin una clave
El modo sin conexión utiliza un sustituto determinista incluido. Es la comprobación previa más segura: sin solicitudes al proveedor, grabaciones privadas ni cargos por tokens.
npm run course:offline npx tsx course/stage0-hello/run.ts --offline npx tsx course/check.ts 0 --offline
La comprobación se completa cuando ves
PASS you asked the model something
PASS an answer came back
stage 0 complete.Elige un proveedor solo cuando estés listo
DeepSeek
El proveedor en vivo predeterminado. El proceso de la terminal lee DEEPSEEK_API_KEY; las etapas en vivo generan cargos de DeepSeek e imprimen el gasto medido.
export DEEPSEEK_API_KEY=your_key_hereClaude
Un proveedor local opcional para comparar. Define la clave y CAFE_PROVIDER. Los precios de Claude pueden ser mucho más altos, así que revisa la estimación mostrada antes de ejecutar.
export ANTHROPIC_API_KEY=your_key_here
export CAFE_PROVIDER=anthropicLos costes corresponden al proveedor
El modo sin conexión es gratuito. Los totales en vivo varían según el modelo seleccionado, los tokens, la caché y los precios actuales del proveedor. Considera fechadas todas las estimaciones del curso; el panel del proveedor es el registro de facturación.
El progreso pertenece a este clon
El verificador del curso escribe course/progress.json localmente. El sitio web no puede observar ese archivo, así que no muestra ningún porcentaje ni estado de Continuar para la parte 3: solo la nota que dejes para ti más abajo.
npx tsx course/report.ts
# reads course/progress.json in this cloneAquí no hay nada que compruebe tu trabajo. Si has terminado las etapas, puedes anotarlo para ti. La nota se guarda en este navegador, no se envía a ningún sitio y puedes borrarla cuando quieras.
Lo que te llevarás
La etapa 9 te pide dejar atrás la cafetería y documentar un agente en un ámbito que conozcas. Una entrega revisable incluye:
- los límites del problema y lo que el modelo puede decidir;
- una entrada de fallo realista que rompa las reglas sencillas;
- un pequeño conjunto de evaluación con evidencias, no solo resultados buenos seleccionados;
- una barrera impuesta mediante código antes de la acción más irreversible;
- los límites del proveedor, de las herramientas y de las entradas no confiables;
- una breve retrospectiva sobre fallos, compromisos y la siguiente prueba.
Si la configuración local te resulta demasiado difícil
Vuelve al Laboratorio del navegador y practica primero reglas → prompt → evaluación. Enseña la misma transferencia de control sin pedirte que instales un entorno de desarrollo.