Ir para o conteúdo
Promovaweb

Troque os Nodes de IA removidos no n8n 3.0

Revisado em

Antes de começar

Substituir cada Node de IA removido pelo Node atual indicado pelo n8n ou, quando não houver substituto direto, por uma alternativa suportada.

  • Lista de workflows afetados no relatório de migração.
  • Instância de testes com cópia da sua instância.
  • Credenciais dos provedores de modelo e de vector store usadas pelos workflows.

O n8n 3.0 remove um grupo grande de Nodes de IA que tinham ganhado versões novas. Workflows que usam um deles falham na execução. Um workflow publicado com um desses Nodes não é ativado quando a instância inicia. A maior parte tem substituto direto, mas alguns saem sem troca e exigem outra solução.

Modelos, assistentes e ferramentas

Node removido Substituto
OpenAI antigo OpenAI, da seção de IA. Esse Node continua
OpenAI Assistant OpenAI, com o recurso Assistant
OpenAI Model OpenAI Chat Model
HTTP Request Tool antigo HTTP Request ligado ao conector Tool do AI Agent
SerpApi (Google Search) Sem substituto direto. Chame a API REST da SerpApi pelo HTTP Request ligado como ferramenta ou use um community Node verificado

Chat e memória

Node removido Substituto
Manual Chat Trigger Chat Trigger
Chat Messages Retriever Chat Memory Manager ou a opção de carregar sessões anteriores no Chat Trigger
Memórias Motorhead e Zep Sem substituto direto. Use outro Node de memória suportado

Documentos e vector stores

Node removido Substituto
Binary Input Loader, JSON Input Loader e GitHub Document Loader Default Data Loader. Para conteúdo do GitHub, busque os arquivos antes com o Node GitHub
In Memory Vector Store Insert e In Memory Vector Store Load Simple Vector Store
Pinecone: Insert e Pinecone: Load Pinecone Vector Store
Supabase: Insert e Supabase: Load Supabase Vector Store
Zep Vector Store, Zep Vector Store: Insert e Zep Vector Store: Load Sem substituto direto. Use outro Node de vector store suportado

Nos Nodes de vector store atuais, a inserção e a leitura ficam no mesmo Node. Escolha dentro dele o que o Node faz: Insert Documents, Get Many ou Retrieve Documents.

Código gerado por IA

Node removido Substituto
AI Transform Code, pela migração do relatório
LangChain Code Sem substituto direto

O AI Transform não pode mais ser adicionado nem executado. O relatório de migração converte cada um em um Code node com o JavaScript que ele já tinha gerado. O workflow continua rodando o mesmo código. A atualização da instância não faz essa conversão. Um AI Transform que nunca gerou código não tem o que migrar e precisa ser trocado à mão por um Code node.

Procedimento

  1. No relatório de migração, abra o item dos Nodes removidos e anote os workflows de IA da lista. Os workflows com AI Transform também aparecem no relatório.
  2. No ambiente de testes, execute cada workflow e guarde a saída: a resposta do modelo, os documentos recuperados ou os registros gravados no vector store.
  3. Troque o Node removido pelo substituto da tabela, com a mesma credencial e a mesma configuração.
  4. Nos vector stores, escolha o que o Node antigo fazia. Um Pinecone: Insert vira Pinecone Vector Store em Insert Documents. Um Pinecone: Load vira o mesmo Node em Get Many ou Retrieve Documents.
  5. Para o AI Transform, selecione Migrate no relatório, revise a nova versão do workflow e só depois publique.
  6. Execute com a mesma entrada e compare com a saída guardada.

Quando não existe substituto direto

As memórias Motorhead e Zep e o Zep Vector Store guardam o conteúdo em serviços externos. Antes de trocar o Node, exporte desse serviço o que você precisa manter e grave de novo no Node de memória ou de vector store escolhido. Sem essa etapa, o agente começa a conversa ou a busca sem o histórico anterior.

O LangChain Code executava código LangChain dentro do workflow. Reescreva a lógica com os Nodes de IA atuais ou com um Code node, conforme o que o código fazia.

Confira o resultado

Cada workflow de IA roda na instância de testes sem Node removido e entrega a mesma resposta, os mesmos documentos recuperados ou os mesmos registros gravados que antes.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.