IA Cultivada|INEMA.CLUB-PRO

Clase 6 · 17 min

Cerrar el ciclo: registro de fallos y observabilidad

Lo que no se observa no se cultiva. Esta clase acompaña a un agente de atención de una clínica desde el primer error hasta la autonomía supervisada, y muestra lo mínimo que necesitas registrar para cambiar "creo que mejoró" por "mejoró de 88% a 95%".

Comenzar la clase
Una recepcionista de clínica revisa la agenda de consultas en la pantalla de al lado de un cuaderno abierto.

En esta clase vas a

  1. 1Cómo un error se convierte en regla permanente
  2. 2Comparar versiones del agente con números
  3. 3Observabilidad mínima: tres campos
  4. 4Encontrar el patrón de error que vale la pena corregir primero

Objetivo: registrar cada ejecución con el mínimo de campos y convertir un error real en una regla nueva, comparando el resultado antes y después.

01El caso de la clínica, en seis etapas

Desplázate para seguirlo. Los números son del caso descrito en el proyecto.

Desplázate por la página: cada paso de abajo ilumina su parte del diagrama.

  1. 1/7

    Ambiente inicial

    Médicos y especialidades, horarios de cada uno, procedimientos y duración, reglas de la clínica y acceso a la agenda. El agente solo sugiere; la recepcionista aprueba cada cita.

  2. 2/7

    Primer fallo

    El agente agenda a las 19:30 con un médico que no atiende después de las 18:00. La agenda mostraba "libre", pero agenda libre no es médico disponible. El fallo se registra con fecha, decisión, resultado y causa raíz.

  3. 3/7

    Regla nueva

    "Antes de sugerir, consultar la agenda Y el horario de atención del médico. Fuera del horario, nunca, aunque la agenda muestre libre." Vale desde la próxima ejecución en adelante.

  4. 4/7

    Evaluación

    De las 20 interacciones siguientes, 18 correctas. Los 2 fallos se convierten en dos reglas más: la duración del procedimiento debe caber en el horario, y 15 minutos de intervalo entre consultas.

  5. 5/7

    Estabilización

    40 interacciones en dos semanas: 20/20 en cada una, cero correcciones de la recepcionista, tiempo de respuesta de 4 minutos a 45 segundos.

  6. 6/7

    Autonomía

    Con el historial, el agente pasa a confirmar solo. El humano recibe un informe diario y revisa solo lo que el agente marcó como excepción: horario límite, paciente nuevo, procedimiento largo.

  7. 7/7

    Después de 2 meses

    Reglas: de 5 genéricas a 14 nacidas de fallos reales. 320 ejecuciones registradas, 7 fallos documentados, 97,8% de acierto, versión v1.0 → v1.4. El modelo es el mismo del primer día; si la clínica cambia de modelo, el jardín continúa.

02La diferencia entre dos versiones

Lo que muestra la observabilidad (ejemplo del proyecto, 100 ejecuciones en cada versión).

1. v1.0 · 88%

Tres patrones de error: fuera del horario del profesional (5), horario corto para el procedimiento (4) y respuesta ambigua sobre cancelación (3).

Cada patrón generó una regla nueva: cuatro reglas modificadas.

03Registro de ejecuciones

Empieza con los tres campos. La versión completa llega cuando el volumen lo pida.

EXECUCOES.md · mínimo viable
| fecha | lo que se pidió | lo que se entregó | ¿salió bien? (sí / no / parcial) |
|---|---|---|---|
|  |  |  |  |
EXECUCOES.md · completo
| fecha | versión del agente | objetivo | decisión tomada | herramienta usada | tiempo | costo | resultado | error | intervención humana | evaluación (correcta / parcial / errónea) | corrección aplicada |
|---|---|---|---|---|---|---|---|---|---|---|---|
|  |  |  |  |  |  |  |  |  |  |  |  |
De la falla a la regla (modelo de registro)
## Falla <fecha>
Lo que pasó: 
Decisión que tomó el agente: 
Causa raíz (¿faltó contexto, regla, ejemplo o herramienta?): 
Corrección mínima posible: 
Regla nueva (texto exacto que entró en el archivo): 
Versión del agente: v1.0 → v1.1
Cómo sabré si se resolvió: próximas 20 ejecuciones, contar aciertos

04Práctica

Una semana de observación.

1 · Una semana de registro

5 min por día

Para la función que elegiste, registra cada ejecución en EXECUCOES.md con los tres campos mínimos.

Listo cuando: el archivo tiene al menos 10 líneas y puedes decir la tasa de acierto de la semana (ej.: 8 de 10).

2 · Una regla nacida de un error

20 min

Toma la falla que más se repitió en la semana y completa el modelo "de la falla a la regla". Pon la regla en el archivo y sube la versión.

Listo cuando: la regla está escrita en el archivo del agente, la versión subió (v1.0 → v1.1) y las próximas ejecuciones se están contando para comparar.

05Prueba rápida

4 preguntas.

Pregunta 1 de 4

La agenda mostraba el horario como libre y el agente agendó fuera del horario de atención del médico. ¿Cuál fue la causa raíz?

06Resumen

El error se vuelve reglaRegistro con causa raíz, la corrección más pequeña, regla en el archivo, versión nueva.
Compara versionesMismos escenarios, antes y después: 88% → 95% sin cambiar el modelo.
Empieza con tres camposPedido, entrega, salió bien. Con eso ya cierras el primer ciclo.

Para ir más allá

Caso completo: agente de atención de una clínicaObservabilidad del cultivoPaquete: triaje de atención
Clase anteriorSiguiente clase