Sistema, Datos, IA

Examen final de 24 horas. Analítica de Datos con Inteligencia Artificial. Universidad de La Sabana.

Portada

Qué entregas, en una frase

Una carpeta comprimida con tu dibujo en foto, tu modelo corriendo, tu dashboard, 2 insights con su conclusión y 2 empleados IA, uno por problemática.

Qué vas a demostrar

  1. Que entiendes un modelo de Dinámica de Sistemas, lo dibujas y lo haces correr con datos reales.
  2. Que sabes ingestar datos reales en tu DuckDB local y conectarlos a un dashboard.
  3. Que sabes calcular media, mediana, moda, desviación y coeficiente de variación, y leer un histograma.
  4. Que sabes escribir 3 hechos y 2 insights con un número cada uno, y la conclusión de cada insight.
  5. Que sabes diseñar y gobernar 2 empleados IA, uno por problemática, con prompt, hoja de vida y marco de gobierno de IA.

Solo necesitas Python

Solo necesitas Python en tu computador, como en clase. El script de ingesta instala DuckDB por sí solo. Todo lo demás pasa en el navegador. Necesitas: Python, un navegador (Chrome, Edge o Safari), lápiz, papel, un celular para la foto y tu correo.

Nota de contenido

Los datos son los casos de COVID-19 en Colombia. Incluyen fallecidos. Si el tema te duele, el examen no te obliga a usar la variable fallecidos. Puedes decírselo al profesor en privado. Hay una alternativa lista.

Tres reglas que te cuidan

  1. El examen tiene tres pilares. Cada pilar vale un tercio de la nota. La nota final es el promedio de los tres.
  2. La entrega es única: sábado 14 de noviembre, 7:00 pm. Se califica lo que llegue antes de esa hora, aunque esté incompleto.
  3. Cada bloque tiene una línea "Ya es suficiente". Cuando la leas, para y sigue al siguiente bloque.

Panel de control

Llena esta tabla antes de empezar. Toma los datos de tu archivo Exxx-ficha.md. Ejemplo: si tu carpeta se llama E042, tu código es E042.

Campo Tu dato
Mi código E___
Mi territorio y su código ______________ (código __)
Mi familia (patrón) F__ ______________
Mi instancia COVID ______________
Mis ciclos (nombre y letra R o B) ____ (R/B), ____ (R/B)
Mi nodo por dibujar ______________
Mis 5 variables del dashboard Real (datos) o simulada (modelo) En ciclo sí/no
1. ______________
2. ______________
3. ______________
4. ______________
5. ______________

Archivos que recibes en tu carpeta Exxx/

Archivo Para qué sirve
Exxx-modelo.html Tu modelo en una página web, 70 % hecho. Se abre en el navegador
Exxx-ficha.md (y .html) Panel, historia del sistema, tareas con pistas, chequeos
ingesta_Exxx.py El script de ingesta. Crea tu base DuckDB local, tu CSV, tu dashboard y tu evidencia
duckdb_Exxx.sql El mismo proceso en bloques de SQL, con las mismas rutas. Es el plan B
dashboard_plantilla.html Copia de la plantilla del dashboard. Sirve si no corres el script
vista_Exxx_duckdb.sql La receta SQL de la vista de tu territorio. Solo lectura
datos_Exxx.csv Respaldo: los datos de tu territorio, 731 días, 21 variables, un día por fila

Herramientas comunes (kit común)

Archivo Para qué sirve
dashboard/dashboard_plantilla.html La plantilla del dashboard (también está en tu carpeta): estadísticas, histogramas, lecturas, hechos e insights
ia/empleado_ia_plantilla.html El formulario de cada empleado IA. Se llena y se descarga
ia/superprompt_plantilla.md Lectura corta: cómo escribir el prompt con rails y el harness
ia/tarjeta_AIR2024.md El catálogo de riesgos AIR 2024 en español
ia/bitacora_ia_plantilla.md La forma de tu bitácora de IA
guia/GUIA-PERMANENTE.md La guía que te queda: sistemas, datos, IA

Datos

Dato Valor
Archivo covid_diario.csv
Fuente datos.gov.co, conjunto gt2j-8ykr
Filas 252,677 filas
Casos 6,388,216 casos
URL https://class.audience-analysis.com/analitica-examen/covid_diario.csv

Tu plan de 24 horas

El examen empieza el viernes a las 19:00 y cierra el sábado a las 19:00. Sigue el reloj, no tu sensación de tiempo. Pon una alarma al inicio de cada bloque.

