Variáveis de ambiente: IA, agentes e MCP

Chave de API do Daytona, usada pelos sandboxes de agentes e do n8n Assistant.

URL da API do Daytona, como http://localhost:3000/api.

Chave da API do Brave Search para busca na web pelo n8n Assistant. Sem chave, a busca e o agente de pesquisa ficam desligados.

Liga as operações de base de conhecimento dos agentes dentro de um sandbox.

Apaga o sandbox de conhecimento dos agentes assim que ele fica ocioso.

Imagem Docker do sandbox Daytona usado pelos agentes.

Nome do snapshot Daytona dos sandboxes de conhecimento dos agentes. Sem o snapshot, o n8n usa a imagem, exceto quando o acesso ao Daytona passa pelo proxy de IA do n8n, que só aceita snapshots.

Tempo limite em milissegundos de cada comando no sandbox dos agentes.

Liga tarefas duráveis em segundo plano para agentes, como sub-agentes que continuam depois do turno do agente principal. Defina o mesmo valor nos processos principais e nos workers.

Intervalo em segundos para cada processo principal conferir se os canais dos agentes publicados estão rodando e reiniciar os parados. Com 0, a conferência fica desligada.

Validade em segundos dos checkpoints de execução dos agentes. Checkpoints mais antigos são apagados. O padrão equivale a 4 dias.

Submódulos de agentes ligados, separados por vírgula. Cada item libera um recurso específico do módulo de agentes.

Liga as ferramentas de planejamento dos agentes. O código não traz descrição oficial.

Na 2.x, guardava as skills dos agentes num hub central, fora da definição de cada agente. Removida na 3.x.

Gera spans de OpenTelemetry das execuções de agentes, com o endpoint e as opções das variáveis N8N_OTEL_*. Sem OpenTelemetry ligado, os spans não vão a lugar nenhum.

Grava nos traces as entradas dos agentes, como prompts e argumentos de ferramentas. Defina false para deixar informações sensíveis fora dos traces.

Grava nos traces as saídas dos agentes, como respostas e resultados de ferramentas. Defina false para deixar informações sensíveis fora dos traces.

Só para testes. Aceita um token de acesso temporário da Meta na configuração do WhatsApp dos agentes. O canal para quando o token expira, cerca de um dia depois.

Força a ativação das avaliações de agentes, independentemente do experimento interno do n8n.

Duração máxima em minutos de cada execução da avaliação de agentes. Atingido o limite, nenhum caso novo começa. Valor zero ou negativo desliga o limite.

Tamanho máximo em bytes de cada arquivo, como imagem ou PDF, que o AI Agent repassa ao modelo. Arquivos maiores são recusados antes do envio. O padrão equivale a 50 MB.

Permite enviar aos provedores de IA os valores dos parâmetros dos workflows e Nodes. Com false, vão só a estrutura e marcadores.

Na 2.x e na 3.x, o n8n avisa que a variável será removida na 4.x. Enquanto estiver false, o n8n Assistant não cria nem edita workflows.

Chave de API da Anthropic usada pelo construtor de workflows com IA.

Endereço do serviço do assistente de IA, no lugar do endpoint padrão.

Liga os recursos de IA da instância, como o assistente.

Liga o n8n Connect, o gateway de IA do n8n, em instâncias licenciadas. Com false, a instância deixa de usar o gateway. O orçamento vem da licença.

Tempo máximo em milissegundos sem resposta até o primeiro trecho do modelo num agente. É maior que o limite de ociosidade porque prompts grandes podem levar minutos até a primeira resposta.

Tempo máximo em milissegundos sem novos trechos do modelo depois que a resposta começou. Passado o prazo, o turno falha. Aumente quando um proxy na frente do modelo acumula a resposta.

Tempo máximo em milissegundos de espera pela resposta HTTP de um serviço de IA. O padrão de uma hora acompanha o limite máximo de execução.

