Blog del CAIOTodos los artículos

Calidad del dato primero, vibe después

Un mapa puede ocultar establecimientos vigentes. Una auditoría de 5.837 registros del DEIS muestra dónde ocurre y cómo conservar esas fichas en el buscador.

Sebastián Vargas Yáñez · Blog del CAIO · 13 de noviembre de 2026

Mapa de establecimientos de salud con filtros para Coquimbo durante la demostración de Sebastián Vargas
Prototipo del mapa de establecimientos de salud · Taller IA-LATAM, 45:45

Resumen

Pregunta. ¿Cuántos establecimientos vigentes quedarían fuera de un directorio que solo muestra fichas con coordenadas?

Método. Audité los 5.837 registros del corte oficial del DEIS del 10 de noviembre de 2026. Un segundo script recalculó las cifras desde el CSV original.

Resultado. 79 de 5.406 establecimientos vigentes carecían de coordenadas. En Coquimbo faltaban 32 de 638, un 5,02 % frente al 1,46 % nacional.

Decisión. Mantener todas las fichas vigentes en el buscador y mostrar en el mapa las que tienen coordenadas utilizables. Los porcentajes describen la disponibilidad de coordenadas en ese corte.

Del taller a la pregunta de investigación

En el II Congreso Académico IA-LATAM construí un buscador de establecimientos de salud con OpenCode y subagentes. El trabajo empezó por el diccionario del Ministerio de Salud y el diagnóstico del CSV. El mapa vino después. En el video, la instrucción de leer el diccionario y auditar la fuente aparece en 19:07–20:08 y la revisión de QA, en 28:38–29:42 (Vargas, 2026). Ver el taller desde 0:38

La auditoría encontró 82 grupos de nombres repetidos y cero colisiones de clave en el corte oficial (Ministerio de Salud de Chile, 2026b). Para el buscador, eso significa conservar las fichas que comparten nombre y permitir que el lector las distinga por código y comuna.

Método de la auditoría

El análisis es descriptivo y usa un solo corte. La unidad de análisis es el registro de establecimiento en el CSV. Se procesaron todas las filas de datos, incluidas las cerradas, para medir la estructura del archivo. El denominador de cobertura del directorio se restringió a los establecimientos cuyo estado de origen se normalizó como vigente. La fuente y el diccionario se identifican en las referencias (Ministerio de Salud de Chile, 2026a, 2026b).

  1. Fijar la fuente. Identificar el CSV por fecha y SHA-256. Leerlo como UTF-8 con separador punto y coma. Una cabecera incompatible o una fila con una cantidad incorrecta de campos detiene la auditoría.
  2. Aplicar el contrato. Normalizar Unicode y espacios, conservar los códigos como texto y comprobar nombre, formato de los identificadores, unicidad de la clave y estado. Cualquier fila en cuarentena bloquea el JSON candidato. En este corte pasaron las 5.837 filas.
  3. Medir la cobertura. Contar fichas vigentes con un par decimal finito, dentro de los rangos angulares y distinto de (0, 0). Una ficha sin ese par sigue disponible en el listado. Calcular la cobertura nacional y por región, e informar por separado el número de fichas excluidas de la vista de mapa.
  4. Recalcular las cifras. Ejecutar un segundo script sobre el CSV original. El verificador compara el informe con recuentos obtenidos directamente de las columnas y revisa todas las regiones, incluida Coquimbo. La sección de código incluye ambos comandos.

El diccionario también se audita

El PDF del DEIS denomina EstablecimientoCodigoVigente al identificador oficial y lo describe como numérico, único y de seis caracteres (Ministerio de Salud de Chile, 2026a, p. 1). El encabezado del CSV auditado usa EstablecimientoCodigo (Ministerio de Salud de Chile, 2026b). Documenté la correspondencia en el contrato de ingesta y conservé el código como cadena de seis dígitos. Un identificador sirve para unir registros y preservar su representación.

La Tabla 1 especifica qué valida el script y qué exige una comprobación adicional. La Figura 1 sitúa esos controles en el flujo completo. La Figura 2 muestra el diccionario consultado en el taller.

