Ir al contenido
DevLab

Qué es Engine 2

Los cuatro componentes, qué integras, qué puede medir tu organización y qué devuelve Engine.

En esta página
  1. Cuatro componentes, un sentido
  2. Solo hablas con Engine
  3. Contextos: qué puede medir tu organización
  4. Palabras que vas a ver
  5. Qué devuelve Engine
  6. Qué no devuelve
  7. Siguiente

La plataforma de Neurologyca tiene cuatro partes, y los datos las recorren en un solo sentido:

Los cuatro componentes y tu aplicación
ComponenteDónde se ejecutaQué haceQué no hace
Captura (@neurologyca/capture)En el dispositivo (tiempo real) Preview 0.45
En el dispositivo de la persona, en el navegador
Extrae geometría facial, coeficientes de expresión y pose mientras capturas. Sale: landmarks, coeficientes de expresión y pose hacia Engine; el transcrito y las señales extra, solo si los activas. El vídeo y el audio no salen del dispositivo.Interpretar nada
Diferido (en servidor) Preview
Graba en el navegador; se procesa en nuestro servicio de procesado
Graba el vídeo y un manifiesto de steps y los sube; nuestro servicio de procesado lo procesa poco después, así que el vídeo y el audio salen del dispositivo. Sale: vídeo y audio hacia tu receptor y el servicio de procesado.Interpretar nada
EngineNeurologycaEjecuta el protocolo de medición, los modelos propios y la calibraciónDecidir el significado de un resultado
KonstellationNeurologycaResuelve el caso de forma determinista, lo ancla en la evidencia y redacta la narrativaProcesar señal o recalcular medidas
Tu aplicaciónTúLa interfaz, la identidad de tus usuarios, el almacenamiento y el flujo; ejecuta la mitad de servidor del SDK (@neurologyca/capture-server): el proxy, el token y las inscripciones—

Cada flecha es un contrato versionado.

El propio SDK de captura tiene dos mitades: @neurologyca/capture corre en el navegador y @neurologyca/capture-server corre en tu backend. Ver Instalación.

Qué modo usar y cómo combinar el SDK con la API HTTP: Vías de integración.

Tu backend y tu página llaman a Engine, y a nada más. Engine llama a Konstellation por ti cuando pides una interpretación. En diferido, tu backend habla además con el servicio de procesado de Neurologyca, que llama de vuelta a tu backend con un webhook firmado (Servicio de procesado).

Contextos: qué puede medir tu organización

Sección titulada «Contextos: qué puede medir tu organización»

Un contexto es un caso de uso (por ejemplo, el bienestar de un deportista durante la semana de competición) con sus protocolos y, normalmente, una taxonomía que le dice a la interpretación en qué fijarse.

Neurologyca asigna contextos a cada organización. GET /catalog/contexts y GET /catalog/protocols devuelven el catálogo de tu organización, así que dos organizaciones ven listas distintas. La organización de estos ejemplos es solo eso: un ejemplo.

Si el contexto… Una captura devuelve Uso típico
tiene taxonomía (taxonomy.constellation_context_id) HCIs y una interpretación Bienestar, deporte, selección
no la tiene (Measurement) Solo HCIs, por frame y por step “Solo medir”: el significado lo pones tú

Measurement es universal en el entorno de pruebas: todos las organizaciones tienen su contexto y lo ven sin taxonomía. El Engine de producción aún no lo ofrece (Tus entornos).

JSON
[{ "name": "Measurement", "taxonomy": null }]

Un contexto con taxonomía trae su id (ilustrativo):

JSON
[
{
"name": "<your context>",
"taxonomy": {
"constellation_context_id": "<your-context-id>"
}
}
]

¿Te falta un contexto? Lo pide a Neurologyca el admin de tu organización. Puedes listar los tuyos cuando quieras con las dos llamadas de arriba, o en la referencia de la API.

Neurologyca te da una guía por cada uno de tus contextos: te la da Neurologyca con el acceso al contexto. Una guía de contexto cuenta:

  • qué mide el contexto y para quién;
  • sus protocolos, posiciones y cadencia;
  • su taxonomía: el contexto, el indicador objetivo y el subcontexto de cada mecánica;
  • sus steps y medias: quién cierra cada step y cuándo enviar mediaId;
  • qué steps transcribir y en qué idioma;
  • las audiencias disponibles para la interpretación y los roles de sus usuarios.
Palabra Qué es
Contexto Un caso de uso que tiene asignado tu organización; decide en qué protocolos puedes inscribir a las personas
Protocolo Qué se mide y cuándo: una lista ordenada de posiciones
Posición Un hueco del protocolo, la captura de un momento; cada una ejecuta una mecánica hecha de steps
Inscribir Apuntar a una persona a un protocolo (POST /user-protocols); el userProtocolId de la respuesta nombra esa inscripción
El par userProtocolId y protocolMechanicId: una inscripción y la posición que se captura. Tu backend se lo da a la página; se usa una vez
Sesión Una captura de una posición, del primer frame a sus resultados; Engine abre una por captura
Baseline Una captura corta por persona que Engine usa como su referencia; recomendada antes de cualquier protocolo, no obligatoria
Kit En Tu integración, por protocolo: su configuración del cliente (neuro.config.json), el entorno de tu backend (.env.example) y un starter listo para ejecutar por modo

Más niveles y sus nombres en la API: Protocolos y su jerarquía.

  • Human Context Indicators (HCIs) de cada frame capturado, y su media por step.
  • Eventos en vivo mientras se procesa una captura (Server-Sent Events).
  • Una interpretación de una captura completada, escrita para la audiencia que elijas, cuando el contexto tiene taxonomía.
  • No hay análisis agregado de todo un protocolo.
  • Sin webhooks de Engine: usas el stream en vivo o consultas los resultados (en diferido, el servicio de procesado sí manda uno).
  • Ningún audio llega a Engine: en el dispositivo, la transcripción corre en el navegador y solo sale su texto; en diferido, el audio va al servicio de procesado, que lo transcribe.
  • No hay intención, engaño ni diagnóstico. Los indicadores describen la interacción, no a la persona.

Sigue el Quickstart para ir de tu API key a tus primeros indicadores, o elige primero tu vía en Vías de integración.