Propiedades Opcionales

Configuraciones adicionales para personalizar SofIA SDK

Estas propiedades te permiten personalizar el comportamiento y apariencia del componente SofIA SDK para adaptarse a las necesidades específicas de tu implementación.

​

Control de Interfaz

Propiedad	Tipo	Descripción
isopen	boolean	Estado de visibilidad del componente, permite control bidireccional del estado abierto/cerrado

​

Callbacks

Propiedad	Tipo	Descripción
handle-report	function	Función callback que recibe el reporte clínico estructurado generado por SofIA. Puede referenciarse como función global o usar eventos
set-is-open	function	Función callback para manejar cambios de visibilidad solicitados por el componente

​

Datos Contextuales

Propiedad	Tipo	Valor por Defecto	Descripción
patientdata	string (JSON) | object	undefined	Información contextual del paciente (antecedentes, notas previas, referencias) para enriquecer el procesamiento clínico
transcriptorselectvalues	string (JSON)	undefined	Configuración para los valores del selector del transcriptor de audio

​

Control de Características

Propiedad	Tipo	Valor por Defecto	Descripción
isonlychat	boolean	false	Oculta el módulo de transcripción de audio, manteniendo solo la funcionalidad de chat
disableactions	boolean	false	Deshabilita todos los botones de acción (Generar, Rellenar)
disablegenerate	boolean	false	Deshabilita solo el botón Generar, manteniendo Rellenar activo

​

Personalización de UI

Propiedad	Tipo	Valor por Defecto	Descripción
sofiatitle	string	"Sofia Assistant"	Texto mostrado en el encabezado del componente

​

Depuración

Propiedad	Tipo	Valor por Defecto	Descripción
debug	boolean	false	Habilita logging detallado para propósitos de depuración

​

Localización

Propiedad	Tipo	Valor por Defecto	Descripción
language	string	"es"	Idioma de la interfaz. Valores soportados: "es" (Español), "en" (Inglés)

​

Estados de UI

Propiedad	Tipo	Valor por Defecto	Descripción
isscreenloading	boolean	false	Fuerza que se muestre el indicador de carga global en el componente

​

Callbacks Avanzados

Propiedad	Tipo	Valor por Defecto	Descripción
render-report-content	function	undefined	Una función para personalizar la renderización del contenido del reporte
set-get-last-report	function	undefined	Un callback que recibe una función para recuperar el último reporte generado
toast	string (JSON)	undefined	Configuración para notificaciones toast para mostrar mensajes al usuario

​

Recuperación Manual de Reportes

Además de recibir el reporte automáticamente, puedes solicitarlo bajo demanda desde tu aplicación.

La propiedad set-get-last-report ejecuta un callback que te proporciona una función asíncrona. Debes almacenar esta referencia para usarla cuando necesites recuperar el último reporte generado.

let getLastReportFn = null;

// Callback asignado a: set-get-last-report
function registerGetter(fn) {
  getLastReportFn = fn;
}

// Ejemplo de uso en un botón externo
async function handleSaveClick() {
  if (getLastReportFn) {
    const report = await getLastReportFn();
    console.log("Reporte recuperado:", report);
  }
}

​

Ejemplos de Uso

​

Configuración básica con datos del paciente

<sofia-sdk
  patientdata='{"age": 45, "history": "Hipertensión arterial"}'
  language="es"
  sofiatitle="Consulta de Cardiología"
  baseurl="https://api.example.com"
  wssurl="wss://ws.example.com"
  apikey="your-key"
  userid="doc123"
  patientid="pat456"
  toolsargs='{"type": "object"}'
  isopen="true"
  handle-report="handleReport"
  set-is-open="setIsOpen"
>
</sofia-sdk>

​

Modo solo chat para consultas rápidas

<sofia-sdk
  isonlychat="true"
  sofiatitle="Consulta Rápida"
  <!-- propiedades requeridas... -->
>
</sofia-sdk>

​

Configuración con acciones limitadas y fuentes de datos

<sofia-sdk
  disablegenerate="true"
  isscreenloading="true"
  language="en"
  transcriptorselectvalues='{"model": "whisper", "language": "es"}'
  <!-- propiedades requeridas... -->
>
</sofia-sdk>

​

Configuración avanzada con callbacks

<sofia-sdk
  render-report-content="customRenderFunction"
  set-get-last-report="setGetReportFunction"
  toast='{"message": "Reporte generado", "type": "success"}'
  <!-- propiedades requeridas... -->
>
</sofia-sdk>

​

Notas Importantes

• patientdata: Debe contener solo información necesaria para el contexto clínico, siguiendo principios de minimización de datos.
• Dimensiones: Las unidades pueden ser px, %, em, rem, o cualquier otra unidad CSS válida.
• Estados: Los cambios en propiedades booleanas se reflejan inmediatamente en la interfaz.
• Localización: Cambiar el idioma afecta toda la interfaz del componente, incluyendo mensajes de error y etiquetas.
• Callbacks: Las funciones pueden referenciarse por su nombre global o manejarse vía eventos DOM.