En el diccionario, los encabezados identifican latitud y longitud, pero las definiciones textuales parecen intercambiadas (Ministerio de Salud de Chile, 2026a, p. 3). El script aplica una regla explícita para producir pares en orden longitud–latitud, como requiere GeoJSON (Butler et al., 2016, sección 3.1.1). Para publicar un mapa hace falta, además, confirmar el sistema de referencia de origen y validar espacialmente la ubicación. Un par dentro del rango angular puede seguir apuntando a la comuna equivocada.

Tabla 1Contrato de datos para un directorio de establecimientos
Campo de salida Campo en el CSV Tipo y formato Condición de aceptación Tratamiento de la excepción
id EstablecimientoCodigo Cadena ASCII, 6 dígitos Obligatorio y único dentro del corte Aislar todas las filas con la misma clave y bloquear el candidato.
nombre EstablecimientoGlosa Texto Unicode NFC, hasta 250 caracteres Obligatorio. Conservar grafía y acentos visibles Aislar nombres ausentes o fuera de longitud. Reportar homónimos para revisión.
region, comuna RegionCodigo, ComunaCodigo Cadenas de 2 y 5 dígitos Obligatorias. Para publicación, validar contra el catálogo territorial aplicable El script comprueba formato. La correspondencia comuna–región requiere el catálogo maestro versionado.
estado EstadoFuncionamiento Enumeración con mapeo explícito Obligatorio. Variantes de mayúsculas equivalentes Un estado nuevo se revisa. La categoría general «Cerrado» se conserva sin inferir causa ni duración.
ubicacion Longitud, Latitud Par decimal o null Ambos valores presentes y dentro de rango para dibujar un marcador Conservar la ficha en el listado y mostrar «Ubicación no disponible».

Nota. Contrato de aplicación elaborado a partir del diccionario y del encabezado observado (Ministerio de Salud de Chile, 2026a, 2026b). El prototipo tolera la falta de coordenadas para el listado, aunque el diccionario las marque como requeridas. Se registra esa desviación y se mide por separado.

La ficha del conjunto de datos explica quién lo generó, cuándo y para qué usos resulta apropiado (Gebru et al., 2021). El contrato convierte los requisitos de calidad en reglas verificables, una aplicación del modelo de calidad de datos de ISO/IEC 25012 (International Organization for Standardization, 2008). Conservar ambos junto con el hash de origen hace posible revisar por qué un registro pasó de una fila a una ficha visible.

Figura 1De la fuente oficial al directorio y al mapa
Flujo desde el CSV y el diccionario hasta el contrato, la auditoría, la revisión humana y la interfaz. Las filas que incumplen reglas críticas quedan en cuarentena.

Nota. Elaboración propia. La flecha discontinua indica el flujo cuando hay filas en cuarentena. El proceso escribe el informe y bloquea el JSON candidato. El archivo de origen se conserva para volver a ejecutar la auditoría.

Figura 2Consulta del diccionario de datos durante el taller
El diccionario oficial del DEIS abierto en pantalla durante la demostración

Nota. Captura de la demostración de Vargas (2026, 11:58).

Resultados de la auditoría

La completitud bruta de este corte es 84,78 %. El numerador cuenta celdas no vacías después de quitar espacios. El denominador incluye todas las celdas del CSV, incluidas las que pueden ser condicionales. Una fecha de cierre vacía en un establecimiento vigente y una clave primaria vacía tienen el mismo peso en ese promedio. Sus consecuencias son completamente distintas.

Para decidir sobre el mapa calculé la cobertura de coordenadas. Es el número de establecimientos vigentes con un par de coordenadas aceptado dividido por el total de establecimientos vigentes. El resultado nacional fue 98,54 %. En Coquimbo fue 94,98 %. Una vista que muestra solo marcadores dejaría fuera a 32 de los 638 establecimientos vigentes de esa región, cerca de cuatro de cada diez fichas vigentes sin ubicación en todo el corte.

El denominador cambia la decisión. De las 426 fichas sin coordenadas, 347 estaban cerradas y 79 vigentes. Usar las 426 como medida del impacto sobre el directorio de vigentes mezclaría registros con usos distintos. En la interfaz conservaría la ficha y señalaría la ausencia de ubicación.

