Implementación y configuración
¿Cómo obtengo una API key para SofIA?
¿Cómo obtengo una API key para SofIA?
Envía un email a support@omniloy.com con tu nombre de empresa, descripción del proyecto y uso esperado. El equipo de Omniloy te proporcionará tu
apikey, baseurl y wssurl para entornos sandbox y producción. El tiempo de respuesta habitual es de 1-2 días laborables. Consulta el Quickstart para más detalles.¿Cuál es la diferencia entre sandbox y producción?
¿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.
baseurl, wssurl y apikey. Consulta ¿Cómo migro de sandbox a producción? más abajo.¿Puedo usar SofIA sin generación de reportes?
¿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.¿Cómo migro de sandbox a producción?
¿Cómo migro de sandbox a producción?
- Actualice
baseurlywssurla los endpoints de producción - Reemplace la
apikeycon sus credenciales de producción - Valide la configuración con una consulta de prueba
- Implemente monitorización y logging apropiados
Datos e integración
¿Dónde se almacenan los datos procesados?
¿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.¿Cómo reduzco el tamaño de patientData?
¿Cómo reduzco el tamaño de patientData?
- Incluye campos
urlen las entradas depatient_medical_notespara referenciar registros externos en lugar de incluir todo el historial (ver Datos del paciente) - Incluya únicamente información relevante para la consulta actual
- Segmente datos por especialidad o periodo temporal
¿Qué formato deben tener los esquemas JSON?
¿Qué formato deben tener los esquemas JSON?
Los esquemas deben seguir JSON Schema Draft-07. Incluya siempre:
Codificación clínica
¿Cómo funciona la codificación automática?
¿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). En el SDK, puedes habilitar referencias de codificación en tu esquema de template usando la propiedad
source — consulta Esquemas de datos clínicos para más detalles.¿Puedo personalizar las terminologías utilizadas?
¿Puedo personalizar las terminologías utilizadas?
Sí. En el SDK, añade una propiedad
source a los campos del esquema para especificar el sistema de codificación (por ejemplo, "ICD10", "cie_latam"). Consulta Esquemas de datos clínicos para la lista completa de fuentes soportadas. En la API, pasa la terminología deseada en el payload de tu petición — consulta la visión general de la API.¿Cómo valido la precisión de los códigos generados?
¿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
handleReportpara 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
Rendimiento y escalabilidad
¿Cuáles son los límites de uso?
¿Cuáles son los límites de uso?
- Payload máximo: 100 KB para
templatey 100 KB parapatientdata - Sesiones simultáneas: Depende de tu plan de suscripción — contacta 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
¿Cómo optimizo el rendimiento?
¿Cómo optimizo el rendimiento?
- Use esquemas JSON concisos y específicos
- Reduzca el tamaño de
templateypatientdatapara 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
Soporte técnico
¿Qué navegadores son compatibles?
¿Qué navegadores son compatibles?
¿Hay documentación adicional disponible?
¿Hay documentación adicional disponible?
- Guías de integración específicas por framework (Vanilla JS, React, Angular)
- Ejemplos de código completos en GitHub: sofia-sdk-examples
- Documentación de API REST complementaria: SofIA API