Hora Bloque Qué haces Pilar
Viernes 19:00-19:30 Bloque 0 Preparar: abrir carpeta, abrir Exxx-modelo.html, mirar el modelo y sus signos
19:30-21:00 Bloque 1 Ingesta a DuckDB local con ingesta_Exxx.py + mirar mi_territorio_Exxx.csv 2
21:00-23:00 Bloque 2 Dibujo a mano del modelo completo + 5 frases 1
23:30-07:00 Dormir 7 horas y media. Es parte del plan.
Sábado 07:00-08:30 Bloque 3 Pasar el dibujo al HTML: correr, chequeos, simular, exportar 1
08:30-10:30 Bloque 4 Dashboard conectado a tu base: 5 variables, estadísticas, histogramas, lecturas 2
10:30-12:00 Bloque 5 Entiende tu tablero: hechos, insights, conclusiones, transferencia 2
12:00-13:00 Almuerzo Comer lejos del computador
13:00-16:00 Bloque 6 Empleado IA 1 completo y empleado IA 2 + bitácora 3
16:30-18:30 Bloque 7 Revisar, comprimir, enviar
19:00 Entrega única y cierre Sábado 14 de noviembre, 7:00 pm. Se califica lo que llegue antes de esa hora, aunque esté incompleto

Los 3 pilares en un dibujo

+---------------------------+   +-----------------------------+   +---------------------------+
|  PILAR 1 (centro)         |   |  PILAR 2 (izquierda)        |   |  PILAR 3 (derecha)        |
|  Modelo de Dinámica       |-->|  Análisis de datos          |-->|  Dos empleados IA         |
|  de Sistemas  (un tercio) |   |  (un tercio)                |   |  (un tercio)              |
|                           |   |                             |   |                           |
|  nodos y arcos con signo  |   |  DuckDB local + ingesta     |   |  1 por problemática       |
|  dibujo a mano + HTML     |   |  5 variables: media,        |   |  hoja de vida             |
|  correr, chequeos,        |   |  mediana, moda, desviación, |   |  prompt con rails         |
|  simular, exportar        |   |  CV, histograma, lectura    |   |  harness                  |
|                           |   |  3 hechos + 2 insights      |   |  riesgos, políticas,      |
|                           |   |  dashboard HTML             |   |  procesos, contención     |
+---------------------------+   +-----------------------------+   +---------------------------+
       Bloques 0, 2 y 3               Bloques 1, 4 y 5                     Bloque 6

Regla de orden (obligatoria): modelo entendido y dibujado, luego datos, luego IA.

  1. Primero entiendes el modelo y lo dibujas completo a mano, con signos en los arcos (Pasos 0 y 2).
  2. Después pasas el dibujo al HTML y lo haces correr (Paso 3).
  3. Solo con la foto del dibujo y el HTML corriendo pasas al análisis de datos (Pasos 4 y 5).
  4. Solo después del análisis pasas a los empleados IA (Paso 6).

El Paso 1 (ingesta a DuckDB local) va el viernes porque dura poco y confirma que tus datos abren. Sin la foto modelo_mano_Exxx.jpg no se califica el Pilar 2. Es una puerta, no un bono.


Paso a paso

Paso 0. Preparar (Bloque 0)

Qué haces

  1. Descomprime tu carpeta Exxx/. Ejemplo: E042/.
  2. Llena el Panel de control de esta guía con tu ficha.
  3. Abre Exxx-modelo.html en el navegador. Debe mostrar el diagrama con casillas ?.
  4. Mira el modelo: nodos (cajas, válvulas, círculos) y arcos (flechas). Cada arco tiene un signo + o -.
  5. Lee el signo de 3 arcos en voz alta. Ejemplo: "Infectados a infeccion es +: más infectados, más contagios."
  6. Abre datos_Exxx.csv con doble clic. Mira sus columnas: t, fecha y 21 variables.
  7. Ten a mano lápiz, papel y un marcador grueso para el Paso 2.

Qué significa terminado: el panel está lleno, el navegador abrió tu modelo, entiendes qué dice un signo.

Este bloque no entra en la nota, pero te ahorra horas después.

Ya es suficiente: deja de leer la ficha completa. La vas a usar paso a paso.

Si te atascas El HTML no abre: prueba otro navegador. Chrome, Edge y Safari sirven. El CSV abre en una sola columna: no importa. El dashboard lo leerá bien. Si sigue fallando: usa el horario de consultas de 19:00 a 19:30. Sigue con el Paso 1 mientras esperas.


Paso 1. Ingesta a DuckDB local con evidencia (Bloque 1)

DuckDB es la base de datos que usaste en clase. Corre en tu computador. Tu carpeta trae un script que hace la ingesta por ti.

Qué haces (plan A, el normal)

1a. Descomprime tu zip y entra a la carpeta Exxx.

1b. Corre el archivo ingesta_Exxx.py. Cambia Exxx por tu código. Ejemplo: ingesta_E042.py.

Si en Windows el doble clic no abre la ventana negra (abre un editor o no pasa nada): pulsa la tecla Windows, escribe cmd y Enter. Escribe py y un espacio. Arrastra ingesta_Exxx.py a la ventana. Pulsa Enter. Si py no sirve, prueba con python.

1c. Espera el mensaje LISTO (1 a 3 minutos). No instalas nada a mano: el script instala DuckDB si falta y abre tu tablero en el navegador. El script muestra 6 pasos:

Paso Qué hace Qué ves
[1/6] Descarga covid_diario.csv (15 MB, dataset gt2j-8ykr de datos.gov.co, resumido por día, departamento, sexo y grupo de edad) y revisa su sha256 El tamaño y que el sha256 es el esperado
[2/6] Crea tu base local examen_Exxx.duckdb con la tabla covid_diario 252,677 filas, 6,388,216 casos, 143,125 fallecidos COVID -> coincide
[3/6] Crea la tabla limpia covid_limpio y la vista de tu territorio v_territorio_X Ejemplo (E003, Valle del Cauca): v_territorio_76: 731 dias, 540,163 casos, 15,016 fallecidos, casos_7d promedio 738.8 -> 731 dias, coincide
[4/6] Exporta mi_territorio_Exxx.csv (731 filas, 23 columnas: t, fecha y las variables) El nombre del archivo y sus filas
[5/6] Crea dashboard_Exxx.html desde la plantilla, con tus datos ya adentro. Es la conexión base de datos -> tablero. Nunca borra un dashboard_Exxx.html que ya exista El nombre del archivo
[6/6] Escribe sql_Exxx.txt, tu evidencia El nombre del archivo

Al final lees: "LISTO. Siguiente paso: abre dashboard_Exxx.html y elige tus 5 variables."

1d. Abre sql_Exxx.txt. El script lo escribe solo. Trae la fecha y hora, la versión de DuckDB, el sha256, los conteos, los números de tu vista, las primeras filas y el SQL usado. Revisa que estén los dos conteos y los 3 números de tu vista. Ejemplo (Valle): "731 días, 540,163 casos, casos_7d promedio 738.8".

1e. Compara con tu respaldo. Abre mi_territorio_Exxx.csv y datos_Exxx.csv. Tienen el mismo contenido. Ejemplo: la suma de la columna casos debe dar los mismos casos de la ventana.

Plan B: SQL a mano

Si el script no corre, abre duckdb_Exxx.sql con un editor de texto (Bloc de notas o TextEdit). Tiene 7 bloques numerados. Pega un bloque a la vez. Espera a que termine antes del siguiente. Úsalo en tu DuckDB local (consola duckdb o duckdb -ui) o en https://shell.duckdb.org/. El bloque 6 (COPY a CSV) solo funciona en tu DuckDB local. El bloque 7 es opcional y muestra las trampas. Ahora escribes sql_Exxx.txt tú, con las mismas 4 cosas: los dos conteos (filas y casos), el nombre de tu vista, los 3 números y la fecha y hora. Ejemplo: "252,677 filas, 6,388,216 casos. Vista v_territorio_76. 731 días, 540,163 casos, casos_7d promedio 738.8. 2026-11-13 20:10."

Plan C: solo el CSV

Usa datos_Exxx.csv de tu carpeta. Tiene los mismos números. Pierdes solo el paso de ingesta (Paso 1).

Qué significa terminado: sql_Exxx.txt existe con los 2 conteos y los 3 números. Con el plan A, también existen examen_Exxx.duckdb, mi_territorio_Exxx.csv y dashboard_Exxx.html.

Se califica: ingesta a DuckDB local con evidencia.

Ya es suficiente: a las 20:00 deja de pelear con la instalación o el script. El resto del examen sigue sin ellos.

Si te atascas Dice que falta duckdb: el script lo instala por sí solo. Si no puede, corre el archivo otra vez. Si sigue fallando, usa el plan C. La descarga falla: revisa tu internet y corre el archivo otra vez. Si falla otra vez, usa el plan C. Nada funciona en 15 minutos: usa el plan C. Abre dashboard_plantilla.html con doble clic, pulsa Leer CSV y elige datos_Exxx.csv. Pierdes solo el paso de ingesta (Paso 1). El modelo y el dashboard siguen igual.


Paso 2. Dibujar el modelo completo a mano (Bloque 2)

Qué haces

2a. Abre Exxx-modelo.html. Mira el diagrama: nodos y arcos. Cada arco lleva un signo + o -. Lee las TAREAS de la página y de tu ficha. Una te dice qué nodo falta y en qué ciclo va. Toma lápiz y papel. Dibuja el modelo completo a mano, en este orden:

  1. Todos los stocks como cajas. Ejemplo: Susceptibles, Infectados, Recuperados.
  2. Todos los flujos como tubos con válvula. Las nubes marcan lo que queda fuera.
  3. Todos los convertidores como círculos, incluido el nodo que falta. Ejemplo: fraccion_susceptible.
  4. Todos los arcos con su signo. + si van en la misma dirección, - si van al revés.
  5. Cada ciclo con su nombre y su letra. Cuenta los signos - del ciclo: par es R, impar es B.
  6. Debajo del dibujo, 5 frases de cómo funciona el sistema.