La Tabla 2 muestra el denominador de cada indicador y la decisión de diseño que informa.

Tabla 2Métricas reproducidas en el corte del 10 de noviembre de 2026
Indicador Unidad y criterio Recuento o n/N Porcentaje Decisión de ingeniería
Completitud bruta Celdas con contenido sobre el total de celdas 163.295 / 192.621 84,78 % Evaluar obligatoriedad por atributo y condición.
Colisiones de clave Grupos con más de una fila por código oficial 0 grupos — Bloquear el candidato ante una colisión.
Coincidencias de nombre Grupos por nombre normalizado 82 grupos — Conservar las fichas con códigos distintos.
Coordenadas ausentes Filas sin latitud ni longitud entre todos los registros 426 / 5.837 7,30 % Conservar las fichas en el listado según su estado.
Cobertura de vigentes Pares aceptados entre vigentes a nivel nacional 5.327 / 5.406 98,54 % Mostrar la fecha de corte y la cobertura por región.
Cobertura de vigentes en Coquimbo Pares aceptados entre vigentes de la región 04 606 / 638 94,98 % Mostrar las fichas que el mapa no puede ubicar.

Nota. Cálculos propios sobre el archivo oficial (Ministerio de Salud de Chile, 2026b). n/N indica casos que cumplen el criterio sobre el total evaluado. El guion indica que se informa un recuento de grupos. Para comparar nombres se normalizó Unicode a NFC y los espacios, y se ignoraron diferencias de mayúsculas. «Vigente» se refiere al estado en el corte. La cobertura mide presencia y rango de coordenadas. La precisión física, la vigencia actual, la integridad referencial y la disponibilidad operativa requieren comprobaciones adicionales.

Qué se puede concluir

Los recuentos describen este archivo. La pérdida de 79 fichas es el resultado de aplicar una regla hipotética de visualización a esos registros. El estudio no observó a usuarios ni midió mejoras en la búsqueda. Tampoco estimó el efecto de trabajar con agentes frente a otro método. El dato permite decidir cómo tratar los registros sin coordenadas y qué volver a medir cuando se publique otro corte.

En el taller se verbalizaron un 87 % global, un 94,5 % y 17 grupos de nombres en el diagnóstico mostrado (Vargas, 2026, 29:11–29:39). El video permite localizar esas cifras, pero la evidencia disponible no permite reconstruir su denominador ni vincularlas por hash con el CSV de este artículo. Las métricas de la Tabla 2 corresponden al archivo identificado por el informe descargable.

Sambasivan et al. (2021) describen las cascadas de datos como problemas que se acumulan aguas abajo cuando las decisiones sobre la fuente quedan sin atender. En este caso, la cascada se puede seguir en tres pasos. Un campo ausente se convierte en un marcador omitido. Una búsqueda que filtra sobre los marcadores convierte esa omisión en una ficha perdida. El usuario concluye que el establecimiento no existe.

Qué delegar a los agentes y qué exigirles como evidencia

La independencia de QA depende de su método, sus permisos y las entradas que recibe. Para la auditoría de este artículo se recalcularon las cifras con un segundo script que lee el CSV original sin importar el programa que produce el JSON. La Figura 3 propone cómo llevar esa comprobación a un equipo con agentes y la Tabla 3 detalla la evidencia que entrega cada rol. La Figura 4 muestra la revisión en OpenCode durante el taller. El enfoque recoge funciones de gobierno, medición y gestión de riesgo del AI RMF (Tabassi, 2023).

Figura 3Separación de responsabilidades en el flujo multiagente
El líder entrega alcance y contrato a Datos, QA y Seguridad. Las tres evidencias llegan al responsable humano. Tras su aprobación, la interfaz consume el JSON aprobado.

Nota. Elaboración propia. QA corresponde a aseguramiento de la calidad. Las flechas muestran la entrega del encargo y de las evidencias de revisión.

Figura 4Revisión de calidad en OpenCode durante el taller
OpenCode muestra los hallazgos de calidad y el resultado de la verificación del taller

