Ir al contenido
DevLab

Dónde está cada cosa

Todas las pantallas de DevLab para un developer y para un admin de la organización: dónde están, qué tienen, qué puedes copiar y qué ves cuando falta algo.

En esta página
  1. La cabecera
  2. Para developers
  3. Para admins de la organización
  4. Tu perfil
  5. Las páginas de antes de entrar
  6. Qué mensaje te dice qué falta

Una forma rápida de responder a «¿dónde está…?». Cada pantalla de abajo dice dónde está, qué tiene y qué ves si falta algo (sin equipo, con la key revocada). El kit, fichero a fichero, está en Tu kit.

En todas las páginas de DevLab (sin sesión tiene un enlace para entrar en lugar del menú de la cuenta):

  • Documentación: un menú con las páginas de esta doc. Buscar en la doc abre el buscador (Ctrl o ⌘ + K).
  • Playground y Tu integración. Tu integración está con cualquier cuenta; si tu cuenta no tiene equipo, la página lo dice.
  • Tema: un botón que rota Auto, Claro y Oscuro. Idioma: un menú con English y Español. DevLab recuerda ambos en tu navegador.
  • El asistente, cuando este DevLab lo tiene (Ctrl o ⌘ + I).
  • El menú de la cuenta (tus iniciales): tu email y tu equipo, Tu cuenta y API key, Tu integración, Invitar persona (solo los admins de la organización), Novedades, Legal y Salir.

En una pantalla estrecha, los mismos enlaces están en el menú ☰.

Perteneces a un equipo. Todo lo de esta página lo puedes abrir, con los límites que explica cada pantalla.

Playground

Playground › Medir

Ejecuta una captura con el SDK (por defecto) o con la API HTTP y muestra las llamadas que hace. Abrirla

Qué tiene

  • Un mando entre el SDK y la API HTTP, y la elección del origen: vídeo de muestra, cámara o muestra sintética.
  • Dos mandos eligen qué medir: Contexto (Measurement primero, cada contexto con su número de protocolos) y después Protocolo, solo con los protocolos de ese contexto; un contexto con un solo protocolo lo enseña fijo.
  • Un panel con las llamadas que haría tu backend.
  • Cuando el protocolo tiene interpretación, sale en la tarjeta de resultado.
  • Si Engine tarda más de lo que el playground espera la interpretación (por el SDK o la API HTTP), la tarjeta de resultado dice Engine sigue interpretando y ofrece Volver a pedir la interpretación.
  • Con un contexto que tiene audiencias, el mando Audiencia elige para quién se escribe la interpretación (de tu kit), y la tarjeta de resultado dice para quién se escribió.
  • Al recargar, la tarjeta de resultado enseña Sesión recuperada: la última sesión de tu persona de prueba, releída de Engine.

Si falta algo

  • Sin iniciar sesión o sin equipo activo solo ves el ejemplo grabado.
  • Medir sale deshabilitado, con el motivo debajo, cuando el caso más largo del protocolo no cabe en los 10 min por sesión del playground (un step sin máximo propio cuenta 1 min).

Playground › Flujo

Muestra cada llamada real en su carril y en su instante: Tu app, Tu backend y Eventos. Abrirla

Qué tiene

  • La secuencia de llamadas de la ejecución que hiciste en Medir.

Playground › Baseline

Captura el baseline de una persona, que va antes de cualquier protocolo. Abrirla

Qué tiene

  • El mismo mando entre SDK y API HTTP y el mismo origen que Medir.
  • El estado del baseline: listo solo cuando Engine lo dice.
  • Si vienes de Medir, una franja Vienes de Medir con Volver y medir: te lleva a Medir sin empezar una captura.

Si falta algo

  • Sin iniciar sesión o sin equipo activo solo ves el ejemplo grabado.

Playground › Resultados

Muestra lo que midió una sesión (por defecto, la última) y te deja descargarlo. Abrirla