Ejemplo de las 5 frases (familia F1): "Los Susceptibles se contagian y pasan a Infectados. Los Infectados se recuperan en 10 días. Más Infectados producen más contagios: ciclo R1. Menos Susceptibles frenan el contagio: ciclo B1. Los casos detectados son una parte de los contagios."

Fotografía el dibujo con buena luz, desde arriba. Guarda la foto como modelo_mano_Exxx.jpg (o .png o .pdf). Ponla en tu carpeta Exxx/. Si las 5 frases no se leen en la foto, cópialas en insights_Exxx.txt.

Qué significa terminado: la foto está en tu carpeta, se lee cada nombre y cada signo, cada ciclo tiene letra, hay 5 frases.

Se califica: dibujo a mano completo y correcto.

Ya es suficiente: deja de pasar el dibujo en limpio. Legible vale lo mismo que bonito.

Si te atascas No sabes dónde va el nodo nuevo: lee su TAREA en la ficha. Dice qué nodos lo alimentan y a cuál apunta. No sabes si un ciclo es R o B: cuenta los signos - del ciclo. Par es R, impar es B. La foto sale borrosa: dibuja con marcador grueso y toma la foto desde arriba, sin sombra.


Paso 3. Pasar el dibujo al HTML (Bloque 3)

Qué haces

3a. Abre Exxx-modelo.html. Los nodos con ? esperan tu fórmula. Una de ellas es un parámetro fácil. Ejemplo de parámetro fácil: duracion_infeccion = 10 días. Para cada ?, lee la TAREA en tu ficha. Hay 3 niveles de pista:

Nivel Qué te da Ejemplo (nodo recuperacion)
1 Concepto La idea "Cada día se recupera una parte de los infectados."
2 Fórmula en palabras La operación "Infectados dividido entre los días que dura la enfermedad."
3 Esqueleto con casillas La forma ____ / duracion_infeccion

Usa el nivel que necesites. No hay castigo. Anota el nivel usado en insights_Exxx.txt, sección "Pistas". Ejemplo: "recuperacion: pista nivel 2."

Escribe cada fórmula en su casilla. Usa los mismos nombres de los nodos. Ejemplo: Infectados / duracion_infeccion.

Agrega el nodo que faltaba con el botón Agregar convertidor. Es el mismo que dibujaste a mano. Escribe su nombre, sus entradas y su fórmula. Ejemplo: fraccion_susceptible = Susceptibles / poblacion. Luego busca la insignia PROVISIONAL en sus vecinos. Reemplaza la constante por el nombre del nodo nuevo. Ejemplo: en infeccion cambia 0.8 por fraccion_susceptible.

Pulsa Cargar datos y elige mi_territorio_Exxx.csv (o datos_Exxx.csv, tiene el mismo contenido). La página toma las columnas que necesitan los nodos d_. Ejemplo: la columna casos_7d alimenta d_casos_7d. Pulsa Correr. Debe correr de t = 0 a t = 730, 731 días. Mira el gráfico.

3b. Mira los chequeos de aceptación en la página. Cada uno dice PASA o FALLA. Ejemplo: "Infectados tiene su pico entre el día 90 y el día 130: PASA." Marca cada chequeo con sí o no en tu ficha.

3c. Simula una vez. Cambia un parámetro y vuelve a pulsar Correr. Mira qué cambia en el gráfico. Ejemplo: sube tasa_contacto de 6 a 8 y mira si el pico llega antes. Escribe 1 frase con lo que viste en insights_Exxx.txt, sección "Simulación". Luego devuelve el parámetro a su valor.

Exporta: pulsa Exportar salidas CSV. Se guarda salidas_Exxx.csv en formato largo: t, variable, valor, origen. Pulsa Descargar este HTML. Se guarda modelo_Exxx.html con tus fórmulas y tus datos dentro. Pon los 2 archivos en tu carpeta Exxx/.

3d. Explica 1 ciclo en palabras con 1 número. Escríbelo en insights_Exxx.txt, sección "Mi ciclo". Usa la frase fija: "Cuando X sube, Y sube, y eso hace que X suba más: ciclo R." "Cuando X sube, Y baja, y eso frena a X: ciclo B." Ejemplo: "Cuando Infectados sube, infeccion sube, y eso hace que Infectados suba más: ciclo R1. El pico fue de 48,200 personas el día 112."

Qué significa terminado: cero ? en la página, el nodo nuevo existe y no queda PROVISIONAL. Los chequeos dicen PASA. salidas_Exxx.csv y modelo_Exxx.html están en tu carpeta. El ciclo está escrito.

Se califica: 3a el HTML corre con fórmulas y nodo nuevo, y está descargado. 3b los chequeos pasan. 3d un ciclo explicado con número.

Ya es suficiente: deja de ajustar parámetros para que la curva se parezca al dato. Eso no mejora tu nota. A las 08:15 exporta y descarga, con lo que tengas. Después vienen el Paso 4 y el Paso 5.