Nota. Captura del diagnóstico presentado por Vargas (2026, 29:13). Las cifras del artículo proceden del corte auditado y documentado en la Tabla 2.

Tabla 3Responsabilidades, evidencia y límites de cada rol
Rol Acceso y tarea Evidencia para revisión Condición para avanzar
Líder técnico Define el uso, fija la versión y coordina las revisiones Propósito, versión de contrato y decisiones abiertas Cada regla tiene dueño y caso de prueba.
Datos Lee fuente y diccionario. Escribe en un directorio de trabajo Mapeo de campos, script, hash, informe y candidato El mismo corte y script reproducen el resultado.
QA Lee el original y el candidato en un entorno aislado Recuento independiente, casos límite y discrepancias por línea Una colisión de clave, un cambio de contrato o una discrepancia queda visible.
Seguridad Revisa fuente, código, permisos y campos destinados al navegador Hallazgos sobre inyección, datos expuestos y acceso a herramientas Se cierran hallazgos que comprometen el uso previsto.
Responsable de datos Revisa excepciones y autoriza una versión específica Fecha de corte, hash, límites de uso y decisión Se aprueba el artefacto concreto que consumirá el frontend.
Frontend Consume el contrato aprobado Pruebas de filtros, estados vacíos, texto escapado y navegación Las fichas sin coordenadas siguen disponibles en el listado.

Nota. Los roles describen el flujo propuesto. La decisión de publicar corresponde al responsable humano de los datos.

Guía de construcción con agentes

Construye un directorio informativo que muestre los establecimientos vigentes del corte y conserve en el listado las fichas sin coordenadas. Los pasos y prompts siguientes proponen una implementación reproducible del caso. Las cifras de la Tabla 2 provienen del CSV auditado. Descargar la guía con los ocho prompts

Pasos de principio a fin

  1. Define el alcance. La primera versión muestra código, nombre, región, comuna y estado del corte. El mapa añade marcadores a las fichas con pares utilizables. Escribe estos criterios en el README. Usa el prompt Coordinación para dividir el trabajo.
  2. Prepara el proyecto. Comprueba las versiones de Python y Node. Usa Python 3.10 o superior para los scripts y una versión de Node admitida por Astro. Para un proyecto nuevo, ejecuta npm create astro@latest desde el directorio padre y elige un proyecto mínimo. Entra en el directorio generado y, si el asistente no instaló las dependencias, ejecuta npm install. En un proyecto existente, usa su gestor de paquetes y su archivo de bloqueo. Instalación de Astro
  3. Fija las fuentes. Guarda el CSV y el diccionario oficial en data/raw/, fuera de public/. Registra URL, fecha de corte y SHA-256 en docs/fuentes.md. Conserva los bytes del CSV. CSV del corte · Diccionario DEIS
  4. Define el contrato. Con el prompt Contrato e ingesta, compara los encabezados reales con la Tabla 1 y registra los alias. Define qué bloquea el conjunto completo y qué conserva una ficha con ubicacion: null.
  5. Genera el candidato. Guarda auditar.py y verificar.py en la raíz. Ejecuta los dos comandos de abajo desde esa carpeta. Usa un directorio de salida nuevo para cada ejecución. El candidato queda en build/auditoria/establecimientos.json. Script de auditoría · Script de verificación
  6. Revisa el dato. Usa QA de datos para recalcular los indicadores desde la fuente y probar las excepciones con filas sintéticas. Para el SHA-256 de este artículo, comprueba 5.837 registros, 82 grupos por nombre, cero colisiones de clave y 79 vigentes sin ubicación, 32 en Coquimbo. Con un corte diferente, conserva su propia huella y vuelve a calcular sus cifras.
  7. Revisa lo que se expondrá. Usa Seguridad y privacidad antes de pasar el JSON al navegador. Tras resolver los hallazgos que bloqueen la salida, copia el candidato aprobado a src/data/establecimientos.json. Incluye la fecha de corte en la interfaz.
  8. Construye el listado y el mapa. Ejecuta primero Listado y filtros. Si el proyecto usa npm y aún no tiene Leaflet, instálalo con npm install leaflet. Usa Mapa e integración para conectar los marcadores al mismo conjunto filtrado. La vista inicial muestra el estado vigente. Un cambio de filtro actualiza ambas vistas y conserva en el listado las fichas sin coordenadas.
  9. Prueba la aplicación. Usa QA de aplicación con npm run dev y vuelve a probar la compilación con npm run build y npm run preview. Comprueba una búsqueda sin resultados, homónimos, una ficha sin coordenadas y la vista móvil. Simula que falla la capa del mapa y verifica que el listado sigue disponible.
  10. Publica y prepara la siguiente actualización. Usa Publicación y mantenimiento para comprobar el directorio de salida de Astro, verificar el entorno de vista previa y registrar la versión anterior. Si el despliegue forma parte del encargo, comprueba la URL pública y ejecuta una búsqueda real. Para otro corte, repite la ingesta y las pruebas antes de sustituir el JSON.
