Importante

Você está vendo a versão anterior da nova experiência da Alura que estamos preparando para você. Em breve, ela ganha uma identidade visual novinha totalmente pensada em potencializar seus estudos!

1
resposta

[Dúvida] Sobre o challenge com N8N

Olá, tenho algumas dúvidas quanto ao N8N no challenge. Como posso documentar os commits no github, outra coisa quais seriam esses códigos que devem ser salvos quanto a resolução do desafio visto que N8N não necessariamente precisa de códigos, tem como dar uma ajuda em resolver o challenge usando o N8N para fazer o agente ?

1 resposta

Ei, Lucas! Tudo bem? Espero que sim.

O challenge com n8n, GitHub e a documentação dos commits, a ideia é registrar não apenas códigos, mas também a evolução da solução desenvolvida durante o desafio.

Como o n8n trabalha com fluxos visuais, é comum que boa parte da lógica esteja armazenada em arquivos de workflow no formato JSON. Esses arquivos representam a automação criada e são os principais artefatos que devem ser versionados no repositório.

Uma boa organização pode ser:

  • Salvar o workflow exportado do n8n (arquivo .json).
  • Adicionar um README.md explicando o objetivo da automação, como executá-la e quais serviços externos foram utilizados.
  • Caso tenha utilizado funções como Code Node, scripts auxiliares ou arquivos de configuração, eles também devem fazer parte do repositório.

Os commits devem descrever cada etapa da evolução do projeto. Alguns exemplos para descrevê-los:

cria workflow inicial do agente
adiciona integracao com modelo de IA
configura tratamento de erros
ajusta fluxo de respostas do agente

Quando houver algum trecho em um Code Node, ele pode ser versionado normalmente. Veja este exemplo:


const mensagem = "Ola, mundo!";
return [{ json: { mensagem } }];

Esse código cria um objeto contendo uma mensagem e o retorna para a próxima etapa do fluxo no n8n.

Lucas, mesmo quando não há muito código escrito manualmente, o histórico do projeto continua sendo importante. O objetivo é mostrar a evolução da automação, das configurações e das decisões tomadas durante o desenvolvimento, ta bom?!

Conteúdos para complementar seus estudos
Esse conteúdo pode estar em inglês, para traduzi-lo utilize o tradutor automático do navegador ou clique com o botão direito do mouse sobre a página e selecione a opção Traduzir para o português.

Espero ter ajudado e conte sempre conosco por aqui.

Alura Conte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!