> ## Documentation Index
> Fetch the complete documentation index at: https://omniloy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatización de flujos clínicos

> Automatización de documentación clínica y integración con sistemas EHR/HIS

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

<Steps>
  <Step title="Interacción">
    El profesional sanitario interactúa con el **SofIA SDK** mediante voz o texto durante la consulta.
  </Step>

  <Step title="Transcripción y contexto">
    El SDK captura la conversación y la envía junto con el contexto del paciente al **Framework Cognitivo**.
  </Step>

  <Step title="Procesamiento IA">
    Los **agentes especializados** procesan la información, generando documentación clínica estructurada.
  </Step>

  <Step title="Entrega del reporte">
    El reporte estructurado se devuelve al SDK, que lo entrega al **EHR/HIS** mediante el callback `handleReport`.
  </Step>
</Steps>

### 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

```html theme={null}
<sofia-sdk
  id="sofia"
  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"]
  }'
  patientdata='{"fullName":"María García","birthDate":"1985-05-15","extraData":{"medical_practice":"Medicina Interna"}}'
></sofia-sdk>

<script>
// Asigna handleReport como propiedad del elemento una vez definido el componente
customElements.whenDefined('sofia-sdk').then(() => {
  const sofia = document.getElementById('sofia');
  sofia.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
* Habilita la codificación clínica estableciendo el `source` personalizado de tu campo **o** solicitando la terminología directamente en la `description` del campo (p. ej. "proporciona el diagnóstico con su código CIE-10") — consulta [Esquemas de datos clínicos](/sofia/es/sdk/templates#fuentes-de-codificación-clínica)
* 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

* **[Chat clínico](/sofia/es/sdk/chat)**: Utiliza el asistente conversacional para complementar la automatización
* **[Esquemas de datos clínicos](/sofia/es/sdk/templates)**: Diseña esquemas efectivos para tu práctica
* **[Referencia de Errores](/sofia/es/sdk/error-reference)**: Gestiona errores en flujos automatizados