python auditar.py data/raw/establecimientos_20261110.csv build/auditoria
python verificar.py data/raw/establecimientos_20261110.csv build/auditoria/auditoria.json

El script crea el directorio de salida, pero su carpeta padre debe existir. Crea build/ antes de ejecutar esos comandos. Si el auditor devuelve código 2, revisa el informe de cuarentena y corrige la regla o la fuente antes de generar otro candidato. Si el verificador rechaza la huella, comprueba que descargaste el corte del artículo.

Prompts listos para copiar

Empieza con Coordinación. Entrega los prompts siguientes como tareas al agente correspondiente o ejecútalos en orden en una sola sesión. En OpenCode, adapta la configuración a la versión instalada y limita el acceso a archivos, red y despliegue según el rol (OpenCode, s. f.). Una celda del CSV o un documento puede contener instrucciones que intenten cambiar la tarea del agente. Trátalos como datos del proyecto (OWASP, 2025).

Coordinación

Actúa como líder técnico. Construye un directorio estático del corte del DEIS con Astro, buscador y mapa sincronizados.
Entradas: repositorio, CSV oficial, diccionario, fecha de corte, scripts y contrato de la Tabla 1.
Primero inspecciona el proyecto y documenta rutas, versiones y comandos reales. Si el repositorio ya tiene arquitectura o pruebas, reutilízalas.
Asigna contrato e ingesta, QA de datos y seguridad. Pide a QA que recalcule desde el CSV antes de leer el informe del auditor. Integra el listado y el mapa después de aprobar el candidato.
Controla tres entregas: fuente y contrato trazables, candidato validado y compilación que supera las pruebas de aplicación. Para cada entrega registra archivos, comando, salida observada y problemas pendientes.
Aceptación: cada ficha vigente puede aparecer en el listado, las fichas sin coordenadas siguen disponibles y el mapa usa el mismo filtro que el listado.
Entrega: plan en el README, decisiones del contrato y reporte de ejecución. Indica cuáles comprobaciones se ejecutaron y cuáles quedan pendientes.

Contrato e ingesta

Actúa como especialista de datos. Usa data/raw/ como entrada de solo lectura y escribe el candidato fuera de public/.
Compara CSV y diccionario. Documenta campo oficial, encabezado observado, tipo, obligatoriedad, regla y página. Explica el alias EstablecimientoCodigoVigente → EstablecimientoCodigo. Conserva códigos de región, comuna y establecimiento como cadenas.
Ejecuta auditar.py en un directorio nuevo. Agrupa nombres normalizados para revisión y conserva fichas con códigos distintos. Una clave repetida debe aislar todas las filas implicadas.
Para ubicacion, acepta un par [longitud, latitud] finito y dentro de rango. Una coordenada parcial, un par inválido o (0, 0) produce null y un indicador en el informe. La comprobación de rango y la validación territorial se registran como controles distintos.
Entrega fuentes.md, contrato, SHA-256, auditoria.json y, cuando proceda, establecimientos.json. Explica los códigos de salida y lista las reglas pendientes con evidencia.
Aceptación: el origen conserva su huella, el JSON respeta la versión del contrato y una fila en cuarentena bloquea la generación del candidato.

QA de datos

