Unidad 3 - Taller 8: dirige tu propio agente

Taller práctico evaluable · Semana 8 · 06278-ECO

@emartigo Eduard F. Martínez G. eduard-martinez eduard-martinez.github.io

1 Instrucciones generales

Cómo funciona este taller

• Es individual y evaluable, y se desarrolla en el tiempo restante de la clase (⏱️ diseñado para ≈ 55 minutos).
• Se resuelve sin la guía del profesor: todo lo que necesitas está en este documento, en la práctica y en la teoría. Durante el taller el profesor solo atiende dudas logísticas (entrega, plataforma), no de contenido.
• Trabajas sobre el mismo proyecto de la práctica (tiendas_andinas/, con la base ya limpia). Si tu limpieza quedó a medias, tu primer paso es pedirle al agente que la complete — eso también es parte del oficio.
• Herramienta: el agente que usaste en la práctica (Copilot en VS Code, Claude Code o Cursor). Anota cuál y con qué modelo — lo declararás al final.

El entregable es un solo documento (Word o PDF) con cinco secciones numeradas:

• 📄 Nombre del archivo: apellido_nombre_taller8.pdf
• 🧾 Las evidencias son capturas de pantalla legibles (el panel del agente, tu terminal, los archivos generados) acompañadas de los textos que se piden en cada parte.
• 📤 Entrega: en el espacio habilitado en Intu antes de terminar la clase.

Advertencia

Reglas de juego (léelas: la rúbrica las aplica)

1. El bucle debe ser tuyo. Las capturas deben corresponder a tu sesión de hoy (se nota: usuario, rutas, fechas). Compartir un proyecto ya resuelto es fraude de ambos lados.
2. Los análisis escritos son tuyos. Los prompts al agente y sus respuestas van completos, pero las reflexiones de 2-6 líneas que se piden las redactas tú — sin pasarlas por el agente. Ya sabes que se nota.
3. Toda cifra reportada debe salir de código ejecutado — nunca de la “memoria” del modelo ni de la tuya. La Parte 4 existe para comprobarlo.
4. Plan B declarado: si tu agente no ejecuta comandos (modo “manos humanas” de la práctica), el taller vale igual — corre tú cada comando propuesto y captúralo. Decláralo en la Parte 5.

Distribuye tu tiempo: Parte 1 ≈ 5 min · Parte 2 ≈ 20 min · Parte 3 ≈ 10 min · Parte 4 ≈ 10 min · Parte 5 ≈ 10 min.

2 El encargo de la gerente

El informe de la práctica gustó. La gerente de Tiendas Andinas responde con una petición nueva — este es el trabajo que dirigirás hoy:

“Gracias por el informe. Ahora necesito decidir qué categoría de productos impulsar en cada ciudad con la pauta de mayo. ¿Me pueden mostrar cómo se reparte el ingreso entre categorías en cada ciudad, y una recomendación concreta por ciudad?”

Traducido a entregables del proyecto (agrégalo como Misión 4 — puedes pegárselo así al agente dentro de tu prompt):

Misión 4: partiendo de data/ventas_limpias.csv, escribe scripts/03_categorias.R
que (1) calcule el ingreso total por ciudad y categoría y lo exporte a
output/ingreso_ciudad_categoria.csv, y (2) produzca UN gráfico que permita
comparar la composición por categoría entre las tres ciudades, exportado a
output/ en PNG. Debe cumplir las reglas del proyecto y correr completo con
Rscript sin errores.

La recomendación por ciudad (2-3 líneas) la escribes tú en la Parte 5 — al agente le pides los números y el gráfico, no la opinión.

3 Parte 1 — El manifiesto (0.75 puntos)

Pega el contenido final de tu archivo de instrucciones (copilot-instructions.md, CLAUDE.md o equivalente), que debe incluir:

1. Las reglas base de la práctica, y
2. Dos reglas nuevas escritas por ti, verificables, pertinentes para la Misión 4 (piensa: formato del gráfico comparativo, redondeo de cifras, idioma de las categorías…). Márcalas con [MÍA] al inicio de la línea.

4 Parte 2 — El encargo y el bucle (1.25 puntos)

