Evaluación de notas y completitud

Esta página define el límite de RheumAI. La implementación actual de ingesta, completitud, revisión y envío vive en el workflow de BiobadamexAI.

El problema

Una nota puede estar bien redactada y aun así omitir un dato necesario. También puede contener un dato correcto que el sistema no logra estructurar. Por eso hay que separar tres preguntas:

1. ¿Qué dice la nota?
2. ¿Qué dato exige el flujo clínico o el registro?
3. ¿Qué debe preguntar o corregir el médico antes de aprobar?

Capacidad actual de RheumAI

RheumAI puede:

• recibir texto clínico y archivos en el chat;
• extraer texto de PDF, hojas de cálculo, CSV, JSON, Markdown y texto;
• usar visión para ciertos PDF e imágenes cuando está configurada;
• clasificar el tipo de consulta y detectar algunos términos de alerta;
• recuperar evidencia y producir una interpretación clínica;
• pedir datos faltantes mediante instrucciones de la persona y del prompt;
• revisar la calidad de su propia respuesta con ORVS;
• procesar una nota desidentificada por una ruta stateless para el estudio.

Estas capacidades ayudan a descubrir vacíos, pero hoy producen principalmente texto narrativo.

Lo que no existe como contrato de RheumAI

El repositorio no expone todavía una respuesta estructurada con:

• cada campo requerido por BIOBADAMEX;
• valor extraído;
• fragmento de procedencia;
• estado presente, ausente, desconocido o no_aplicable;
• regla clínica que explica por qué el campo se exige;
• pregunta sugerida al médico;
• aprobación o rechazo del médico.

La ruta de estudio devuelve content, proveedor, modelo, herramientas, tokens, latencia y fallback. No devuelve una matriz de completitud de la nota. Tampoco aplica una comprobación determinista de desidentificación, límite específico para la longitud de la nota, ORVS final, revisión ética ni aprobación clínica. El llamador debe resolver esas obligaciones antes y después de la ruta.

Diseño de integración recomendado

El flujo institucional debe mantener responsabilidades separadas:

Etapa	Responsable	Salida
Ingesta	BiobadamexAI	Nota controlada y su identificador interno
Extracción	Servicio estructurado del registro	Campos candidatos con procedencia
Completitud	Reglas BIOBADAMEX por diagnóstico	Campos presentes, ausentes, desconocidos o no aplicables
Explicación clínica	RheumAI	Resumen de vacíos y preguntas útiles para el médico
Revisión de respuesta	ORVS y controles deterministas	Flags de exactitud, seguridad, citas y cobertura
Revisión humana	Médico autorizado	Corrección y aprobación explícita
Envío	Servicio controlado del registro	Solo datos aprobados, con lectura posterior

Regla central

RheumAI debe detectar y preguntar, no inventar. Si la nota no contiene un dato, la integración debe conservar el estado ausente o desconocido según la regla clínica. Una inferencia del modelo nunca se convierte automáticamente en un valor del registro.

Flujo para “completitud”

1. El extractor identifica valores candidatos y guarda el fragmento que los respalda.
2. El motor de reglas selecciona los campos aplicables al diagnóstico.
3. El sistema calcula completitud como presencia de campos aplicables. Exactitud y completitud se reportan por separado.
4. RheumAI transforma los vacíos en preguntas claras y priorizadas.
5. ORVS revisa la respuesta de RheumAI, no el expediente.
6. El médico confirma, corrige o marca que el dato no está disponible.
7. Solo la versión aprobada puede pasar al servicio de registro.

Salvaguardas

• Usar notas sintéticas o desidentificadas fuera del entorno clínico autorizado.
• Recordar que el chat normal puede persistir mensajes y archivos. Los PDF largos que parecen artículos también pueden entrar al directorio local de conocimiento según las reglas actuales.
• No guardar notas reales en repositorios, documentación, logs ni fixtures.
• Mantener procedencia campo por campo.
• No convertir 0, false o una fecha válida en “faltante” por una prueba booleana genérica.
• Mantener ausente, desconocido y no aplicable como estados distintos donde la regla clínica lo requiera.
• No permitir que ORVS o una respuesta narrativa salten la revisión del médico.
• Registrar qué modelo y versión de reglas produjo cada borrador.

Criterios antes de conectar el flujo

La integración no debe considerarse lista hasta que existan:

• contrato de entrada y salida versionado;
• reglas de completitud revisadas por diagnóstico;
• pruebas con notas sintéticas para campos presentes y faltantes;
• revisión clínica de las preguntas sugeridas;
• auditoría de que la ruta no escribe ni registra PHI de forma inesperada;
• control de autenticación servicio a servicio;
• fallback que preserve el borrador sin enviarlo si falla RheumAI.

Evidencia en código

• Ruta stateless de estudio
• Pruebas de la ruta de estudio
• Carga y análisis de archivos
• Interpretación de laboratorio
• Razonamiento clínico
• ORVS