Si te atascas El navegador no abre el HTML: usa otro navegador. Chrome, Edge y Safari sirven. Cargar datos no funciona: revisa que elegiste mi_territorio_Exxx.csv (o datos_Exxx.csv) de tu carpeta, no otro archivo. Un chequeo dice FALLA: anótalo como "no" y sigue. 3a cuenta aunque 3b falle. No logras agregar el nodo: deja la constante PROVISIONAL. Exporta y descarga igual. Pierdes solo la línea del nodo nuevo, nada más.


Paso 4. Dashboard conectado a tu base: 5 variables, estadísticas, histogramas, lecturas (Bloque 4)

Qué haces

Abre dashboard_Exxx.html en el navegador. El script lo creó en el Paso 1. Ya trae los datos de tu base de datos. Si no corriste el script, abre dashboard_plantilla.html de tu carpeta. Pulsa Leer CSV y carga mi_territorio_Exxx.csv (o datos_Exxx.csv).

4a. Mira que el dashboard muestre tu tabla ancha de tu territorio. Si quieres, pulsa Leer CSV y carga también salidas_Exxx.csv. Así sumas variables simuladas del modelo.

Elige al menos 5 variables. Al menos 1 debe ser real, de tu territorio (mi_territorio_Exxx.csv). Ejemplo: casos_7d (real), fallecidos_7d (real), rezago_rep_prom (real), Infectados (simulada), fraccion_susceptible (simulada). Para cada variable, el dashboard calcula: media, mediana, moda, desviación estándar y coeficiente de variación (CV). También dibuja su histograma. Mira los 5 números y el histograma de cada variable.

4b. Mira cada histograma. Dice dónde se juntan los días y si hay una cola larga. Ejemplo: "casi todos los días están abajo, a la izquierda, y pocos días muy altos hacen una cola a la derecha."

4c. Escribe 1 lectura DATO y 1 lectura JUICIO por variable, en las casillas del dashboard. Ejemplo DATO: "La mediana de casos_7d es 529 casos por día." Ejemplo JUICIO: "La media está muy por encima de la mediana, así que hubo picos cortos y altos."

Guarda el dashboard: botón Descargar este HTML, o Guardar como, página completa. Nombre: dashboard_Exxx.html. No cambies el diseño ni los colores. Ya pasó la prueba de accesibilidad.

Qué significa terminado: dashboard_Exxx.html abre con 5 variables, sus 5 estadísticas, sus histogramas y sus lecturas.

Se califica: 4a estadísticas de 5 variables. 4b histogramas. 4c lecturas DATO/JUICIO.

Ya es suficiente: deja de buscar una sexta variable. Cinco bastan.

Si te atascas El dashboard no lee el CSV: revisa que sea mi_territorio_Exxx.csv (o datos_Exxx.csv) de tu carpeta y prueba otro navegador. El dashboard sale sin datos: abre dashboard_plantilla.html y carga el CSV con Leer CSV. Una variable sale con CV "no aplica": tiene valores negativos o media cero. Elige otra.


Paso 5. Entiende tu tablero: hechos, insights y conclusiones (Bloque 5)

Qué haces

5a. Escribe 3 hechos en el dashboard y en insights_Exxx.txt. Un hecho es información: un número que los datos muestran. Ejemplo: "El pico real de casos_7d fue 6,137 casos por día, el día 674."

5b. Escribe 2 insights: un insight de ciclo y un insight de variable. Cada uno tiene 1 número con unidad.

Insight De dónde sale Frase fija Ejemplo
1 Un ciclo (R o B) "Cuando X sube, Y ... : ciclo R/B" "Cuando Hospitalizados sube, ocupacion sube, letalidad sube y Hospitalizados baja: ciclo B1. La ocupación pasó de 1.0 durante 41 días."
2 Una variable Una lectura con número "El rezago de reporte tuvo desviación estándar de 3.2 días. Los datos de hoy son de hace 4 a 10 días."

Debajo de cada insight escribe su conclusión. Tiene 3 partes: 1. La problemática o situación que encontraste. 2. Qué hacer para mejorar el sistema. 3. El empleado IA que lo haría posible (nombre y arquetipo).

Ejemplo: "Problemática: la ocupación de camas llegó a 1.0 y nadie avisó antes." "Qué hacer para mejorar el sistema: abrir camas antes de que la ocupación llegue a 0.85." "Empleado IA: Vigía de camas, arquetipo Vigía, que avisa cuando ocupacion pasa de 0.85."

Puedes reusar el ciclo del Paso 3d como Insight 1. Pega los 2 insights y sus conclusiones en las tarjetas del dashboard y vuelve a descargarlo.

5c. Tarjeta de transferencia: escribe transferencia.txt con 5 frases, en tus palabras. Aplica el patrón de tu familia a un problema de comunicación que no sea COVID.