1. Pega el prompt que le enviaste al agente. Debe tener los cuatro ingredientes C-T-F-R identificables (no hace falta marcarlos — deben notarse).
2. Documenta el bucle con 2 o 3 capturas que muestren al agente en acción: leyendo archivos del proyecto, proponiendo/ejecutando comandos y — si ocurrió — encontrando un error y corrigiéndolo.
3. Narra en 3-5 líneas tuyas qué pasó en cada fase: qué planeó, qué ejecutó, qué observó y qué corrigió. Si acertó a la primera vuelta, también es un resultado válido: documenta la vuelta única y señala qué verificó el agente antes de darla por buena.

5 Parte 3 — Auditoría y reproducibilidad (1.25 puntos)

1. Auditoría (antes de aceptar): en 2-4 líneas, ¿qué revisaste en scripts/03_categorias.R antes de aprobarlo? Cita una regla concreta de tu manifiesto y muestra cómo comprobaste que el script la cumple (o cómo le exigiste al agente corregirla — captura del reclamo incluida, si aplica).
2. Reproducibilidad (después de aceptar): captura de tu terminal corriendo el script completo, de arriba a abajo, sin errores:

Rscript scripts/03_categorias.R

3. Captura del contenido de output/: el CSV nuevo y el PNG del gráfico (pega también el gráfico en el documento).

6 Parte 4 — La verificación (1.0 punto)

La regla de oro, con tus manos. Elige una cifra central del resultado (por ejemplo: el ingreso de la categoría líder en Cali) y:

1. Pega la cifra tal como la reportó el agente.
2. Recalcúlala tú, sin el agente — una línea en la terminal basta:

Rscript -e 'd <- read.csv("data/ventas_limpias.csv"); aggregate(precio*unidades ~ ciudad + categoria, d, sum)'

3. Captura tu comando con su salida y escribe el veredicto (1-2 líneas): ¿coinciden? ¿Por qué era esperable que coincidieran (o qué explica la diferencia)?

Ojo: si las cifras NO coinciden, no es un desastre — es un hallazgo. Rastrea la causa (¿el agente usó otra base? ¿filtró filas que tú no?) y documéntala: un descuadre bien explicado vale el punto completo.

7 Parte 5 — El juicio y la recomendación (0.75 puntos)

1. La recomendación a la gerente (tuya): con la tabla y el gráfico a la vista, escribe 2-3 líneas por ciudad: qué categoría impulsarías en cada una y por qué. Lenguaje de negocio, no de código.
2. El juicio sobre el agente (tuyo): en 4-6 líneas — ¿qué hizo bien que el chat del navegador no habría podido hacer? ¿Qué tuviste que corregirle o exigirle tú? ¿Qué parte de este trabajo NO le delegarías todavía, y por qué?

8 Rúbrica de evaluación

La presentación (orden, secciones numeradas, capturas legibles) se descuenta hasta -0.3 si dificulta la revisión.

Parte	Qué se evalúa	Puntos
1. Manifiesto	Reglas base presentes; las dos reglas propias son verificables y pertinentes (no deseos vagos)	0.75
2. Encargo y bucle	Prompt con C-T-F-R completo; capturas que evidencian al agente leyendo/ejecutando en TU proyecto; narración propia de las cuatro fases	1.25
3. Auditoría y reproducibilidad	Revisión previa citando una regla del manifiesto y su comprobación (0.5); script corriendo completo en tu terminal (0.5); outputs presentes y gráfico pegado (0.25)	1.25
4. Verificación	Cifra del agente + recálculo propio con comando visible + veredicto correcto (o descuadre bien explicado)	1.0
5. Juicio y recomendación	Recomendación por ciudad basada en los datos; juicio crítico propio sobre qué delegar y qué no	0.75
Total		5.0

9 Declaración de uso de IA

Cierra tu documento con este mini-formato diligenciado:

Agente y modelo usados: ____________________ (p. ej., Copilot — GPT / Claude Code — Opus)
Modo de ejecución: __________________________ (agente ejecutó / "manos humanas")
Lo que acepté sin cambios: __________________________________________________
Lo que corregí o exigí corregir: ____________________________________________
Verifiqué por mi cuenta: ____________________________________________________

Nota: en este taller el agente no solo está permitido — es el objeto de evaluación. Lo que se califica es cómo lo diriges: tus reglas, tu auditoría, tu verificación y tu juicio. Esa es la política de IA del curso funcionando en su nivel más alto.