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

# Preguntas frecuentes

> Preguntas comunes sobre configuración del SDK de SofIA, manejo de datos, codificación clínica y soporte técnico

## Implementación y configuración

<AccordionGroup>
  <Accordion title="¿Cómo obtengo una API key para SofIA?">
    Envía un email a [support@omniloy.com](mailto:support@omniloy.com) con tu nombre de empresa, descripción del proyecto y uso esperado. El equipo de Omniloy te proporcionará tu `apikey`. Para las claves más nuevas el SDK selecciona el endpoint automáticamente; otras claves también incluyen un `baseurl` — Omniloy te indica cuál aplica a la tuya. El tiempo de respuesta habitual es de 1-2 días laborables. Consulta el [Quickstart](/sofia/es/sdk/quickstart) para más detalles.
  </Accordion>

  <Accordion title="¿Cuál es la diferencia entre sandbox y producción?">
    * **Sandbox**: Entorno de pruebas con datos simulados, ideal para desarrollo e integración. Sin facturación por uso. Las respuestas de IA pueden usar datos de ejemplo.
    * **Producción**: Entorno real con procesamiento completo de IA médica y facturación por uso. Requiere certificado SSL válido y API key de producción.

    El único cambio de código necesario es sustituir tu `apikey` — Omniloy te da una clave distinta para cada entorno. Si tu clave requiere `baseurl`, sustitúyelo también. Consulta [¿Cómo migro de sandbox a producción?](#implementación-y-configuración) más abajo.
  </Accordion>

  <Accordion title="¿Puedo usar SofIA sin generación de reportes?">
    Sí, simplemente omita las propiedades `template` y `templateid`. SofIA operará automáticamente en modo solo chat sin el botón de generar. Ideal para consultas por texto o integraciones con sistemas existentes.
  </Accordion>

  <Accordion title="¿Cómo migro de sandbox a producción?">
    1. Reemplaza la `apikey` con tus credenciales de producción — Omniloy emite una clave distinta por entorno
    2. Si tu clave requiere `baseurl`, actualízalo al endpoint de producción
    3. Valide la configuración con una consulta de prueba
    4. Implemente monitorización y logging apropiados
  </Accordion>
</AccordionGroup>

## Datos e integración

<AccordionGroup>
  <Accordion title="¿Dónde se almacenan los datos procesados?">
    SofIA no persiste datos clínicos. El reporte generado se entrega a través del callback `handleReport` y es responsabilidad de su aplicación almacenarlo en su EHR o sistema de gestión.
  </Accordion>

  <Accordion title="¿Cómo reduzco el tamaño de patientData?">
    * Incluye campos `url` en las entradas de `patient_medical_notes` para referenciar registros externos en lugar de incluir todo el historial (ver [Datos del paciente](/sofia/es/sdk/patient-data))
    * Incluya únicamente información relevante para la consulta actual
    * Segmente datos por especialidad o periodo temporal
  </Accordion>

  <Accordion title="¿Qué formato deben tener los esquemas JSON?">
    Los esquemas deben seguir JSON Schema Draft-07. Incluya siempre:

    ```json theme={null}
    {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "type": "object",
      "properties": {
        "diagnosis": { "type": "string" }
      },
      "required": ["diagnosis"]
    }
    ```
  </Accordion>
</AccordionGroup>

## Codificación clínica

<AccordionGroup>
  <Accordion title="¿Cómo funciona la codificación automática?">
    La codificación clínica automática (CIE-10, SNOMED CT, LOINC) está disponible a través de la [SofIA API (Codify)](/sofia/es/api/overview). En el SDK, puedes habilitar referencias de codificación en tu esquema de template usando la propiedad `source` — consulta [Esquemas de datos clínicos](/sofia/es/sdk/templates) para más detalles.
  </Accordion>

  <Accordion title="¿Puedo personalizar las terminologías utilizadas?">
    Sí. En el SDK, puedes solicitar una terminología directamente en la `description` de un campo (p. ej. "con su código CIE-10"), o codificar contra un **master personalizado** estableciendo el `source` del campo. Los masters se provisionan por cuenta — contacta a [support@omniloy.com](mailto:support@omniloy.com) para que creen tu master personalizado y te proporcionen su valor de `source`. Consulta [Esquemas de datos clínicos](/sofia/es/sdk/templates#fuentes-de-codificación-clínica) para más detalles. En la API, pasa la terminología deseada en el payload de tu petición — consulta la [visión general de la API](/sofia/es/api/overview).
  </Accordion>

  <Accordion title="¿Cómo valido la precisión de los códigos generados?">
    * Implementa siempre revisión médica para códigos críticos — los códigos generados por IA deben ser verificados por un clínico antes de su envío
    * Configura campos `"required"` en tu JSON Schema para asegurar que los códigos clave estén siempre presentes
    * Usa el callback `handleReport` para ejecutar lógica de validación personalizada antes de persistir en tu EHR
    * Habilita `debug="true"` durante el desarrollo para inspeccionar el payload completo del reporte
  </Accordion>
</AccordionGroup>

## Rendimiento y escalabilidad

<AccordionGroup>
  <Accordion title="¿Cuáles son los límites de uso?">
    * **Payload máximo**: 100 KB para `template` y 100 KB para `patientdata`
    * **Sesiones simultáneas**: Depende de tu plan de suscripción — contacta [support@omniloy.com](mailto:support@omniloy.com) para más detalles
    * **Rate limiting**: Configurado por API key según tu contrato. Si recibes respuestas HTTP 429, has excedido tu límite de peticiones
  </Accordion>

  <Accordion title="¿Cómo optimizo el rendimiento?">
    * Use esquemas JSON concisos y específicos
    * Reduzca el tamaño de `template` y `patientdata` para minimizar el tiempo de procesamiento
    * Use `debug="true"` para identificar cuellos de botella en la consola del navegador
    * Pre-cargue datos relevantes cuando sea posible
  </Accordion>
</AccordionGroup>

## Soporte técnico

<AccordionGroup>
  <Accordion title="¿Qué navegadores son compatibles?">
    SofIA es compatible con navegadores modernos que soporten WebRTC y WebSockets:

    * Chrome 80+
    * Firefox 75+
    * Safari 13+
    * Edge 80+
  </Accordion>

  <Accordion title="¿Hay documentación adicional disponible?">
    * Guías de integración específicas por framework ([Vanilla JS](/sofia/es/sdk/vanilla), [React](/sofia/es/sdk/react), [Angular](/sofia/es/sdk/angular))
    * Ejemplos de código completos en GitHub: [sofia-sdk-examples](https://github.com/Omniloy/sofia-sdk-examples)
    * Documentación de API REST complementaria: [SofIA API](/sofia/es/api/overview)
  </Accordion>
</AccordionGroup>