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.
Antes de empezar
- Puedes leer y editar TypeScript básico: funciones, objetos, bucles y await.
- Tienes Git, Node.js 20.9 o posterior, una terminal y un editor de código.
- Reserva entre dos y tres horas para las nueve etapas guiadas (0–8); el proyecto de transferencia de la etapa 9 es abierto y puedes parar y volver más tarde.
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.
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 muestra porcentajes ni estados de Continuar o Completado para la parte 3 porque no puede observar ese archivo.
npx tsx course/report.ts
# reads course/progress.json in this cloneLo 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.