Qué tiene

  • Recuentos, un gráfico pequeño por indicador, una tabla y descargas locales.
  • Un selector Sesión con tus sesiones de las últimas 24 h, agrupadas por persona de prueba; elegir una la vuelve a pedir a Engine. La última sigue siempre a Medir.
  • Una franja arriba que dice de dónde viene lo que ves: Ejemplo grabado, Tu sesión, una sesión que elegiste o Sesión recuperada.
  • Un selector de rango: Toda la sesión, una pregunta o un step; las fichas, la serie, la tabla y las descargas lo siguen, cada media con quién la da (Engine o DevLab). Con una pregunta o un step, la pregunta y Lo que dijo. No el texto de la interpretación.
  • Volver a Medir, cuando llegaste desde Medir.

Si falta algo

  • Mide antes una sesión en Medir, o mira el ejemplo grabado. La interpretación no está aquí: sale en la tarjeta de resultado de Medir y en Diferido.

Playground › Diferido (en servidor)

Graba en el dispositivo, sube la grabación y deja que un servidor la procese después (Preview). Abrirla

Qué tiene

  • Cuatro fases: grabar, subir, procesar y resultados.
  • Grabar funciona con el vídeo de muestra o con la cámara.
  • Los mismos mandos Contexto y Protocolo que Medir, con la misma elección; un contexto que este entorno no graba en diferido sale desactivado, con el motivo.
  • Como en Medir, un step sin máximo propio se cierra solo al cabo de 1 min y una sesión se detiene a los 10 min; una sesión detenida a los 10 min no se sube.
  • Los resultados incluyen la interpretación cuando la hay.
  • El mismo mando Audiencia que Medir, con la misma elección.

Si falta algo

  • Sin iniciar sesión, sin equipo activo o con la grabación no disponible ves el ejemplo grabado y ningún botón de grabar.
  • En un DevLab con grabación, si tu organización no tiene activado el procesado en diferido, la sección lo dice, explica qué es y enseña el ejemplo grabado, sin botón de grabar; lo activa Neurologyca, y entonces sirve en el playground y en tu integración.
  • Grabar sale deshabilitado, con el motivo debajo, cuando el caso más largo del protocolo no cabe en 10 min, o cuando su kit no tiene un contexto asignado.

Playground › SDK y API

El código detrás de cada pieza del playground: primero el SDK, la API HTTP como complemento. Abrirla

Qué tiene

  • Tarjetas para la vista de cámara, el gráfico temporal, las fichas de resultados, la lectura posterior desde tu backend, la comprobación del dispositivo antes de medir y cuándo cargar los modelos de cara y voz.
  • Un botón para descargar el starter en vivo (el flujo completo de Medir; las piezas que no incluye se copian desde Código).

Si falta algo

  • Descargar el starter en vivo está desactivado sin sesión ("Inicia sesión para descargar") o si tu equipo no tiene key activa.

Playground › SDK y API › Vista de cámara

El código y los datos de la vista de cámara. Abrirla

Playground › SDK y API › Gráfico temporal

El código y los datos del gráfico temporal. Abrirla

Playground › SDK y API › Fichas de resultados

El código y los datos de las fichas de resultados. Abrirla

Playground › SDK y API › Guardar y leer después

Qué guarda tu backend al inscribir para leer después los resultados de una captura, cuánto los guarda Engine y cómo borrar a la persona. Abrirla

Playground › SDK y API › Comprobar el dispositivo

Qué puede hacer este navegador en este equipo antes de medir: el dispositivo check por check, el código del prevuelo y la regla del ritmo de la sesión. Comprobar ahora funciona sin iniciar sesión, no pide permisos y no llama a Engine. Abrirla

Playground › SDK y API › Cargar los modelos

Las cinco maneras de cargar los modelos de cara y voz (sin preparar, en la pantalla anterior, la voz tras el consentimiento, calentar la caché, varias sesiones con keepPrepared), cuándo elegir cada una, su código probado y cómo cargaron tus propias sesiones en esta pestaña. No carga nada. Abrirla

Tu integración

Tu integración › Protocolos

Los protocolos de tu organización, leídos del catálogo, cada uno con su vista Protocolo y su Kit. Qué indicadores recibes está en la vista Protocolo de cada protocolo, en «Indicadores que recibes en este contexto». Abrirla

Qué tiene

  • Una lista con filtro, Baseline primero, y al final los protocolos con el contexto sin resolver.
  • Dos vistas por protocolo: Protocolo (posiciones, disponibilidad, steps) y Kit.
  • En la vista Protocolo, «Indicadores que recibes en este contexto»: la lista de indicadores que te da tu contexto, los que recibes de entre los públicos.