Frase Qué dice Ejemplo (patrón F7, dos relatos en competencia)
1 El problema "Un rumor sobre una marca de yogur en TikTok."
2 Los stocks "Indecisos, Informados, Desinformados."
3 Un ciclo "Cuando Desinformados sube, más videos del rumor, y eso hace que Desinformados suba más: ciclo R."
4 La fuente de datos "Conteo diario de videos con el hashtag, desde la API de TikTok."
5 Un empleado IA "Un Vigía que avisa cuando los videos del rumor pasan de 200 por día."

Qué significa terminado: 3 hechos y 2 insights con número y conclusión en insights_Exxx.txt y en el dashboard. 5 frases en transferencia.txt.

Se califica: 5a y 5b hechos e insights con número y conclusión (problemática, mejora y empleado IA). 5c tarjeta de transferencia.

Ya es suficiente: deja de buscar un tercer insight. Solo se califican 2.

Si te atascas No encuentras el número: usa la media, la mediana o el pico que muestra el dashboard. La transferencia no sale: mira la columna "Qué aprendes a enmarcar" de tu patrón en la ficha. Almuerzo a las 12:00. El Bloque 6 necesita cabeza fresca.


Paso 6. Dos empleados digitales (IA) y bitácora (Bloque 6)

Qué haces

Diseñas dos empleados digitales (IA), uno por problemática encontrada en tu análisis. Por cada uno entregas 3 cosas:

  1. Prompt con especificaciones, rieles (rails) y arnés (harness).
  2. Hoja de vida: tareas o funciones, habilidades, competencias y limitaciones.
  3. Marco de gobierno de IA: riesgos, políticas, procesos con diagrama de flujo y protocolo de contención.

Un empleado IA sugiere; una persona decide.

Elige el arquetipo de cada empleado:

Arquetipo Qué hace Ejemplo
Vigía Umbral → alerta "Avisa si ocupacion pasa de 0.85."
Redactor Números → nota pública "Escribe el parte diario de camas."
Verificador Calidad de datos "Revisa si el rezago llegó negativo."
Explicador Responde preguntas sobre el ciclo "Explica por qué la segunda ola fue más alta."

Abre ia/empleado_ia_plantilla.html en el navegador. A la izquierda hay un formulario. A la derecha se arma el documento. Pulsa Cargar ejemplo una vez para ver un empleado completo. Luego pulsa Vaciar todo y escribe el tuyo. Lee antes ia/superprompt_plantilla.md: 2 páginas sobre el prompt con rails y el harness.

El formulario tiene 10 secciones. Llénalas en orden:

Sección Qué escribes
0 Quién es Nombre, rol, arquetipo, insight de origen (tu problemática), ciclo o variable, qué mejora del sistema
1 Ficha de gobernanza Propósito, modelo (id exacto), proveedor, dónde corre, nivel de riesgo, dueño, despliegue, retiro, qué hace
2 Hoja de vida Habilidades con herramienta, competencias, limitaciones, supervisor, KPIs, día a día de lunes a viernes
3 Prompt con rails Identidad, misión con número y ciclo, entradas, pasos, salidas, rails G1 a G3, rechazos R0 R1 R2, entrega a humano, 2 ejemplos
4 Harness Disparador, formato de entrada, formato de salida, 3 pruebas, registro, interruptor, costo
5 Palabras usadas Las 5 palabras técnicas que usaste, con su definición corta
6 Riesgos 3 o más, cada uno con AIR 2024 L1 → L2 → L3, nivel ALTO/MEDIO/BAJO, qué puede salir mal, cómo lo evitamos
7 Políticas Una por riesgo: hacer, no hacer, recordar
8 Procesos 3 o más, con pasos y preguntas sí/no. La página dibuja el flujo
9 Protocolo de contención SEV-1, SEV-2, SEV-3 con tiempo, y los 7 pasos: Parar, Contener, Deshacer, Buscar, Avisar, Arreglar, Aprender

Las secciones 3 y 4 son la entrega 1 (prompt y arnés). La sección 2 es la entrega 2 (hoja de vida). Las secciones 6 a 9 son la entrega 3 (marco de gobierno).

Reglas que no cambian:

  1. El día a día tiene 5 días (lunes a viernes). Cada día: disparador, entrada, acción, salida, quién revisa.
  2. Incluye 1 día de espera (sin disparo) y 1 día de incidente (dato malo, pasa a un humano).
  3. Un rail G nace de tu ciclo. Ejemplo: "G3 (ciclo B1): nunca recomiendo trasladar pacientes; solo aviso."
  4. R0 y R1 son fijos: no da consejo médico individual; nunca publica una celda con n menor que 5.
  5. R2 nace de tu ciclo. Ejemplo: "No proyecto más de 14 días: el ciclo B1 cambia la letalidad."
  6. El número de la misión sale de tu dashboard. Ejemplo: "umbral 0.85 = media 0.62 + 1 desviación 0.23."

Al terminar cada empleado pulsa Descargar este HTML. Nombres: empleado_ia1_Exxx.html y empleado_ia2_Exxx.html. Los dos empleados IA se califican con los mismos criterios.

