Todas las rutas

Laboratorio de TypeScript

Patrones de diseño agéntico

Del primer prompt a una ejecución que puedes observar.

Laboratorio guiado basado en el material de estudio de Fernando Herrera (DevTalles), adaptado por Victor Flores. Incluye preparación, proveedores, cinco clases de Tool Use y siete clases de Planning con escenario, código y Excel de evaluación.

22 lecciones disponibles520 min aprox.
Tu recorrido0 / 22
Empezar la primera lección

El progreso se guarda en este navegador. No necesitas una cuenta.

Una primera llamada, un resultado observabletypescript

get-message-model.ts

const { text, usage } = await generateText({
  model,
  prompt: 'Responde solamente con: "OK, todo listo!"',
});

console.log(text.trim());
console.log(usage.totalTokens ?? 'No disponible');

Una instrucción pequeña para comprobar la conexión. Después añadiremos trazas y diagnóstico de errores.

Antes de empezar

Para quienes ya han programado y pueden leer funciones, objetos y async/await en JavaScript o TypeScript.

  • Variables, funciones, objetos y promesas de JavaScript o TypeScript.
  • Un editor, una terminal y Node.js con npm; Git para guardar tus cambios.
  • Para ejecutar las llamadas: acceso API y una credencial propia para un proveedor remoto, o un modelo local con Ollama y recursos suficientes. Puedes estudiar los conceptos y clasificar errores sin realizar llamadas.

Tu ruta de aprendizaje

Una mejora a la vez.

1. Preparación

  1. 01Prepara tu entorno de prácticaComprueba las herramientas y elige un solo proveedor para empezar.10 min · 3 pasos y práctica

2. Conceptos

  1. 02Qué problema resuelve un patrón agénticoDistingue una llamada al modelo de un sistema que usa herramientas, observa resultados y controla sus acciones.15 min · 4 pasos y práctica

3. Proyecto base

  1. 03Construye la base del proyectoConstruye la práctica mínima, ubica sus archivos y distingue código, dependencias y control de versiones.30 min · 7 pasos y práctica
  2. 04Haz tu primera llamada al modeloConfigura Groq y completa una prueba pequeña con generateText y async/await.25 min · 6 pasos y práctica
  3. 05Observa la ejecución con una trazaRegistra pasos, herramientas y tokens sin confundir observación con una evaluación del resultado.15 min · 4 pasos y práctica
  4. 06Interpreta los errores de la conexiónDistingue credenciales, límites, modelo y red antes de intentar otra llamada.15 min · 4 pasos y práctica

4. Proveedores

  1. 07Conecta Anthropic como alternativaCambia el adaptador y la credencial conservando las acciones, las trazas y el punto de entrada.20 min · 5 pasos y práctica
  2. 08Conecta OpenAI como proveedorConfigura el acceso a la API, selecciona gpt-5-mini y comprueba la conexión con la misma base de acciones.25 min · 6 pasos y práctica
  3. 09Conecta Google con GeminiPrepara tu proyecto y clave en AI Studio, selecciona un modelo de texto Gemini y comprueba la conexión.25 min · 6 pasos y práctica
  4. 10Ejecuta un modelo local con OllamaDescarga un modelo adecuado para tu equipo, conecta el servidor local y conserva las mismas acciones del proyecto.30 min · 7 pasos y práctica

Sesión 4 · Tool Use

  1. 11Sesión 4: Introducción a Tool UseParte de una petición sobre cursos sin acceso al catálogo y prepara una comparación antes y después de añadir herramientas.15 min · 6 pasos y práctica
  2. 12Comprueba la respuesta sin herramientasConstruye withoutTools, conecta la entrada y registra una respuesta que todavía no tiene acceso al catálogo.25 min · 5 pasos y práctica
  3. 13Crea la herramienta findCoursesDefine el catálogo didáctico, valida las entradas con Zod y devuelve coincidencias por título y nivel.30 min · 5 pasos y práctica
  4. 14Conecta las herramientas con el modeloRegistra findCourses, añade instrucciones y permite varios pasos para consultar el catálogo y redactar la respuesta.30 min · 5 pasos y práctica
  5. 15Calcula montos con calculateTotalAplica un descuento a IDs reales del catálogo y trata cursos ausentes antes de presentar un total.30 min · 5 pasos y práctica

Sesión 5 · Planeación

  1. 16Sesión 5: Introducción al patrón de planeaciónCompara one-shot y Planning: prepara un plan accionable, ejecútalo por etapas y sintetiza el contexto para conservar las reglas de la tarea.15 min · 6 pasos y práctica
  2. 17Prepara el escenario y la hoja de evaluaciónLee los datos de héroes y villanos, fija las reglas y utiliza el Excel para revisar la carga de trabajo.25 min · 5 pasos y práctica
  3. 18Prueba el enfoque one-shotEnvía la misión completa en una llamada y revisa la respuesta frente a la hoja de evaluación.25 min · 4 pasos y práctica
  4. 19Construye un plan estructuradoDefine goal y reason con Zod y pide al modelo un objeto de pasos antes de resolver la misión.30 min · 4 pasos y práctica
  5. 20Ejecuta el plan paso a pasoAnaliza cada etapa en secuencia, conserva sus findings y envía el paso actual junto al contexto anterior.30 min · 4 pasos y práctica
  6. 21Sintetiza los resultados en un plan finalIntegra la misión y los análisis parciales en una propuesta final y mide el consumo de las tres fases.25 min · 4 pasos y práctica
  7. 22Evalúa los resultados de PlanningCompara modelos y variantes usando el orden de captura, las horas y una asignación de referencia válida.30 min · 5 pasos y práctica

Lo que viene después

Estoy preparando estas sesiones. Las iré incorporando con ejemplos y ejercicios.

  • ReAct y controles de ejecución

    Observar resultados y volver a decidir con límites de pasos y manejo de fallos.

    En preparación

  • Human in the loop

    Pedir una revisión humana antes de ejecutar acciones que requieren aprobación.

    En preparación

Apuntes, ejercicios y cambios del curso.

Ver el repositorio