Hola equipo de n8n academy,
Recientemente vi dos publicaciones que plantearon problemas en la QS101: Quickstart’s Section 3:
Después de resolverlo, noté que proviene de la pérdida de contexto cuando los estudiantes se mueven entre la Sección 2 y la Sección 3 del curso, y de información faltante en las instrucciones de la Sección 3.
La causa raíz es que esos nodos HTTP requieren dos encabezados HTTP (x-assessment-id y X-API-KEY). En la Sección 2, el curso guía a los usuarios para agregar el x-assessment-id a través de «Send Headers» (Enviar encabezados) y agregar el X-API-KEY a través de credenciales.
Sin embargo, en la Sección 3, las instrucciones dicen reutilizar las credenciales de la Sección 2 o agregar el x-assessment-id en las credenciales (lo cual es opuesto a la instrucción de la Sección 2), y no mencionan el X-API-KEY en absoluto.
Un estudiante malinterpretó e anuló sus credenciales actuales de X-API-KEY a x-assessment-id, lo que también causó que su Sección 2 funcionara fallara, y no tienen idea de cómo arreglarlo.
Con respecto a reutilizar credenciales, los estudiantes no pueden simplemente copiar y pegar el nodo porque la Sección 3 utiliza HTTP Request como una herramienta de agente en lugar de un nodo normal. Como resultado, tienen que agregar una nueva herramienta HTTP, configurar las credenciales nuevamente, y probablemente perderán el campo «Send Headers».
Propongo algunas formas en que podríamos reducir este problema:
(1) Unificar el material de las dos secciones para guiar qué par clave-valor va dentro de las credenciales y cuál va dentro de Send Headers.
(2) En la Sección 3, podríamos indicarles explícitamente nuevamente cómo configurar las credenciales, tal como lo hicimos en la Sección 2. Esto sería un copiar-pegar único, requiriendo cambios solo en la Sección 3. También noté este patrón en el curso Foundation, así que podríamos seguir ese enfoque.
(3) Poco probable, pero podríamos indicar a los estudiantes que usen Multiple Header Auth (Autenticación de múltiples encabezados). Esta es mi preferencia ya que los estudiantes pueden ver y gestionar claramente dos encabezados como uno, en lugar de requerir su carga cognitiva para descubrir que Credential Header Auth y Send Headers se combinarán, lo cual solo es correcto si el método de autenticación usa Header. Y también evita la necesidad de que los estudiantes copien y peguen nodos HTTP para reutilizar, lo que originalmente se pretendía para evitar que los estudiantes perdieran los campos Send Header, y esto podría fallar como mencioné en el caso donde un estudiante no puede copiar un nodo HTTP a la herramienta de agente HTTP. Pero esta solución necesitará cambiar y auditar mucho del material, así que no creo que valga la pena.