Actúa como revisor de datos. Lee el CSV, el diccionario y las reglas. Recalcula desde las columnas originales y después coteja el informe de ingesta.
Ejecuta verificar.py sobre el corte exacto del artículo. Revisa filas, campos, vacíos, colisiones, coincidencias por nombre, vigentes y cobertura nacional y por región. Expresa cada tasa como n/N y porcentaje.
Prueba con datos sintéticos: dos filas con la misma clave, dos claves con el mismo nombre, encabezado incompatible, coordenada parcial, (0, 0) y estado no mapeado. Comprueba código de salida, presencia del informe y existencia o ausencia del candidato según cada regla.
Aceptación: el corte publicado reproduce 79 vigentes sin coordenadas, incluidos 32 de Coquimbo. Si otra versión del archivo arroja diferencias, adjunta su huella y evidencia para cada diferencia.
Entrega una matriz con caso, comando, resultado esperado, resultado observado, evidencia y estado. Registra como pendiente cada comprobación que carezca de insumos.

Seguridad y privacidad

Actúa como revisor de seguridad. Revisa el JSON público, la compilación, las dependencias y las herramientas de los agentes.
Comprueba que el JSON entrega solo id, nombre, region, comuna, estado y ubicacion. Busca archivos brutos, credenciales y datos de contacto fuera del contrato en la salida de compilación.
Con una ficha sintética que contenga etiquetas HTML e instrucciones falsas, comprueba que lista, filtros y marcadores tratan el valor como texto. Revisa especialmente el contenido de ventanas emergentes del mapa.
Inspecciona las peticiones al proveedor de mapas y los permisos de lectura, escritura, red y despliegue. Revisa el destino de los datos antes de enviarlos a un servicio externo.
Entrega hallazgos con archivo o URL, reproducción, impacto, corrección y resultado de la nueva prueba. Identifica qué hallazgos bloquean la publicación.

Listado y filtros

Implementa el listado en Astro con el JSON aprobado y comprueba version_contrato antes de consumirlo.
Muestra fecha del corte, código DEIS, nombre, región, comuna y estado. La vista inicial incluye los vigentes. Implementa búsqueda por nombre y código y filtros por región y comuna. Usa una sola función de filtrado para el contador, el listado y el mapa.
Mantén una ficha visible cuando ubicacion es null y muestra «Ubicación no disponible». Para nombres iguales, usa código y comuna como desambiguación. Incluye «Limpiar filtros» y un estado sin resultados.
Implementa controles etiquetados, navegación por teclado y un diseño que funcione en una columna. Usa texto escapado para los valores de origen.
Aceptación: una búsqueda por un código válido devuelve una ficha, dos homónimos conservan su identidad y los resultados coinciden con el filtro activo.
Entrega archivos modificados, comandos de prueba y evidencia para los casos anteriores.

Mapa e integración

Integra Leaflet en el navegador con la colección filtrada que alimenta el listado. Importa su hoja de estilos y da altura al contenedor. Conserva los códigos de establecimiento como claves para relacionar fichas y marcadores.
El JSON usa [longitud, latitud]. Si usas L.marker, pasa [latitud, longitud]. Si construyes GeoJSON, conserva [longitud, latitud]. Prueba la conversión con un punto sintético de valores distintos.
Dibuja marcadores solo para ubicaciones utilizables. Muestra el total de fichas y el total de marcadores para que se entienda la diferencia. Añade atribución según el proveedor de mapas.
Usa nodos de texto para las ventanas emergentes. Deja un mensaje de estado si falla la capa de mapa y conserva los controles del listado.
Aceptación: una ficha sin coordenadas se encuentra por código y no genera marcador. Cambiar región o comuna actualiza ambos totales. El mapa se puede usar en escritorio y móvil.
Entrega implementación, prueba del orden de coordenadas y evidencia de un filtro aplicado en las dos vistas.

QA de aplicación