Validade em segundos do estado de execução no Chat Hub, a duração máxima de uma execução de agente sem streaming. Depois do prazo, a resposta não chega mais ao chat.

Quantidade máxima de trechos de resposta guardados por stream no Chat Hub para retomar após reconexão.

Validade em segundos do estado de cada stream no Chat Hub. Streams inativos são limpos depois do prazo.

Força a ativação das avaliações por configuração, com o painel de testes no editor, independentemente do experimento interno.

Desliga o chat público do Chat Trigger na instância.

Força a ativação das coleções de avaliação, com comparação entre versões e análise por IA, independentemente do experimento interno.

Mostra a oferta de testar o agente em qualquer configuração, sem conferir modelo, ferramentas e skills. Útil em desenvolvimento e QA.

Novo na 3.x. Roda o n8n Assistant também no runtime de agentes. Prévia experimental para desenvolvimento e avaliação, imprópria para produção.

Permite que o n8n Assistant use o navegador. O código não traz descrição oficial.

Tempo em milissegundos que os sandboxes do construtor de workflows ficam prontos para correções depois de concluídos. Com 0, ficam desligados.

Tempo em milissegundos até apagar de vez os checkpoints expirados do n8n Assistant. Precisa ser maior que N8N_INSTANCE_AI_SNAPSHOT_RETENTION. Com 0, não apaga.

Tempo limite em milissegundos dos pedidos de confirmação humana do n8n Assistant. Com 0, não há limite.

Antecedência em milissegundos para renovar o token do proxy Daytona antes de expirar. Só vale no modo proxy.

Use só numa instância descartável de avaliação do n8n Assistant. Liga as rotas de avaliação e permite limpar o histórico do Remove Duplicates entre cenários.

Força a navegação por pastas no n8n Assistant, independentemente do experimento interno. Com false, vale o experimento.

Na 2.x, chave fixa do gateway local de arquivos do n8n Assistant. Removida na 3.x.

Na 2.x, desligava para todos os usuários o gateway local do n8n Assistant, com acesso a arquivos, shell e navegador. Removida na 3.x.

Quantidade máxima de execuções do orquestrador do n8n Assistant ao mesmo tempo neste processo. Pedidos acima do limite recebem HTTP 429. Retomadas continuam aceitas. Com -1, não há limite.

Quantidade máxima de execuções do n8n Assistant ao mesmo tempo por usuário, somando todas as conversas. Ajuda a conter o consumo de créditos. Com -1, não há limite.

Quantidade máxima de sub-agentes em segundo plano rodando ao mesmo tempo neste processo, somando todas as conversas. Com -1, não há limite.

Servidores MCP disponíveis ao n8n Assistant, no formato nome=url separados por vírgula, como github=https://mcp.github.com/sse.

Modelo das tarefas que resumem as conversas do n8n Assistant na memória, no formato provedor/modelo, como anthropic/claude-haiku-4-5.

Roda o Observer no meio do turno, entre chamadas de ferramenta. Desligado, roda só no fim do turno, o que aproveita melhor o cache de prompt do provedor.

Modelo do n8n Assistant no formato provedor/modelo, ou só o nome do modelo para um endpoint próprio.

Chave de API do endpoint próprio de modelo. Alguns servidores locais dispensam a chave.

URL base de um endpoint compatível com a API da OpenAI, como http://localhost:1234/v1 no LM Studio.

Força o envio dos Nodes selecionados no canvas para o chat do n8n Assistant. Com false, vale o experimento interno.

Força a consulta de uso de Nodes pelo n8n Assistant, incluindo o filtro por tipo de Node na listagem de workflows. Com false, vale o experimento interno.

Quantidade de tokens no histórico a partir da qual o Observer compacta as mensagens.

Fixa todas as execuções do n8n Assistant numa versão publicada de prompt, como concise@1. Vazio, vale o experimento interno.

Intervalo em milissegundos entre as limpezas agendadas do n8n Assistant. Com 0, ficam desligadas.

