Olá equipe n8n academy,
Recentemente vi dois posts que levantaram problemas da QS101: Quickstart’s Section 3:
Depois de resolver o problema, percebi que ele vem da perda de contexto quando os alunos se movem entre a Seção 2 e a Seção 3 do curso, e de informações faltantes nas instruções da Seção 3.
A causa raiz é que esses nós HTTP requerem dois headers HTTP (x-assessment-id e X-API-KEY). Na Seção 2, o curso guia os usuários a adicionar o x-assessment-id via “Send Headers” e adicionar o X-API-KEY via credenciais.
Porém, na Seção 3, as instruções dizem para reutilizar as credenciais da Seção 2 ou adicionar o x-assessment-id nas credenciais (o que é oposto à instrução da Seção 2), e não mencionam o X-API-KEY em lugar nenhum.
Um aluno releu e sobrescreveu suas credenciais atuais de X-API-KEY para x-assessment-id, o que também fez com que sua Seção 2 funcionando falhasse, e ele não tem ideia de como corrigir.
Com relação à reutilização de credenciais, os alunos não podem simplesmente copiar e colar o nó porque a Seção 3 usa o HTTP Request como uma ferramenta de agente e não como um nó normal. Como resultado, eles precisam adicionar uma nova ferramenta HTTP, configurar as credenciais novamente e provavelmente não perceberão o campo “Send Headers”.
Proponho algumas formas de reduzir esse problema:
(1) Unificar o material das duas seções para orientar qual chave-valor vai dentro das credenciais e qual vai dentro do Send Headers.
(2) Na Seção 3, poderíamos explicitamente instruir novamente como configurar credenciais, assim como fizemos na Seção 2. Isso seria um copia-cola único, exigindo mudanças apenas na Seção 3. Também percebi esse padrão no curso Foundation, então poderíamos seguir essa abordagem.
(3) Improvável, mas poderíamos instruir os alunos a usar Multiple Header Auth. Essa é minha preferência, pois os alunos podem ver e gerenciar claramente dois headers como um, em vez de exigir sua carga cognitiva para descobrir que Credential Header Auth e Send Headers serão combinados, o que só funciona se o método de autenticação usar Header. E também evita a necessidade de alunos copiarem e colarem nós HTTP para reutilizar, o que foi originalmente destinado a evitar que alunos perdessem os campos Send Header, e isso pode quebrar como mencionei no caso em que um aluno não consegue copiar um nó HTTP para a ferramenta HTTP do agente. Mas essa solução precisará mudar e auditar muito do material, então acho que não vale a pena.
