Qué es Engine 2
Los cuatro componentes, qué integras, qué puede medir tu organización y qué devuelve Engine.
Cuatro componentes, un sentido
Sección titulada «Cuatro componentes, un sentido»La plataforma de Neurologyca tiene cuatro partes, y los datos las recorren en un solo sentido:
| Componente | Dónde se ejecuta | Qué hace | Qué 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 | |
| Engine | Neurologyca | Ejecuta el protocolo de medición, los modelos propios y la calibración | Decidir el significado de un resultado |
| Konstellation | Neurologyca | Resuelve el caso de forma determinista, lo ancla en la evidencia y redacta la narrativa | Procesar señal o recalcular medidas |
| Tu aplicación | Tú | 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.
Solo hablas con Engine
Sección titulada «Solo hablas con Engine»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).
[{ "name": "Measurement", "taxonomy": null }]Un contexto con taxonomía trae su id (ilustrativo):
[ { "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.
Palabras que vas a ver
Sección titulada «Palabras que vas a ver»| 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.
Qué devuelve Engine
Sección titulada «Qué devuelve Engine»- 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.
Qué no devuelve
Sección titulada «Qué no devuelve»- 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.
Siguiente
Sección titulada «Siguiente»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.