Valida el directorio en desarrollo y en la salida compilada. Usa el conjunto aprobado y un conjunto sintético pequeño con homónimos, ficha sin coordenadas, texto con HTML y un establecimiento cerrado.
Comprueba carga inicial, búsqueda por nombre y código, combinación de región y comuna, limpieza de filtros y búsqueda sin coincidencias. Con el corte del artículo, compara la vista inicial con 5.406 fichas vigentes y 5.327 con coordenadas utilizables.
Prueba navegación por teclado, vista de 390 px, actualización simultánea de listado y mapa, y caída de la capa de mapas. Verifica que el HTML de prueba se muestre como texto.
Ejecuta la compilación y vuelve a probar la vista previa. Para cada caso anota entradas, resultado esperado, resultado observado y evidencia. Si una prueba falla, indica el paso exacto para reproducirla.
Entrega una decisión de salida basada en resultados observados y enumera las comprobaciones pendientes.

Publicación y mantenimiento

Prepara la publicación del directorio. Recibe el identificador del corte, su SHA-256, la versión del contrato, el informe de QA y el destino acordado.
Construye con el comando del proyecto y comprueba la carpeta de salida. Verifica en vista previa la ruta principal, los recursos, una búsqueda por código, un filtro de región y una ficha sin coordenadas.
Registra el artefacto y la versión previa. Si el encargo incluye desplegar, aplica el flujo existente y comprueba la URL pública. Si aparece una regresión que impide usar el directorio, recupera la versión previa según el flujo del proyecto y registra el fallo.
Para actualizar el corte, repite auditoría y revisión. Compara por región recuentos, cobertura, estados y cambios de esquema. Registra las diferencias antes de reemplazar el JSON.
Entrega URL comprobada si se publicó, fecha de corte, versión, resultado de las pruebas y procedimiento para recuperar la versión anterior.

Las referencias de instalación y de mapa permiten adaptar estos pasos al proyecto. Guía de agentes de OpenCode · API de Leaflet · Formato GeoJSON

Código reproducible en Python

El ejemplo usa Python 3.10 o superior y la biblioteca estándar. Lee CSV con punto y coma y UTF-8, reconoce los encabezados del corte auditado, mide vacíos, preserva identificadores como texto y genera un candidato JSON. Si encuentra fallas en la estructura, interrumpe la ejecución. Si encuentra filas en cuarentena, escribe el informe, devuelve código 2 y omite el candidato.

Descarga el CSV oficial del 10 de noviembre y guarda ambos scripts en el mismo directorio. CSV oficial · Auditoría · Verificación

python auditar.py establecimientos_20261110.csv ejecucion-20261110
python verificar.py establecimientos_20261110.csv ejecucion-20261110/auditoria.json

El directorio de salida debe ser nuevo. El verificador contrasta la huella SHA-256 del CSV y señala los indicadores que difieran. Puedes ejecutarlo sobre tu propio informe o sobre el informe publicado. Informe de auditoría

febff55e3612fb60076df9279f1090240cd02a39e9c7b79b822119dfdef84c8d

El candidato contiene una proyección de seis campos por registro. El siguiente ejemplo es sintético y muestra cómo se representa una ficha que puede aparecer en el listado y que carece de marcador.

{
  "id": "123456",
  "nombre": "Establecimiento de ejemplo",
  "region": "04",
  "comuna": "04102",
  "estado": "vigente_habitual",
  "ubicacion": null
}

La interfaz puede usar Astro para consumir el JSON en la compilación. Si se sirve desde un directorio público, cualquiera puede descargarlo completo. Para este ejercicio, la proyección excluye teléfonos, direcciones y campos ajenos al listado. Antes de poner un marcador en producción, contrastaría el par con un catálogo geográfico y confirmaría el sistema de referencia. Para una aplicación que oriente una decisión de atención, exigiría verificación operativa de horarios y disponibilidad en la fuente correspondiente.

En Astro, el listado itera sobre todos los registros aprobados. El mapa puede consumir una vista derivada que incluya solamente las fichas con ubicación. La interpolación de Astro renderiza el nombre como texto.

---
import corte from '../data/establecimientos.json';

if (corte.version_contrato !== 1) {
  throw new Error('Versión de contrato incompatible');
}
---

<ul>
  {corte.establecimientos.map(({ id, nombre, comuna, ubicacion }) => (
    <li>
      <strong>{nombre}</strong>
      <span>{' · Código DEIS ' + id + ' · Comuna ' + comuna}</span>
      {ubicacion === null && <span> · Ubicación no disponible</span>}
    </li>
  ))}