Si falta algo

  • Sin equipo no hay nada que mostrar.
  • Si tu equipo no tiene key activa, los protocolos son de solo lectura y sin kit.

Tu integración › Protocolos › Kit

Abre Tu integración › Protocolos, elige el protocolo en la lista y pulsa Kit: los ficheros de ese protocolo para copiar o descargar, y los starters. Abrirla

Qué tiene

  • Una pestaña por fichero: neuro.config.json, .env.example, .npmrc, KIT.md y AGENTS.md. Cada una tiene un botón Copiar y un botón con icono, Descargar el fichero; un fichero cuyo nombre empieza por punto se guarda sin él y un aviso dice a qué renombrarlo.
  • Una columna lateral con lo pendiente, lo opcional y las vías de integración (SDK recomendado, API HTTP complementaria). Rol y audiencias salen solo en los protocolos con interpretación; uno que solo mide lo dice.
  • Bajo las vías, Versiones: las versiones de @neurologyca/capture y @neurologyca/capture-server para las que está hecho el kit, con el comando npm ls @neurologyca/capture @neurologyca/capture-server y Copiar, y el changelog. Durante 30 días desde que se publica una versión, su fila dice Nueva (compatible: el comando npm i y qué cambia) o Incompatible (alguna versión de esos días, hasta la del kit, es incompatible: la guía de migración). DevLab no ve el proyecto, así que no puede decir qué versión tiene instalada la persona. KIT.md dice las mismas versiones bajo su línea DevLab.
  • Abajo, los starters: uno en el dispositivo y otro de grabación (Preview), cada uno un .zip, con la opción Incluir mi key, que pide tu contraseña. Sin el servicio de procesado en tu organización, la tarjeta de grabación dice que ese starter no arranca.
  • KIT.md, en el kit y en los starters, no lleva la lista de indicadores, solo un enlace a Tu integración › Protocolos, donde está la lista de tu contexto.

Si falta algo

  • Baseline no tiene kit: va antes de cualquier protocolo.
  • Un protocolo con el contexto sin resolver tampoco tiene kit.
  • Sin key activa en tu equipo no hay kit.
  • La lista de indicadores no está en el kit: se lee en Tu integración › Protocolos, en el protocolo.

Tu integración › Estado

Hasta dónde ha llegado tu integración. Abrirla

Qué tiene

  • Developer: los hitos de tu equipo, el siguiente paso y los recuentos de usuarios, usuarios con Baseline e inscritos, con un botón Actualizar. Un chip avisa cuando tu key ya no está activa en Engine.
  • Admin de la organización: una tabla por equipo con la última actividad y la key con su caducidad, un aviso sobre las otras keys de la organización y debajo la sección Personas.
  • Para comprobar cuándo caduca tu key, usa Comprobar en Tu cuenta y API key › Keys de Engine.

Si falta algo

  • Sin equipo no hay estado que mostrar.
  • Sin key activa solo se muestran los hitos que DevLab ya tenía; no se consulta nada en Engine.
  • Solo el admin de la organización ve Personas.

Tu cuenta y API key

Tu cuenta y API key

Tu perfil y las keys de Engine que puedes ver. Abrirla

Qué tiene

  • Perfil: tu email, rol, organización y equipo, con enlaces a Tu integración y a la documentación.
  • Keys de Engine.
  • Procesado en diferido, cuando está disponible.

Si falta algo

  • Sin equipo la página dice que tu cuenta aún no tiene equipo y que no hay key que ver.

Tu cuenta y API key › Keys de Engine

Las keys de tu equipo, que no se muestran enteras hasta que lo pides. Abrirla

Qué tiene

  • Una tabla con equipo, key (solo una pista), fecha de rotación y caducidad.
  • Revelar muestra la key en un diálogo tras teclear tu contraseña: 5 por hora, intentos fallidos incluidos, y queda registrado.
  • Comprobar, en cada fila, pregunta a Engine la fecha de caducidad y avisa si la key caduca pronto o ha caducado.
  • El admin de la organización ve las keys de todos los equipos activos de la organización.

Si falta algo

  • Sin equipo no hay key que ver.
  • Si tu equipo está revocado o sin key, la página muestra un aviso y ningún Revelar para tu equipo. El admin de la organización sigue viendo Revelar en los demás equipos activos.