Quantidade de tokens nas observações a partir da qual o Reflector condensa o conteúdo.

Grava os passos do modelo e cópias do código dos workflows para o painel de depuração de desenvolvimento.

Minutos que um sandbox Daytona parado espera antes de ir para o armazenamento frio. Com 0, vale o intervalo máximo do Daytona.

Minutos que um sandbox Daytona parado espera antes de ser apagado. O padrão equivale a 7 dias. Valor negativo desliga a exclusão. Com 0, apaga ao parar.

Minutos que um sandbox Daytona ocioso espera antes de parar. Com 0, o sandbox continua rodando.

Liga o sandbox de execução de código do n8n Assistant, que passa a rodar comandos de shell e código.

Cria sandboxes descartáveis, apagados assim que ficam ociosos. Pensado para instâncias de avaliação.

Imagem Docker do sandbox Daytona do n8n Assistant.

Prefixo acrescentado ao nome de cada sandbox Daytona do n8n Assistant.

Provedor do sandbox: n8n-sandbox, o serviço do próprio n8n, ou daytona.

Nome completo do snapshot Daytona usado para criar os sandboxes. Sem valor, o n8n usa o snapshot da versão em execução. Só vale no modo proxy.

Tempo limite em milissegundos de cada comando no sandbox do n8n Assistant.

URL de uma instância SearXNG para busca na web pelo n8n Assistant, como http://searxng:8080. Dispensa chave. Vazio, a busca fica desligada.

Tempo em milissegundos que os checkpoints antigos do n8n Assistant ficam guardados antes da limpeza.

Liga o raciocínio estendido do agente orquestrador do n8n Assistant.

Validade em dias das conversas do n8n Assistant. Com 0, as conversas não expiram.

Região do Vertex AI para os modelos google-vertex-anthropic/*, como global ou us-east5.

Projeto do Google Cloud para os modelos google-vertex-anthropic/*.

JSON da service account para os modelos google-vertex-anthropic/*. Sem valor, o n8n usa as credenciais padrão do gcloud.

Liga as sugestões de workflow, a investigação automática de falhas e a revisão de resultados pelo n8n Assistant.

Liga o acesso MCP à instância, que permite a clientes como Claude Code e Codex usar o n8n como servidor MCP.

Força a ativação dos MCP Apps, a interface em iframe anexada às ferramentas MCP. Com false, o n8n volta a decidir pelo experimento interno, sem desligar o recurso.

URL pública do servidor MCP da instância quando ela usa um hostname próprio, diferente do editor, como https://n8n-mcp.exemplo.com. Com o valor definido, os clientes MCP passam a usar esse endereço.

Liga no servidor MCP as ferramentas que criam e editam workflows.

Quantidade máxima de clientes MCP guardados em cache de sessão. Acima do limite, os mais antigos saem.

Tempo em milissegundos que um cliente MCP fica aberto depois do último uso. Manter o cliente aberto faz todas as chamadas de ferramenta de uma execução usarem a mesma sessão MCP.

Permite que as ferramentas MCP de construção de workflows ofereçam community nodes verificados não instalados e os instalem quando pedido.

Faz as variáveis de ambiente definirem a configuração de acesso MCP a cada inicialização.

Quantidade máxima de clientes OAuth registrados para o MCP. O padrão subiu de 200 na 1.x para 5000 na 2.x.

Máximo de requisições por IP a cada 5 minutos no endpoint do servidor MCP (/mcp-server/http). Com 0, o limite por IP fica desligado.

Tempo em milissegundos que uma sessão MCP pode ficar ociosa antes de ser encerrada. O padrão caiu de uma hora na 1.x para 15 minutos na 2.x.

Intervalo em milissegundos entre as varreduras que encerram sessões MCP ociosas.

Chave de API do serviço de sandbox do n8n.

URL base do serviço de sandbox do n8n.