</ul>

Si el conjunto crece, se actualiza con frecuencia o requiere consultas espaciales y permisos por registro, evalúa un servicio de consulta versionado. El contrato y las pruebas deben seguir acompañando al dato cuando cambie el formato de entrega.

La decisión que le corresponde al CAIO

Antes de financiar el siguiente prototipo, pediría cinco evidencias. Son las que permiten aprobar una publicación concreta y volver a auditarla cuando cambie el dato.

  1. Versión y procedencia. URL de origen, fecha del corte, SHA-256 y versión de contrato.
  2. Integridad. Cero colisiones de claves y correspondencia con las tablas maestras relevantes.
  3. Cobertura por uso. Numerador, denominador y tratamiento de los faltantes por región y estado. Acordar umbrales antes de evaluar el siguiente corte.
  4. Seguridad y operación. Lista de campos públicos, agentes con permisos verificables y responsable capaz de retirar una versión defectuosa.
  5. Prueba del producto. Buscar una ficha sin ubicación, comprobar que sigue visible y verificar que el mapa explica qué puede mostrar.

La pregunta que llevaría a un comité de IA es sencilla. ¿Podemos explicar, con el archivo y las reglas en la mano, por qué este establecimiento aparece aquí y por qué aquel quedó fuera del mapa? Si la respuesta exige volver a preguntarle al agente, todavía falta trabajo sobre el dato.

Referencias

Butler, H., Daly, M., Doyle, A., Gillies, S., Hagen, S., & Schaub, T. (2016). The GeoJSON format (RFC 7946). RFC Editor. https://doi.org/10.17487/RFC7946

Gebru, T., Morgenstern, J., Vecchione, B., Vaughan, J. W., Wallach, H., Daumé, H., III, & Crawford, K. (2021). Datasheets for datasets. Communications of the ACM, 64(12), 86–92. https://doi.org/10.1145/3458723

International Organization for Standardization. (2008). Software engineering—Software product Quality Requirements and Evaluation (SQuaRE)—Data quality model (ISO/IEC Standard No. 25012:2008). https://www.iso.org/standard/35736.html

Ministerio de Salud de Chile. (2026a). Diccionario de datos base de establecimientos de salud red asistencial 2026. Portal de Datos Abiertos. https://datos.gob.cl/dataset/3bf4cf7c-f638-4735-9a01-f65faae4beca/resource/7127fc99-b858-4e74-8971-51413e484fb1/download/diccionario-de-datos.pdf

Ministerio de Salud de Chile. (2026b, 10 de noviembre). Establecimientos de salud (Corte del 10 de noviembre de 2026) [Conjunto de datos]. Portal de Datos Abiertos. https://datos.gob.cl/dataset/3bf4cf7c-f638-4735-9a01-f65faae4beca/resource/2c44d782-3365-44e3-aefb-2c8b8363a1bc/download/establecimientos_20261110.csv

OpenCode. (s. f.). Agents. https://opencode.ai/docs/agents/

OWASP. (2025). LLM01:2025 prompt injection. OWASP Gen AI Security Project. https://genai.owasp.org/llmrisk/llm01-prompt-injection/

Sambasivan, N., Kapania, S., Highfill, H., Akrong, D., Paritosh, P., & Aroyo, L. M. (2021). “Everyone wants to do the model work, not the data work”: Data cascades in high-stakes AI. En Proceedings of the 2021 CHI Conference on Human Factors in Computing Systems (Artículo 39, pp. 1–15). Association for Computing Machinery. https://doi.org/10.1145/3411764.3445518

Tabassi, E. (2023). Artificial intelligence risk management framework (AI RMF 1.0) (NIST AI 100-1). National Institute of Standards and Technology. https://doi.org/10.6028/NIST.AI.100-1

Vargas, S. [Profesor Sebastián Vargas]. (2026, 10 de noviembre). Taller: Vibe coding multiagéntico, de cero al prototipo | Sebastián Vargas | IA-LATAM [Video]. YouTube. https://www.youtube.com/watch?v=gevyttQ-1qk