Tu cuenta de DevLab
Invitación, inicio de sesión, sesiones, revelado de la key de tu equipo y qué registra DevLab sobre ti.
Las cuentas son por invitación
Sección titulada «Las cuentas son por invitación»Neurologyca, o el admin de tu organización, te invita a un equipo; no hay registro libre. El enlace del correo funciona una vez y caduca a las 72 horas. Una invitación nueva sustituye a la anterior; si la tuya caducó, pide otra (el admin de tu organización puede reenviarla).
Para activar la cuenta, elige una contraseña de 12 a 200 caracteres y acepta los Términos de DevLab (Los términos y tus acuerdos). Activar cierra cualquier otra sesión de la cuenta.
Invitar developers (admin de la organización)
Sección titulada «Invitar developers (admin de la organización)»Si eres el admin de la organización, Tu integración → Estado lista las personas de tu organización en Personas, e Invitar persona invita a alguien como developer de uno de tus equipos activos. También tienes Invitar persona arriba en Tu integración (en las dos vistas) y en el menú de tu cuenta (el avatar de la cabecera); los tres abren el mismo diálogo. Le llega un enlace de activación por correo (72 horas, un solo uso) y, una vez activa, ve la key de ese equipo.
- Eliges el email, el equipo y el idioma del correo. El rol es siempre developer: no puedes invitar a otro admin de la organización ni invitar a un equipo revocado.
- Reenviar manda un enlace nuevo a una invitación pendiente y anula el anterior, también uno que mandó Neurologyca.
- Cupos: 20 invitaciones al día por organización; 5 reenvíos por hora por invitación y 20 al día por organización.
- Un email que ya tiene cuenta en tu organización se dice (activa, o pendiente con Reenviarla; una pendiente de un equipo revocado, sin él). Para cualquier otro email la respuesta es siempre Invitación enviada: «si el email es válido, le llega un enlace de activación». DevLab nunca dice si un email tiene cuenta fuera de tu organización, y en ese caso no envía nada.
- DevLab nunca enseña el enlace de activación. Si el correo no salió (o no ha salido a los 10 minutos), la fila lo dice (el correo no salió · Reenviar). Un DevLab que no envía correo no puede invitar.
- Para retirar a alguien o cambiarlo de equipo, pídeselo a Neurologyca. Cada invitación y cada reenvío quedan en la actividad que ve Neurologyca.
Inicio de sesión y sesiones
Sección titulada «Inicio de sesión y sesiones»- Entra con tu email y tu contraseña. Tras demasiados intentos fallidos, el inicio de sesión se pausa hasta 15 minutos.
- Una sesión dura 7 días sin actividad y 30 días como máximo. Salir, en el menú de tu cuenta, la termina.
- Restablecer la contraseña, o que Neurologyca desactive tu cuenta, cierra tus sesiones en todas partes.
- Si abres una página de DevLab sin sesión, al entrar vuelves a esa página; si no, llegas a esta documentación, en tu idioma (un admin de Neurologyca, al panel de administración). Con una sesión ya abierta, la página de inicio de sesión te lleva a ese destino en vez de enseñar el formulario.
- Para entrar con otra cuenta, sal antes. Activar una cuenta o restablecer una contraseña en este navegador cierra la sesión que tuviera abierta: después entras con la contraseña nueva.
Si olvidas la contraseña
Sección titulada «Si olvidas la contraseña»Usa ¿La olvidaste?, junto al campo de la contraseña en la página de inicio de sesión. El enlace funciona una vez y caduca en 1 hora. Hoy no hay otra forma de cambiar la contraseña.
Revela la key de tu equipo
Sección titulada «Revela la key de tu equipo»En Tu cuenta, en Keys de Engine, elige Revelar e introduce tu contraseña.
- Hasta 5 revelados por hora y cuenta; los intentos con la contraseña equivocada cuentan. El cupo se comparte con las credenciales del procesado en diferido y con Incluir mi key y las credenciales del procesador, la descarga del zip del starter: una descarga con tus claves cuenta como un revelado, y una fallida también.
- Cada revelado queda registrado. Si DevLab no puede registrarlo, no muestra la key.
- La key solo aparece en ese diálogo. Cópiala en los secretos de tu backend y pulsa Hecho; puedes volver a revelarla más tarde con tu contraseña.
- Tu equipo comparte esta key: cualquiera del equipo puede revelarla.
- Mientras el equipo admin está activo, un admin de la organización ve y puede revelar todas las keys activas de la organización, también la key admin (scope
admin); si el equipo admin está revocado, solo ve su propio equipo, como revocado, sin nada que revelar. Pide a Neurologyca que rote o revoque cualquiera de ellas: cambiarlas fuera de DevLab deja a DevLab con una copia vieja. - Si tu equipo no tiene una key activa, Tu cuenta lo dice y enseña tu equipo como revocado (o sin key), sin nada que revelar. Si eres admin de la organización y solo le falta la key al equipo admin, sigues viendo y pudiendo revelar las keys activas de los demás equipos (sin Comprobar).
Credenciales del procesado en diferido
Sección titulada «Credenciales del procesado en diferido»El diferido está activado en una organización nueva salvo que Neurologyca lo desactivara al crearla; Neurologyca lo activa o desactiva. Tu cuenta tiene una sección Procesado en diferido (Preview). Todos los que tienen un equipo activo ven la URL del servicio y su IP de salida, para copiarlas. Limita tus tres rutas a esa IP como defensa en profundidad: la IP no autentica. Verificar la firma es obligatorio, y el SDK lo hace por ti. Ver Procesado en diferido.
La clave del procesador y el secreto de webhook son de tu organización: una sola pareja, la comparten todos los equipos y solo el equipo admin de tu organización los gestiona (revelar, rotar, activar). Un miembro de cualquier equipo activo recibe la pareja actual en su propio starter de grabación con Incluir mi key y las credenciales del procesador, junto a su propia key de Engine, así que nadie necesita el zip del equipo admin, que lleva la key admin. Neurologyca tampoco los revela: si tu organización se queda sin nadie en su equipo admin, Neurologyca invita a alguien a él.
- Revelar enseña la clave y el secreto a la vez, tras tu contraseña. Cuenta en los mismos 5 revelados por hora que las keys de Engine e Incluir mi key y las credenciales del procesador, también los fallidos, y queda registrado; si DevLab no puede registrarlo, no los enseña.
- Generar valores nuevos es el paso 1 de la rotación: elige la clave, el secreto o los dos, introduce tu contraseña (cuenta como un revelado) y copia los valores nuevos. Se quedan pendientes: el servicio sigue aceptando los actuales.
- Activar es el paso 2: despliega antes los valores nuevos en tu backend y escribe el nombre de tu organización para confirmar. DevLab se los envía al servicio y la sección dice «Enviando los valores nuevos al servicio…» hasta que el servicio los confirma. Si rotas el secreto y hay grabaciones en curso (o DevLab no puede saberlo), te pide que confirmes otra vez: sus avisos irán firmados con el secreto nuevo. Rotar solo la clave no tiene ese riesgo.
- Descartar borra los valores pendientes; nunca llegaron al servicio.
- Si los valores nuevos no llegan al servicio, la sección lo dice: el servicio sigue aceptando los anteriores y Neurologyca lo reintenta. Si tu backend ya usa los nuevos, vuelve a los anteriores hasta que la sección diga que los valores están activos.
Mientras el procesado en diferido está desactivado para tu organización, la sección lo dice y el servicio rechaza lo que envíe tu backend; el equipo admin de tu organización puede igualmente revelar, rotar y descartar, y los valores nuevos se usan cuando Neurologyca lo reactiva. Tus equipos tampoco pueden grabar en Diferido en el playground de DevLab: en un entorno con el procesado en diferido, Diferido dice que tu organización no lo tiene activado (en uno sin él, Diferido enseña su Preview de siempre con el ejemplo grabado). Si se filtra una credencial, sigue el procedimiento de Keys.
En el kit, el starter de grabación lleva en su .env la URL y la IP del servicio. Con Incluir mi key y las credenciales del procesador, cualquier equipo activo recibe además la clave del procesador y el secreto de webhook (los actuales, nunca los pendientes); cuando no pueden ir (el servicio aún no está dado de alta, o está desactivado), esas dos líneas van vacías, con el motivo. Cada zip de grabación lleva un UPLOAD_URL_SECRET aleatorio nuevo, que DevLab ni guarda ni registra: volver a descargar el zip lo cambia, y las URLs de vídeo ya firmadas con el anterior dejan de valer.
Tu integración
Sección titulada «Tu integración»En Tu integración, DevLab muestra tu organización en dos vistas. Protocolos lista sus contextos, sus protocolos publicados y Baseline, que va antes de cualquier protocolo; elige un protocolo para abrirlo en el visualizador, con sus posiciones, cuándo está disponible cada una y sus steps. DevLab lo lee todo de Engine con la key de tu equipo, en el servidor y sin crear usuarios: la key nunca llega a tu navegador. Cada vista tiene su propia dirección, así que puedes guardarla o compartirla con tu equipo.
Cada protocolo enseña también Indicadores que recibes en este contexto: los indicadores públicos que te da tu contexto (los mismos en todos los protocolos de ese contexto), o todo el catálogo público o cuántos de ellos recibes; después, los Disponibles bajo acuerdo, que puedes pedir a Neurologyca, y los cuatro que necesitan sesiones previas, que no dependen de tu acuerdo (no en Measurement, que no se interpreta). Siempre acaba con dos líneas: el payload puede traer más claves sin documentar, sobre las que no debes construir, y «Esta lista puede cambiar con el acuerdo de tu organización; trata como opcional todo indicador.», con cómo prepararte. Con tu equipo revocado también se ve, en solo lectura. KIT.md y los starters enlazan a ella, sin la lista. Qué es cada indicador: HCIs y resultados.
Kit, junto a Protocolo en la cabecera de un protocolo, te da su kit: neuro.config.json, .env.example, .npmrc, una guía KIT.md y AGENTS.md, las reglas y el índice de la doc para tu agente (el mismo bloque que Integrar con tu agente de código), cada uno en su pestaña, listos para copiar o descargar. KIT.md abre con una línea DevLab: que nombra el DevLab del que sale el kit, y enlaza la doc con URLs completas. Los zips de los starters llevan los mismos KIT.md y AGENTS.md. Baseline, y un protocolo cuyo contexto DevLab no puede resolver, no tienen kit. Ya lleva las decisiones que Neurologyca fija para tu organización (el subcontexto de cada mecánica, el rol y las audiencias); lo que falta aparece como pendiente, con “Pídeselo a Neurologyca”. Un subcontexto, un HCI objetivo o un rol sin fijar aparece en cambio como opcional: puedes capturar sin él. Sin subcontexto, Engine aplica el de la mecánica, constellationSubcontextId, o si no el subcontexto por defecto del contexto; un contexto sin subcontextos entre los que elegir no muestra ninguno. El rol no tiene efecto hoy: lo tendrá más adelante. Si lo pones, tiene que ser uno de los que acepta Engine (acuérdalo con Neurologyca): con cualquier otro, Engine rechaza crear el usuario con un 400 (E_ROLE_UNKNOWN en @neurologyca/capture-server). El kit lista siempre las audiencias de interpretación del contexto del protocolo, cada una con su ámbito (todo el contexto, un HCI objetivo o una situación), y su KIT.md también: envía una como audience en POST /analyze. Las que Neurologyca fija para tu organización aparecen aparte; un contexto sin ninguna lo dice. Un protocolo sin interpretación (como Measurement) también tiene su neuro.config.json, con triggerAnalysis: false: su kit dice que solo mide. El kit nunca lleva tu key: su variable de la key va vacía, y la key la revelas en esta cuenta. Cada fichero, variable y clave del kit, dónde encontrarlo y cómo ejecutar un starter están en Tu kit; cada pantalla, por rol, está en Dónde está cada cosa.
Estado responde a “¿funciona mi integración?”. Lista los siete hitos de tu equipo en orden de integración (primera llamada, primer usuario creado, primera inscripción, primera captura enviada, primera posición capturada, primera interpretación y primer uso de la key fuera de DevLab), cada uno con la fecha de la primera vez o pendiente; el primero pendiente es tu siguiente paso, con la página de la doc que lo explica (y el playground para la primera llamada). Un equipo cuyos protocolos son todos sin interpretación (como Measurement) tiene seis: la primera interpretación no aplica. Debajo, cuántos usuarios ha creado tu equipo y cuántos tienen Baseline y una inscripción, con la hora de la comprobación y Actualizar; si Engine ya no tiene activa tu key, lo dice. Los hitos cuentan lo que haces desde DevLab (referencia, playground) y las comprobaciones del propio DevLab; “primera posición capturada” se comprueba en Engine, y el primer uso Fuera de DevLab (tu backend o cualquier otra herramienta con la key) es un uso de tu key a más de 5 segundos de una comprobación de DevLab. Los conteos se recalculan cada minuto y se detienen en 500 usuarios (“500+”); si DevLab no llega a comprobar a todos los usuarios a tiempo, lo dice y puedes actualizar. Cuándo caduca tu key lo compruebas en esta cuenta (Comprobar). El admin de la organización ve, en cambio, solo la actividad de toda la organización, una fila por equipo y primero los que llevan más tiempo sin actividad: su última actividad (lo último entre sus hitos y el último uso de su key, en días de calendario; cuando lo último es ese uso, si vino desde DevLab o de fuera) y su key (“Caduca el …”, con aviso 30 días antes, o que ya no está activa en Engine). La key admin no cuenta, porque DevLab lee este estado con ella, y el equipo admin solo sale si tiene actividad propia; las keys que no son de DevLab, solo en totales. Si tu equipo no tiene una key activa, ves un aviso, los hitos que DevLab ya tenía (sin consultar Engine) y, cuando DevLab puede leerlos, los protocolos de tu organización en solo lectura («Protocolos de tu organización, solo lectura»): puedes abrir cada uno en el visualizador, pero no hay kit hasta que tu equipo vuelva a tener key.
Perfil, idioma, tema y novedades
Sección titulada «Perfil, idioma, tema y novedades»- Perfil. Tu cuenta se abre con tu Perfil: email, rol, organización y equipo (un chip dice Admin de la organización cuando lo eres). DevLab no tiene ninguna pantalla para cambiar tu email ni tu nombre: pídeselo a Neurologyca. La contraseña solo cambia con ¿La olvidaste? (arriba).
- Idioma. El menú Idioma de la cabecera cambia la interfaz y la documentación entre English y Español. DevLab recuerda en tu navegador la elección que hagas.
- Tema. El botón Tema de la cabecera rota Auto (el de tu sistema), Claro y Oscuro, y lo recuerda en tu navegador.
- Novedades. Novedades, en el menú de la cuenta, lista lo que ha cambiado en DevLab. Neurologyca también puede enviar un correo de novedades, en inglés, a las personas que elija. El correo termina con Unsubscribe from these updates: la página que abre te pide confirmar y solo detiene esos correos; sigues viendo Novedades dentro de DevLab. Neurologyca puede restablecer una dirección que se dio de baja.
Los términos y tus acuerdos
Sección titulada «Los términos y tus acuerdos»Para usar DevLab, la API de Engine y los SDK aceptas los Términos de DevLab: los Términos del servicio y los documentos que incorporan (la Política de uso aceptable, los Términos de las funciones Preview, el Anexo de datos biométricos e inferencia emocional, la Licencia de los SDK y la Licencia de las Agent Skills). El Aviso de privacidad es para que lo leas; no lo aceptas. Todos los documentos, con sus versiones anteriores, son públicos en /legal, sin iniciar sesión.
- Cuándo. Los aceptas al activar tu cuenta; a una cuenta que ya estaba activa se le piden una vez, en un diálogo, la próxima vez que entra. Las casillas empiezan sin marcar, y Ahora no, cerrar sesión cierra la sesión sin aceptar.
- Tu organización. La persona admin de tu organización los acepta por sí y en nombre de tu organización, incluido el Anexo de tratamiento de datos. Hasta que tu organización acepte la versión vigente, sus developers no pueden revelar keys ni llamar a Engine desde DevLab: Tu cuenta y Tu integración lo dicen y Revelar queda deshabilitado. Si tu organización firmó en cambio un acuerdo con Neurologyca, Neurologyca lo registra y el efecto es el mismo.
- Una versión nueva. Cuando los términos cambian, DevLab enseña antes un aviso con la fecha, Ver los cambios (la versión nueva del documento que cambia, en /legal) y Aceptar ahora; ese día te pide aceptar la versión nueva antes de seguir, con un resumen de lo que cambia.
- Mis acuerdos. Tu cuenta › Mis acuerdos lista cada versión que aceptaste, con su fecha y hora (UTC), cómo la aceptaste y enlaces a los documentos exactos de esa versión; la persona admin de la organización ve además lo que aceptó la organización. DevLab te envía una copia por correo cada vez que aceptas.
Qué registra DevLab
Sección titulada «Qué registra DevLab»DevLab registra tu actividad (inicios de sesión, revelados de keys, acciones de gestión e hitos de integración de tu equipo) y, en el inicio de sesión, la activación y el restablecimiento de la contraseña, y en los revelados de keys, la dirección IP que usaste (los revelados incluyen las credenciales del procesado en diferido). La guarda 12 meses, para darte soporte y por seguridad. Los hitos de tu equipo se conservan, pero a los 12 meses dejan de registrar quién los disparó.
DevLab guarda una constancia de cada aceptación de los términos (tu correo y tu cuenta, tu equipo y tu organización, tu rol, la calidad en la que aceptaste, la versión, una huella de cada documento y del texto de las casillas, el idioma, el instante, y tu dirección IP y tu navegador). No se puede modificar, se conserva durante la vida de la cuenta y 10 años después de cerrarla, y la dirección IP y el navegador se vacían a los 12 meses (Aviso de privacidad).
El registro de actividad de DevLab nunca contiene cuerpos de peticiones, keys ni datos de tus usuarios finales. Para aplicar los límites por equipo dentro de DevLab, DevLab guarda los identificadores (externalId, ids de inscripción y de interrupción) de los usuarios finales a los que tu equipo llega a través de DevLab, durante 24 horas desde la última vez que los comprobó con Engine.
Si usas el playground, DevLab registra también que aceptaste su consentimiento (versión, idioma y un hash del texto), 12 meses como el resto de tu actividad; después, el playground lo vuelve a pedir. Las personas de prueba que crea en la organización de tu equipo se borran en Engine a las 24 horas, o cuando tú o el admin de tu organización pulsáis Borrar ahora (al admin de la organización se le pide antes confirmación, con el nombre de tu equipo); después DevLab guarda cada ejecución solo como recuento, sin ids. Para que puedas volver a cualquier sesión de las últimas 24 horas, el servidor de DevLab guarda además unos metadatos cerrados de cada sesión que mides: cuándo se inscribió, la audiencia con la que se inscribió y la que aplicó Engine, la vía (SDK o API HTTP), si fue en vivo o en diferido y el estado de su trabajo en diferido, y cómo acabó (si llegó la interpretación, el número de steps, la duración y el estado del baseline). Solo valores de una lista cerrada y números, nunca texto ni el transcrito; se borran con la persona de prueba: a las 24 horas, con Borrar ahora o, si su borrado en Engine falla, cuando un reintento sale bien.
Si usas el asistente, DevLab registra que aceptaste su aviso (con su versión; aceptar los Términos de DevLab cuenta como aceptarlo, porque el Aviso de privacidad que enlazan cubre el asistente) y, por cada pregunta, que preguntaste, cuándo, desde qué página y en qué idioma, qué páginas de la doc citó la respuesta, si respondió desde la doc, qué destino propuso, si propuso uno, si se quitó algo, cómo acabó, el modelo y cuánto trabajo llevó (rondas, caracteres leídos, tiempos, tokens y un coste estimado) y tu valoración con su motivo (de una lista cerrada), nunca el texto, durante 12 meses como el resto de tu actividad. Tus preguntas, los últimos turnos de la conversación, el idioma de la respuesta, la página desde la que preguntas y las páginas de la doc que lee para responder van a Google, y DevLab no puede borrar lo que ya se envió. De una página de la doc va su texto; de una pantalla de DevLab, su nombre y, si «Dónde está cada cosa» la describe, esa descripción; puedes quitar la página antes de preguntar. Con cada pregunta, DevLab envía también tu rol (developer, admin de la organización o admin de Neurologyca), el estado de tu equipo (sin equipo, inactivo o activo) y si este DevLab ofrece invitaciones y procesado alojado: valores sin nombres ni identificadores, para que la respuesta se ajuste a tu situación. Más en Privacidad y datos.
Para borrar tu cuenta, contacta con Neurologyca. Tu actividad pasa a ser anónima; los usuarios finales que creaste en Engine siguen en tu organización.