n8n Agents
Modelos e ferramentas configuráveis.
O n8n Agents transforma o agente em um objeto independente, ao lado dos fluxos de trabalho: a equipe configura uma vez e pode usar o mesmo agente em canais de chat, tarefas agendadas e outros fluxos. Ele processa solicitações com suas próprias instruções, ferramentas e memória, e o modelo decide o próximo passo com base na tarefa e nos resultados já obtidos.
Essa mudança trata da construção de soluções para tarefas abertas. A sincronização fixa de dados continua adequada a um fluxo de trabalho; tarefas que exigem ler materiais, pedir esclarecimentos e então decidir qual sistema consultar podem ser delegadas a um Agent. As duas abordagens podem ser combinadas, sem entregar todos os processos ao modelo nem desenhar antecipadamente cada ramificação possível de uma conversa.
Da montagem de componentes a um agente gerenciado de forma independente
Já era possível criar agentes no n8n: bastava conectar um gatilho de chat, um nó AI Agent, memória e ferramentas dentro de um fluxo. Os novos Agents reúnem conversas, memória, canais, versões e aprovações no mesmo objeto, reduzindo esse trabalho de montagem. O nó AI Agent existente permanece como está, de modo que os fluxos já construídos não precisam ser migrados por causa dessa mudança.
No Agent Builder, cada configuração tem uma função distinta:
- Modelo e instruções: permitem escolher um modelo disponível e definir o papel, o tom, o escopo de trabalho e as ferramentas prioritárias. O modelo pode usar credenciais próprias do fornecedor ou os Gateway credits disponíveis.
- Ferramentas: oferecem capacidade de ação real, como consultar sistemas de negócio, gravar registros ou executar fluxos existentes. Instruções em texto, sem as ferramentas correspondentes, não permitem realizar essas operações nos sistemas.
- Skills: armazenam instruções de tarefas e materiais de referência reutilizáveis, carregados conforme a necessidade, e podem ser usadas por vários agentes.
- Conhecimento: fornece materiais que podem ser consultados ao responder. Aceita arquivos CSV, PDF, Markdown e TXT e também pode ser combinado com armazenamentos vetoriais. O anúncio de lançamento indica explicitamente o n8n Cloud como o ambiente em que o upload de arquivos está disponível.
- Memória e conversas: o contexto da conversa atual é mantido por padrão, e também há suporte à memória entre conversas. As conversas são salvas e podem ser revistas e retomadas; isso tem uma finalidade diferente da de carregar uma coleção de arquivos de referência de longo prazo.
- Subagentes: um Agent pode chamar outro Agent e delegar uma tarefa a outro agente já configurado.
Essas configurações influenciam em conjunto a execução de uma solicitação. Depois de receber uma mensagem, o Agent pode chamar ferramentas, buscar informações, delegar tarefas ou fazer perguntas adicionais, continuando o trabalho com as informações obtidas até fornecer uma resposta. Ele não se limita a enviar a entrada ao modelo para gerar um texto.
A conexão das ferramentas define o alcance das ações
Um Agent tem três caminhos principais para conectar-se aos sistemas de negócio. A diferença está em quantos detalhes operacionais são definidos antecipadamente.
Os servidores MCP são adequados para incorporar um conjunto de capacidades de uma só vez. Depois de conectar um serviço, o Agent pode escolher ações entre as ferramentas expostas; as desnecessárias podem ser excluídas. A documentação de configuração de MCP do n8n também permite selecionar apenas parte das ferramentas, em vez de disponibilizar por padrão todas as capacidades do serviço.
As integrações do n8n e as ferramentas baseadas em nós são adequadas para operações individuais bem definidas. Você escolhe a operação e fixa os parâmetros necessários; o modelo preenche apenas o que foi deixado para ele. Por exemplo, ao enviar uma mensagem, é possível limitar previamente o canal de destino, em vez de permitir que o modelo o escolha a cada envio. Isso exige mais configuração do que conectar um conjunto de ferramentas MCP, mas também reduz o que o modelo pode alterar.
As ferramentas de fluxo de trabalho disponibilizam um processo inteiro já definido para o Agent chamar. Há dois níveis: o Agent decide quando chamar, e o fluxo determina quais etapas serão executadas depois. A lógica de negócio existente pode continuar nos fluxos, sem precisar ser reescrita no prompt.
O exemplo oficial de atendimento ao cliente ilustra bem essa diferença: um Agent usa três fluxos para obter o contexto do cliente, adicionar notas e avisar a equipe de plantão, respectivamente. Ele escolhe as ferramentas conforme o conteúdo do chamado, prepara uma resposta e lida com o escalonamento. O fluxo que obtém o contexto consulta o CRM, o status do contrato e os indicadores de saúde do cliente; o fluxo que adiciona notas recebe apenas o ID do cliente e o conteúdo da nota.
O escopo da permissão para adicionar notas é especialmente importante. Ao usar esse fluxo como ferramenta, o Agent recebe uma ação limitada, e não a capacidade de alterar livremente o CRM. Cada ferramenta usa suas próprias credenciais vinculadas; ferramentas sensíveis podem exigir aprovação, e o Agent deve esperar que uma pessoa escolha Approve ou Reject antes de continuar. Quem pode editar e publicar o Agent continua sendo definido pelas permissões de função do n8n.
O mesmo Agent pode atender pessoas e ser chamado por processos
Os canais de chat permitem que a equipe faça solicitações diretamente, enquanto as tarefas agendadas colocam o Agent para trabalhar conforme uma programação. O anúncio lista Slack, Telegram, Linear, Discord e tarefas agendadas como pontos de entrada. Por exemplo, profissionais de atendimento podem fazer perguntas no chat, enquanto uma tarefa agendada pede ao mesmo Agent que organize as pendências diariamente, sem manter dois conjuntos de instruções.
No sentido inverso, os fluxos também podem chamar um Agent com o nó Message an Agent: os dados produzidos pelos nós anteriores são reunidos em uma mensagem, enviados a um Agent publicado, e a resposta segue para os próximos nós. O Agent usa suas instruções, ferramentas e memória existentes; o chamador cuida principalmente da conexão entre entradas e saídas.
Assim, a equipe pode colocar as etapas fixas em um fluxo externo e chamar o Agent apenas na etapa que exige avaliação. Também pode deixar o Agent responsável pelo processamento geral e permitir que ele chame alguns fluxos fixos conforme a necessidade. A escolha depende de qual parte precisa de uma sequência definida e qual precisa mudar de abordagem diante de novas informações.
Alterar, publicar e investigar fazem parte do mesmo processo de gestão
O rascunho do Agent é separado da versão publicada. Enquanto o rascunho é alterado e testado na prévia, a equipe continua usando a versão publicada; a nova versão é publicada quando estiver pronta. Uma publicação atualiza o mesmo Agent usado por todos os pontos de entrada conectados, sem copiar a configuração canal por canal. As versões também permitem restauração, reversão para uma versão anterior e retirada da publicação.
Os registros de conversa mostram não apenas a resposta final, mas também as etapas de execução, as chamadas de ferramentas com suas entradas e saídas, e os erros. Quando ocorre um problema, é possível conferir qual ação foi de fato escolhida e quais resultados foram obtidos. Os logs oferecem evidências para investigar; as aprovações oferecem um ponto de controle humano antes da ação. Um não substitui o outro.
Como começar e em que nível os custos são contabilizados
Para criar manualmente, entre na aba Agents do projeto, selecione Create Agent e configure o modelo, as instruções e as capacidades. Também é possível descrever a necessidade ao n8n Assistant, que prepara instruções, ferramentas e Skills para sua revisão e seus testes. O Assistant é uma forma de obter ajuda na construção; o Agent pronto é o objeto que processa as solicitações de negócio.
Sem uma API key de um fornecedor de modelos, é possível começar com os Gateway credits disponíveis; também podem ser usadas credenciais próprias. Os Gateway credits pagam chamadas a modelos ou serviços compatíveis e são separados dos AI credits consumidos nas conversas com o Assistant. Os dois saldos não devem ser tratados como uma única cota.
As execuções do Agent são contabilizadas separadamente: o usuário envia uma mensagem, o Agent a processa e devolve uma resposta, e essa rodada conta como uma execution. Segundo o anúncio, chamadas do Agent a ferramentas de fluxo de trabalho e a subagentes não acrescentam execuções separadas; Agents e fluxos compartilham a cota de execuções do plano. Uma conversa com várias trocas não pode ser estimada como se toda a conversa contasse apenas uma vez. Os custos das chamadas ao modelo também não equivalem a essa contagem de execuções.
Este lançamento disponibiliza Agents para usuários do n8n Cloud na versão estável mais recente e também oferece uma opção Community de hospedagem própria que exige configuração adicional. Enterprise está em fase de prévia, com mais recursos de governança ainda em desenvolvimento. Agents também continua sendo um recurso em prévia; a orientação oficial é testar antes de publicar e manter a aprovação para ações sensíveis.
Para equipes que já têm fluxos de trabalho, o ponto de partida mais valioso é encontrar uma tarefa que exija consultas sucessivas e avaliação, usando os processos confiáveis existentes como suas ferramentas, em vez de refazer toda a automação. Tratamento de chamados de atendimento, pesquisa de potenciais clientes, acompanhamento de issues no Linear e resumos agendados são direções citadas no anúncio. Definir quais fluxos podem ser reutilizados, o que cada ferramenta permite fazer e quais ações devem aguardar aprovação é a chave para configurar esse Agent como um assistente de trabalho específico.
Nota sobre o conteúdo:Este artigo foi elaborado com base em informações públicas e serve como referência para a escolha de ferramentas. Os recursos, os preços e as políticas relacionadas podem mudar a qualquer momento; consulte as informações oficiais mais recentes.
Fonte original:blog.n8n.io