Bitácora de IA. Escribe bitacora_ia.txt (o .md) con cualquier editor. Máximo 5 entradas. Cada entrada tiene 5 campos: prompt resumido, qué se equivocó el modelo, qué cambié, qué entregable afectó, modelo usado. Ejemplo: "Pedí la fórmula de altas. Olvidó (1 - letalidad). La agregué. Afectó modelo_Exxx.html. Modelo: gemini-2.5-flash."

Qué significa terminado: los 2 HTML descargados abren y muestran las 10 secciones llenas. La bitácora tiene 1 a 5 entradas.

Se califica: prompt con rails y harness, hoja de vida, riesgos AIR, políticas, procesos con flujo y contención. Lo que debe estar sí o sí: el empleado IA 1 con prompt con rails y harness, hoja de vida y riesgos. Bitácora: compuerta. Si falta, la nota del Pilar 3 baja 10 %.

Ya es suficiente: a las 15:30 deja de pulir el segundo empleado.

Si te atascas No sabes qué riesgo elegir: la tarjeta AIR 2024 trae 1 fila ya resuelta. Copia su forma. El flujo del proceso no se dibuja: cada paso necesita texto. Las preguntas necesitan la salida "no". Te quedas sin tiempo: termina el empleado IA 1 completo. Eso debe estar sí o sí.


Paso 7. Revisar, comprimir y enviar (Bloque 7)

Qué haces

  1. Abre tu carpeta Exxx/. Revisa la lista de nombres fijos de la sección Entrega. Marca cada archivo.
  2. Arregla solo lo que falte y sea rápido. Ejemplo: un archivo con nombre mal escrito.
  3. Revisa que ningún archivo tenga una llave de API. Ejemplo de llave: empieza con sk-ant o con AIza.
  4. Comprime la carpeta. Windows: clic derecho, Enviar a, Carpeta comprimida. Mac: clic derecho, Comprimir.
  5. Cambia el nombre del zip a EXAMEN FINAL - Exxx - NOMBRE COMPLETO.zip.
  6. Envíalo por correo a la dirección del enunciado. Verifica que el correo salió antes de las 18:50.

Qué significa terminado: el zip está enviado y lo ves en tu bandeja de enviados.

Ya es suficiente: a las 18:30 envía lo que tengas. Un zip incompleto a tiempo vale más que uno completo tarde.

Si te atascas El zip pesa más de 25 MB: saca del zip covid_diario.csv, examen_Exxx.duckdb, mi_territorio_Exxx.csv y datos_Exxx.csv. El profesor ya los tiene; tu evidencia es sql_Exxx.txt. El correo no sale: escribe al profesor en el horario de 17:30 a 18:30 con una captura de pantalla.


Mapa de la nota

La nota tiene tres pilares. Cada pilar vale un tercio. La nota final es el promedio de los tres pilares.

Pilar 1. Modelo (un tercio)

Ítem
Dibujo a mano completo y correcto, con signos, foto y 5 frases
El HTML corre: fórmulas, nodo nuevo, datos, descargado
Chequeos de aceptación pasan
Un ciclo explicado con un número

Pilar 2. Datos (un tercio)

Ítem
Ingesta a DuckDB local con evidencia (sql_Exxx.txt)
Estadísticas de 5 variables: media, mediana, moda, desviación, CV
Histogramas de las 5 variables
Lecturas DATO/JUICIO
3 hechos y 2 insights con número y conclusión (problemática, mejora y empleado IA)
Tarjeta de transferencia

Pilar 3. Empleados IA (un tercio)

Ítem
Empleado IA 1: prompt con rails y harness, hoja de vida, riesgos AIR 2024, políticas, procesos con flujo y contención
Empleado IA 2: los mismos seis elementos

Dentro de cada pilar, cada ítem es sí o no. Algunos ítems pesan más que otros, y eso lo usa el calificador.

Compuertas: sin bitácora de IA, la nota del Pilar 3 baja 10 %. Una llave de API en el zip baja 10 % el Pilar 3. Puerta de la foto: sin modelo_mano_Exxx.jpg no se califica el Pilar 2 (datos).


Entrega

  1. Crea una carpeta con tu código. Ejemplo: E042.
  2. Pon dentro los archivos con nombre fijo de las tablas de abajo.
  3. Clic derecho sobre la carpeta. Windows: Enviar a, Carpeta comprimida. Mac: Comprimir.
  4. Nombra el zip EXAMEN FINAL - Exxx - NOMBRE COMPLETO.zip. Ejemplo: EXAMEN FINAL - E042 - NOMBRE COMPLETO.zip.
  5. Envíalo por correo a la dirección del enunciado.

Entrega única: sábado 14 de noviembre, 7:00 pm. Se califica lo que llegue antes de esa hora, aunque esté incompleto. Cada archivo presente cuenta en tu nota.

Nombres fijos de archivo (Pilar 1)