Tu cuenta y API key › Procesado en diferido

El servicio alojado que procesa tus grabaciones y avisa a tu backend con un webhook firmado (Preview). Necesita una key activa de tu equipo y un DevLab que lo ofrezca. Abrirla

Qué tiene

  • Para todos: la dirección del servicio y la IP de salida del procesador, cada una con Copiar.
  • El equipo admin de la organización gestiona además la clave del procesador y el secreto del webhook: Revelar, Generar valores nuevos, Activar y Descartar.

Si falta algo

  • La sección aparece solo cuando tu equipo tiene una key activa y este DevLab ofrece el procesado alojado.
  • Si no estás en el equipo admin, la sección solo enseña la dirección y la IP: descarga la clave y el secreto en tu propio starter de grabación con Incluir mi key y las credenciales del procesador (Tu integración › Protocolos › Kit).

Tu cuenta y API key › Mis acuerdos

Los Términos de DevLab que has aceptado, cada versión con su fecha y los documentos exactos que aceptaste. Abrirla

Qué tiene

  • Una tabla con versión, fecha y hora (UTC), cómo aceptaste (activación, versión nueva…) y enlaces a los documentos en la versión que aceptaste.
  • El admin de la organización ve además lo que aceptó la organización, también un acuerdo firmado que registró Neurologyca.
  • Todos los documentos y sus versiones anteriores son públicos en /legal, sin iniciar sesión.

Si falta algo

  • Si tu organización no ha aceptado los términos, Tu cuenta y Tu integración muestran un aviso, y Revelar e Incluir mi key quedan deshabilitados hasta que lo haga.

Novedades

Novedades

Qué ha cambiado en DevLab, en las versiones publicadas hasta ahora.

Qué tiene

  • También se llega desde el menú de la cuenta.

Estás en el equipo admin de tu organización.

El admin de la organización ve todo lo que ve un developer, y además:

Tu integración

Invitar persona

Abre el diálogo para invitar a un developer a uno de tus equipos. Abrirla

Qué tiene

  • El email, el equipo y el idioma del correo.
  • La persona entra como developer de ese equipo y recibe un enlace de activación.
  • El mismo botón está en la cabecera de Protocolos y de Estado (si invitar está activado), en la sección Personas de Estado y en el menú de la cuenta.

Si falta algo

  • Solo el admin de la organización puede invitar.
  • Invitar está desactivado si el equipo admin no tiene key activa o si este DevLab no envía correo.

En Tu cuenta y API key, el Perfil muestra tu email, tu rol, tu organización y tu equipo (un chip dice Admin de la organización si lo eres). DevLab no tiene ninguna pantalla para cambiar tu email ni tu nombre: pídeselo a Neurologyca. La contraseña solo se cambia con ¿La olvidaste? en la página de entrada (Tu cuenta de DevLab).

  • Entrar: tu email y contraseña, ¿La olvidaste? y «para seguir en…» cuando vienes de una página que pide sesión.
  • Activar tu cuenta: la página que abre el enlace de la invitación. Eliges contraseña y aceptas los Términos de DevLab (Los términos y tus acuerdos).
  • Restablecer la contraseña: la página que abre el enlace de restablecimiento.
  • Darse de baja: el enlace del final del correo de Novedades de DevLab. Te pide confirmar, y solo detiene los correos: sigues viendo Novedades dentro de DevLab.
Ves Qué significa Dónde se explica
«Tu cuenta aún no tiene equipo» Tu cuenta no está asignada a ningún equipo Pregunta a quien te invitó; Modelo de acceso
«Tu equipo no tiene una key de Engine activa» y tu equipo como Revocado La key se revocó o nunca se creó Tu cuenta de DevLab y Keys
Protocolos en «solo lectura» La misma causa: puedes leer tus protocolos, pero no hay kit Tu kit
«Baseline no tiene kit» Baseline va antes de cualquier protocolo Tu kit
«Sin iniciar sesión: nada se mide ni se guarda» o «Sin equipo: nada se mide ni se guarda» El playground solo enseña el ejemplo grabado El playground
«Invitar no está disponible: este DevLab no envía correo» Aquí no se puede invitar a nadie Tu cuenta de DevLab