Importar um workflow do n8n — um agente de IA que responde a mensagens de chat
Um workflow do n8n — um gatilho de chat, um AI Agent, um OpenAI Chat Model e uma Simple Memory — importado por aggrega import em um Aggregate, uma Release e um Manifest que são compilados para Docker Compose do jeito que foram escritos.
Importar um workflow do n8n percorre o processo passo a passo: o comando, os arquivos que ele escreve, o build e uma execução do que ele compila. Esta pasta contém cada etapa desse passo a passo:
| pasta | o que contém |
|---|---|
source/ | o workflow, support-agent.json; o .aggrega-config.yaml que torna a pasta um espaço de trabalho; e import-answers.yaml, a resposta ao que nenhum workflow pode conter, que uma importação para Kubernetes solicita |
draft/ | os arquivos que aggrega import support-agent.json --target compose escreveu, sem alterações, e o que ele imprimiu: stdout.txt na saída padrão, import.txt na saída de erro padrão |
source/support-agent.json foi escrito para este exemplo, no formato em que o n8n exporta um workflow.
Em um checkout do repositório da documentação, check.sh executa a importação novamente, compara o que ela escreve e imprime com draft/, compara os blocos que o passo a passo cita com estes arquivos, e valida e compila o que a importação escreveu. Ele precisa do catálogo da biblioteca padrão (onde obter um) em um checkout ao lado deste repositório, ou do diretório dele indicado em AGGREGA_CATALOG_DIRS.
Gerar o exemplo
Você pode executar a importação deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que a execute para você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example import-n8nEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd import-n8nBuild
A importação cria os rascunhos dos arquivos Aggrega ao lado do projeto, em source/, e obtém o que o build precisa. Ela avalia o projeto em relação ao catálogo da biblioteca padrão, que o registry padrão do espaço de trabalho publica como um snapshot assinado: a primeira importação o obtém, o verifica, o mantém no cache de conteúdo do espaço de trabalho e o nomeia pelo seu digest no registro que grava ao lado dos rascunhos. Um espaço de trabalho que nomeia suas próprias pastas de catálogo — em AGGREGA_CATALOG_DIRS ou em workspace.catalog_dirs — importa com base nelas em vez disso:
cd sourceaggrega import support-agent.json --target composeaggrega validate --release release.yamlaggrega build --release release.yamlComo executar o que o build escreve está no passo a passo indicado acima.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace ainda não contiver uma pasta `import-n8n`, chame a ferramenta `scaffold` uma vez com `example` definido como `import-n8n` e sem `dir`: ela grava o exemplo em uma nova pasta `import-n8n`, cuja pasta `source` contém o que este exemplo importa. Depois chame a ferramenta `import` com `workspace_root` definido como `import-n8n/source`, `source` definido como `support-agent.json` e `target` definido como `compose`: ela lê as respostas de que precisa em `import-answers.yaml`, ao lado de `support-agent.json`, grava seus rascunhos em `import-n8n/source` e baixa o que eles precisam. Depois chame a ferramenta `validate` com `workspace_root` definido como `import-n8n/source` e `release` definido como `release.yaml`, e a ferramenta `build` com `workspace_root` definido como `import-n8n/source`, `release` definido como `release.yaml` e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `import-n8n/source/dist/`.Teste
Com o stack em execução tal como o passo a passo o executa — as credenciais armazenadas e o workflow ativo —, abra http://127.0.0.1:5678 para o editor do n8n e envie ao gatilho de chat uma mensagem com o usuário e a senha que ele armazena, lidos de CHAT_USER e CHAT_PASSWORD na entrada padrão do curl:
printf 'user = "%s:%s"\n' "$CHAT_USER" "$CHAT_PASSWORD" | curl --config - -sS -i -X POST \ http://127.0.0.1:5678/webhook/a3c9e1f2-4b5d-4e6f-8a7b-9c0d1e2f3a04/chat -H 'Content-Type: application/json' \ -d '{"action": "sendMessage", "sessionId": "s1", "chatInput": "In one short sentence: what does a support plan cover?"}'HTTP/1.1 500 Internal Server Error[… omitted: the response's other headers]
{"message":"Error in workflow"}A execução armazenou um valor provisório para a chave da OpenAI, então o workflow parou na chamada ao modelo, e sua execução no editor mostra a recusa da OpenAI: Incorrect API key provided: sk-place*****************-key.
Importado com --target helm e aplicado ao Kubernetes, o n8n aceita a mesma mensagem no mesmo endereço assim que as credenciais são armazenadas e o workflow é ativado na instância em execução, como o passo a passo mostra, e uma porta local é encaminhada para o seu Service; a execução obteve ali a mesma resposta:
kubectl port-forward -n <namespace> svc/n8n-default 5678:5678