OpenAI Agent Builder será desativado em 30 de novembro de 2026: como levar seus workflows para o n8n

A OpenAI vai desativar o Agent Builder em 30 de novembro de 2026. A descontinuação foi anunciada em 3 de junho de 2026, junto com o Evals e os objetos de prompt reutilizáveis. Os três param no mesmo dia (descontinuações da OpenAI). As evals existentes passam a ser somente leitura em 31 de outubro de 2026.

Este guia mostra o que para de funcionar, o que salvar antes dos prazos e como reconstruir cada workflow do Agent Builder no n8n, nó por nó.

O que para e o que continua funcionando

Parte	O que acontece
Agent Builder (o editor visual)	Desativado em 30 de novembro de 2026. Até lá, os usuários atuais "podem continuar usando durante o período de transição"
IDs de workflows publicados (wf_…)	Um ID de workflow só roda por sessões hospedadas do ChatKit (POST /v1/chatkit/sessions). A OpenAI documenta esse caminho só para o período de transição, então conte com que esses embeds parem de responder
Evals	Somente leitura a partir de 31 de outubro de 2026; o painel e a API são desativados em 30 de novembro. A OpenAI indica o Promptfoo
Prompts reutilizáveis (v1/prompts)	Desativados em 30 de novembro de 2026. Leve o texto do prompt para o seu próprio código (guia)
ChatKit	Continua disponível, mas o servidor fica por sua conta (ChatKit personalizado)
Agents SDK, Responses API, vector stores	Não são afetados

A OpenAI não divulga uma data de exclusão para as definições de workflows, as versões ou as threads hospedadas do ChatKit. Exporte o que você precisa antes de 30 de novembro.

Suas três opções

O guia de migração da OpenAI cita dois caminhos. O n8n é o terceiro, se você quiser continuar com um editor visual.

• Agents SDK (Python ou TypeScript). O diálogo Code exporta um workflow como código do SDK. Bom se você não se importa em manter e hospedar código.
• ChatGPT Workspace Agents. Exige um workspace do ChatGPT Business, Enterprise ou Edu. Estão em research preview, e o trigger por API ainda não consegue devolver a resposta do agente (documentação).
• n8n. Um editor visual de workflows como o Agent Builder, com nó AI Agent, modelos da OpenAI e ferramentas nativas, MCP, guardrails, aprovação humana, triggers e centenas de integrações com apps. Roda no n8n Cloud ou no seu próprio servidor.

Passo 1: salve tudo antes dos prazos

1. Exporte o código de cada workflow. Abra o workflow → Code → Agents SDK → TypeScript ou Python, e copie a exportação inteira. É o registro mais completo de instruções, modelos, ferramentas e schemas de saída que você vai conseguir.
2. Tire prints do canvas. A exportação não contém o grafo, e a OpenAI diz que não "garante que todo comportamento seja transferido sem alterações".
3. Copie os datasets e graders das evals antes de 31 de outubro. Depois disso eles ficam somente leitura, e somem em 30 de novembro.
4. Exporte as threads do ChatKit que quiser manter com GET /v1/chatkit/threads e /threads/{id}/items (referência).
5. Copie o texto dos prompts reutilizáveis que os seus apps carregam por ID.

Verifique dois problemas conhecidos na exportação. A aprovação humana sai como um stub que sempre retorna true, e o corpo das function tools sai como // TODO: Unimplemented. Um relato no fórum também descreve exportações que falham em workflows com a ferramenta de busca na web. Exporte cedo para ter tempo de tentar de novo.

Passo 2: relacione cada nó ao n8n

O Agent Builder tem estes tipos de nó (referência de nós):

Nó do Agent Builder	Equivalente no n8n	Observações
Start	Chat Trigger para chat, Webhook para chamadas de API, When Executed by Another Workflow para subfluxos	input_as_text vira chatInput. As variáveis de estado do Start → um nó Edit Fields logo depois do trigger
Agent	AI Agent + OpenAI Chat Model (Use Responses API ativado). Para uma única chamada sem loop de agente: nó OpenAI → Generate a Model Response	Saída JSON → Structured Output Parser (sem $ref). A saída de widgets não tem equivalente
End	Respond to Webhook, a ação Send Message do nó Chat, ou a saída do último nó	Monte o JSON final antes com Edit Fields
Note	Sticky Note	Markdown
File search	Ferramenta nativa File Search com os seus Vector Store IDs	O Max Results tem padrão 1; aumente. Ou passe para um nó de Pinecone, Supabase, Qdrant ou PGVector depois de reprocessar os documentos
Guardrails	Nó Guardrails: Check Text for Violations ou Sanitize Text	Os presets são adaptados dos guardrails open source da OpenAI. Não há verificação de alucinação; a moderação é a operação Classify Text for Violations do nó OpenAI
MCP	MCP Client Tool em um agente, ou MCP Client como etapa	HTTP Streamable ou SSE; autenticação Bearer, por header ou OAuth2
If/else	If, Switch, ou Text Classifier para roteamento por LLM	Reescreva cada expressão CEL em JavaScript
While	Uma conexão de volta para um nó anterior mais um If de controle; Loop Over Items para lotes	Adicione um contador para evitar loops infinitos
Human approval	Send and Wait for Response do nó Chat, ou Send and Wait no Slack, Telegram, Teams, Gmail e outros, ou o nó Wait	A revisão humana por ferramenta nas tools do AI Agent existe desde o n8n 2.6
Transform	Edit Fields (Set) ou Code	No n8n Cloud, o nó Code não consegue importar módulos npm, exceto crypto e moment
Set state	Edit Fields, lido depois com $('Node').item.json; Data tables ou memória para manter dados entre execuções	Não existe um objeto de estado global mutável