Archivo Qué contiene
modelo_mano_Exxx.jpg (o .png o .pdf) Foto de tu dibujo a mano con signos, ciclos y las 5 frases. Puerta del Pilar 2
modelo_Exxx.html Tu modelo completo, descargado de la página con el botón
salidas_Exxx.csv Corrida del modelo en formato largo: t, variable, valor, origen

Nombres fijos de archivo (Pilar 2)

Archivo Qué contiene
sql_Exxx.txt Evidencia de tu ingesta a DuckDB local: 2 conteos, vista, 3 números, fecha y hora. El script lo escribe solo. Puede faltar: pierdes solo el paso de ingesta (Paso 1)
dashboard_Exxx.html Tu dashboard con 5 variables, estadísticas, histogramas, lecturas, hechos e insights con su conclusión
insights_Exxx.txt (o .md) Pistas usadas, simulación, mi ciclo, 3 hechos, 2 insights con su conclusión, las 5 frases si no están en la foto
transferencia.txt (o .md) 5 frases

Nombres fijos de archivo (Pilar 3 y compuertas)

Archivo Qué contiene
empleado_ia1_Exxx.html Empleado IA 1, descargado de la plantilla
empleado_ia2_Exxx.html Empleado IA 2, descargado de la plantilla
bitacora_ia.txt (o .md) Máximo 5 entradas

Reglas de IA

Puedes usar Claude, Gemini u otro modelo durante todo el examen. El curso enseña a trabajar con ellos.

Qué sí

  1. Pedir que te explique un concepto. Ejemplo: "¿Qué es un ciclo de balance?"
  2. Pedir que corrija un error de SQL. Ejemplo: "Esta consulta da error en DuckDB, ¿por qué?"
  3. Pedir que revise tu redacción.
  4. Probar tu prompt con rails con 3 filas reales de mi_territorio_Exxx.csv.
  5. Anotar cada uso útil en la bitácora.

Qué no

  1. Pegar una llave de API en ningún archivo. Una llave en el zip baja 10 % la nota del Pilar 3.
  2. Entregar texto que no puedes explicar en voz alta.
  3. Copiar archivos de otra persona. Tu vista, tu nodo, tu ciclo y tu número hacen único tu trabajo.
  4. Pedir al modelo que lea gt2j-8ykr fila a fila. Solo se usa la vista agregada.
  5. Publicar una celda con menos de 5 personas.

Bitácora de IA: máximo 5 entradas, 5 campos cada una. Si falta, la nota del Pilar 3 baja 10 %. Secretos: una llave de API en el zip baja 10 % la nota del Pilar 3.


Glosario

Término Qué es, en una línea
Nodo Una pieza del modelo: stock (caja), flujo (válvula) o convertidor (círculo).
Arco Una flecha entre dos nodos. Lleva signo: + misma dirección, - dirección contraria.
Stock Una cantidad que se acumula. Ejemplo: Infectados, en personas.
Flujo Lo que entra o sale de un stock por día. Ejemplo: infeccion, en personas/día.
Convertidor Un cálculo auxiliar o un parámetro. Ejemplo: fraccion_susceptible.
Casilla ? Un nodo de la página HTML sin fórmula. Tú la escribes.
Ciclo R Refuerzo: X sube, Y sube, X sube más. Número par de signos -.
Ciclo B Balance: X sube, Y baja, X se frena. Número impar de signos -.
Término Qué es, en una línea
DuckDB Base de datos que corre en tu computador (como en clase) y recibe SQL. El script ingesta_Exxx.py la crea por ti.
Vista Una consulta SQL guardada con nombre. Ejemplo: v_territorio_76, 731 filas.
Media La suma de los valores dividida entre cuántos son.
Mediana El valor del medio cuando ordenas los datos.
Moda El valor que más se repite. En series diarias suele ser 0 o un valor redondeado.
Desviación estándar Cuánto se alejan los valores de la media, en las mismas unidades.
Coeficiente de variación Desviación estándar dividida entre la media. Sin unidades. Sirve para comparar.
Histograma Un gráfico de barras que dice cuántos días cayeron en cada rango de valores.
Término Qué es, en una línea
Hecho Información: un número que los datos muestran y cualquiera puede repetir.
Insight Un hecho unido a una estructura del modelo, con un número y una conclusión.
Problemática Una situación del sistema que tus datos muestran y que conviene mejorar. Cada empleado IA nace de una.
Prompt con rails Las instrucciones del empleado IA más sus reglas fijas (rails G) y sus rechazos (R).
Rail Una regla que el empleado IA sigue siempre. Ejemplo: "solo uso datos de la vista".
Harness Cómo se opera el empleado: disparador, formatos, pruebas, registro, interruptor, costo.
Protocolo de contención Qué hacer cuando el empleado falla: SEV-1/2/3 y los 7 pasos, de Parar a Aprender.
Gobernanza Las reglas para que un empleado IA exista con responsabilidad: riesgos, políticas, procesos, apagado.