Saltar al contenido principal
SofIA SDK permite automatizar los flujos de documentación clínica, desde la captura de información durante la consulta hasta la generación de reportes estructurados. Esta guía explica cómo funciona la automatización y cómo integrarla efectivamente.

​
Arquitectura de automatización

​
Flujo de generación automática

1

Interacción

El profesional sanitario interactúa con el SofIA SDK mediante voz o texto durante la consulta.
2

Transcripción y contexto

El SDK captura la conversación y la envía junto con el contexto del paciente al Framework Cognitivo.
3

Procesamiento IA

Los agentes especializados procesan la información, generando documentación clínica estructurada.
4

Entrega del reporte

El reporte estructurado se devuelve al SDK, que lo entrega al EHR/HIS mediante el callback handleReport.

​
Componentes del sistema

  • Captura de datos: Transcripción de audio y datos contextuales del paciente
  • Procesamiento inteligente: Framework cognitivo con agentes especializados
  • Generación estructurada: Reportes conformes a esquemas JSON predefinidos
  • Integración automática: Entrega de datos mediante callbacks para persistencia

​
Tipos de automatización

​
Generación automática de documentos

SofIA genera automáticamente documentación clínica estructurada basándose en:
  • Transcripción de la consulta: Conversación médico-paciente procesada en tiempo real
  • Datos contextuales del paciente: Información proporcionada en patientdata
  • Esquema predefinido: Estructura definida en template que especifica qué información generar
  • Validación automática: Verificación de coherencia clínica antes de entregar el reporte

​
Integración de reportes estructurados

La automatización de SofIA se centra en la generación de reportes a partir de transcripciones de consultas. El SDK genera reportes JSON estructurados que coinciden con el esquema de tu template, los cuales tu aplicación puede usar para rellenar formularios, actualizar campos del EHR o crear documentos clínicos. SofIA utiliza agentes de IA especializados para la generación de documentación y revisión de calidad.

​
Configuración de automatización

​
Propiedades requeridas para automatización

Para habilitar la automatización, SofIA SDK requiere:
  • template: Esquema JSON que define qué información generar y cómo estructurarla
  • handleReport: Función callback que recibe el reporte generado
  • userid y patientid: Identificadores para trazabilidad y contexto
  • patientdata (opcional): Información contextual del paciente para enriquecer la generación

​
Ejemplo completo de automatización

<sofia-sdk
  baseurl="https://api.omniloy.com"
  wssurl="wss://wss.omniloy.com"
  apikey="your-api-key"
  userid="dr-martinez-789"
  patientid="paciente-123"
  templateid="soap-general-v1"
  template='{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "title": "Nota SOAP",
    "type": "object",
    "properties": {
      "subjetivo": { "type": "string", "description": "Síntomas reportados por el paciente" },
      "objetivo": { "type": "string", "description": "Hallazgos del examen clínico" },
      "evaluacion": { "type": "string", "description": "Diagnóstico" },
      "plan": { "type": "string", "description": "Plan de tratamiento" }
    },
    "required": ["subjetivo", "evaluacion"]
  }'
  handle-report="handleReport"
  patientdata='{"fullName":"María García","birthDate":"1985-05-15","extraData":{"medical_practice":"Medicina Interna"}}'
></sofia-sdk>

<script>
function handleReport(report) {
  console.log('Reporte recibido:', report);
  // Enviar a su sistema EHR/HIS
  fetch('/api/clinical-reports', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      patientId: 'paciente-123',
      report: report,
      generatedAt: new Date().toISOString()
    })
  });
}
</script>

​
Funcionamiento del callback handleReport

El callback handleReport es el punto de integración principal:
  • Recepción de datos: Recibe el reporte estructurado según el esquema definido
  • Formato JSON: Los datos llegan en formato JSON validado
  • Momento de ejecución: Se ejecuta cuando el usuario solicita generar documentación
  • Responsabilidad de persistencia: El callback debe gestionar el guardado en el sistema EHR/HIS

​
Mejores prácticas de implementación

​
Diseño de esquemas

  • Define campos relevantes para el tipo específico de consulta
  • Proporciona valores description detallados para cada campo para guiar la extracción de la IA
  • Usa reference para habilitar codificación clínica automática (SNOMED CT, CIE-10, LOINC)
  • Incluye required solo para campos esenciales en toda consulta

​
Gestión de la integración

  • Valida la estructura y contenido de los reportes recibidos antes de persistirlos
  • Implementa manejo de errores para fallos de red o de guardado
  • Mantén registros de auditoría de quién generó qué y cuándo
  • Controla las versiones de esquemas para compatibilidad retroactiva

​
Consideraciones de calidad

  • Establece procesos de revisión profesional para la documentación generada
  • Comienza con automatización parcial y aumenta el alcance gradualmente
  • Usa retroalimentación para refinar esquemas y mejorar la calidad del resultado

​
Limitaciones y consideraciones

​
Limitaciones técnicas

  • Dependencia del esquema: La calidad de la automatización depende del diseño del esquema JSON
  • Contexto disponible: La generación se basa en la información disponible durante la consulta
  • Procesamiento de audio: Requiere audio de calidad suficiente para transcripción precisa
  • Conectividad: Necesita conexión estable para el procesamiento en tiempo real

​
Responsabilidades profesionales y legales

  • El profesional sanitario mantiene la responsabilidad sobre todo el contenido generado y las decisiones clínicas
  • Revisa y valida la información antes de la persistencia final en tu EHR/HIS
  • Asegura el consentimiento del paciente para documentación asistida por IA según la normativa aplicable
  • Mantén registros de trazabilidad para auditorías de cumplimiento

​
Próximos pasos