O lado do n8n foi conferido com a documentação do n8n para o n8n 2.x. O n8n também tem o n8n Agents em preview, conceitualmente próximo do Agent Builder (documentação). Este guia usa o nó AI Agent estável.

Passo 3: reconstrua um agente no n8n

1. Trigger. Adicione um Chat Trigger para um agente de chat, ou um Webhook para uma API.
2. Agente. Adicione um nó AI Agent e cole as instruções do nó Agent em System Message. Conecte um subnó OpenAI Chat Model com o modelo que você usava e ative Use Responses API.
3. Ferramentas nativas. No OpenAI Chat Model, ative Web Search, File Search (cole os IDs dos vector stores como um array JSON) ou Code Interpreter, conforme a necessidade.
4. Servidores MCP. Adicione um MCP Client Tool por servidor, com a mesma URL, autenticação e ferramentas permitidas.
5. Saída JSON. Ative Require Specific Output Format e conecte um Structured Output Parser com o schema da exportação (coloque inline qualquer $ref).
6. Lógica. Reconstrua If/else, While e as aprovações com os nós da tabela. Cada {{input.output_text}}, {{state.x}} e expressão CEL vira uma expressão do n8n, como {{ $json.output }} ou {{ $('Agent').item.json.output }}.
7. Memória. Para chat com vários turnos, conecte um subnó de memória. O Simple Memory não funciona em queue mode; nesse caso, use Postgres ou Redis Chat Memory.
8. Function tools. Implemente cada ferramenta que a exportação deixou como stub. No n8n, uma ferramenta pode ser outro workflow (Call n8n Workflow Tool) ou uma requisição HTTP.

Passo 4: substitua o front-end do ChatKit

O n8n não tem um trigger de ChatKit. Há dois caminhos:

• Use o chat do n8n. Use a página de chat hospedada do Chat Trigger, ou incorpore o widget @n8n/chat apontando para a URL de produção dele, e adicione o seu domínio em Allowed Origins (CORS). O widget suporta streaming, envio de arquivos e carregamento da sessão anterior.
• Mantenha a interface do ChatKit. Rode o seu próprio servidor do ChatKit (ChatKit personalizado) com um handler de respostas que chama o seu webhook do n8n. Nesse caso, você mesmo armazena as threads.

Nos dois casos, as partes hospedadas pela OpenAI deixam de existir: threads hospedadas, widgets e o fluxo de sessão com client secret.

Armadilhas para verificar antes de trocar

• Snapshots de modelos sendo aposentados. gpt-5 aponta para gpt-5-2025-08-07, que será desativado em 11 de dezembro de 2026. As configurações de guardrails costumam fixar gpt-4.1-mini, cujo snapshot será desativado em 14 de janeiro de 2027 (descontinuações da OpenAI). Escolha modelos atuais ao reconstruir. Todas as datas de modelos e APIs da OpenAI estão no nosso rastreador de desativações (em inglês).
• Não existe esforço de raciocínio "minimal". O OpenAI Chat Model do n8n oferece Low, Medium e High.
• Não use objetos de prompt nem Assistants. Deixe vazia a opção Prompt do Chat Model, porque o v1/prompts acaba em 30 de novembro. Evite qualquer caminho pelo OpenAI Assistant: essa API foi desativada em 26 de agosto de 2026.
• Os conectores hospedados pela OpenAI (Gmail, Drive, SharePoint via connector_id) não têm equivalente no n8n. Use os nós de apps do próprio n8n ou um servidor MCP.
• Aprovações no chat. Os botões de aprovação do nó Chat não funcionam quando o Chat Trigger está incorporado (embed) ou dentro de um subworkflow.
• Execuções. Cada mensagem do chat executa o workflow uma vez, e isso conta para as execuções do seu plano do n8n.
• Evals. As Evaluations do n8n trabalham com datasets, não com avaliação de traces. A avaliação baseada em métricas depende do seu plano do n8n.

Checklist

• Exporte o código do Agents SDK de cada workflow e tire um print de cada canvas.
• Copie os datasets e graders das evals antes de 31 de outubro de 2026.
• Exporte as threads do ChatKit e os textos dos prompts de que você precisa.
• Reconstrua cada workflow no n8n usando a tabela de nós e implemente os stubs de aprovação e de function tools.
• Reescreva os templates CEL e {{ }} como expressões do n8n.
• Substitua ou hospede de novo o front-end do ChatKit.
• Teste com conversas reais e depois mude o tráfego antes de 30 de novembro de 2026.

Também está saindo do Pipedream? O Pipedream Workflows para de funcionar em 31 de março de 2027. Veja o guia para migrar do Pipedream para o n8n e o relatório de migração gratuito. Outras plataformas de automação, IA e desenvolvimento que fecham em 2026 e 2027 estão no rastreador de desativações (em inglês), que você pode adicionar à sua agenda.