Como criar um agente no n8n sem liberar ações demais

Para criar um agente de triagem no n8n sem lhe dar acesso excessivo, abra a aba Agents de um projeto, selecione Create Agent e configure modelo, instruções e apenas a ferramenta necessária para registrar pedidos. Teste o rascunho com dados fictícios, exija aprovação humana antes da gravação e publique quando as chamadas de ferramenta estiverem corretas. A documentação do n8n Agents descreve essa sequência e identifica o recurso como ainda em Preview.

O fluxo deste exemplo recebe uma solicitação inventada, classifica seu assunto e sugere uma resposta. Só tenta acrescentar uma linha a uma planilha de testes quando o pedido inclui uma solicitação de registro; essa chamada fica pendente até alguém aprová-la. Agents, criado na aba do projeto, é diferente do nó AI Agent configurado dentro de um workflow.

Defina a tarefa antes de conectar serviços

No projeto escolhido, crie um agente chamado “Triagem de teste”. Em Model, selecione um provedor e um modelo disponíveis na sua instância; se o provedor pedir credenciais, cadastre-as na tela própria do n8n. Não coloque chaves nas instruções nem nas mensagens usadas para testar a conversa.

Em Instructions, descreva o formato de entrada e de saída. Uma instrução possível é: “Classifique a solicitação como acesso, cobrança ou outro assunto. Responda com categoria, resumo de uma frase e sugestão de resposta. Se faltar informação, peça esclarecimento. Só solicite o registro quando a pessoa pedir isso expressamente. Não diga que houve gravação antes de receber o resultado da ferramenta.” As categorias são escolhas do exercício e podem ser trocadas pelo vocabulário da operação real.

A memória de sessão já preserva o contexto da conversa em andamento. Para esta triagem, deixe desativada a memória episódica, que recupera informações de conversas anteriores: um pedido de teste não precisa influenciar o seguinte. Também deixe de fora busca na web, base de conhecimento, subagentes, canais e agendamentos enquanto a tarefa depender somente do texto enviado no Preview.

Exponha apenas a operação que o agente precisa

Crie uma planilha de testes no Google Sheets com colunas para solicitação, categoria, resposta sugerida e status. Use apenas conteúdo inventado. Na seção Tools do agente, adicione uma ação que inclua uma linha nessa planilha e fixe o destino e os campos necessários na configuração da ferramenta. Não ofereça operações de exclusão ou atualização se o exercício exige apenas acrescentar um registro.

O exemplo de agente de suporte da n8n mostra por que um workflow pode servir como ferramenta de escopo mais estreito: o agente chama uma ação definida, enquanto a credencial usada para executá-la permanece no workflow. Esse arranjo é útil quando a integração direta permite ao agente escolher parâmetros que deveriam ser fixos. Para a primeira montagem, a ação de planilha configurada para um destino de teste é suficiente; se o destino precisar ser imposto independentemente do que o agente solicitar, coloque a gravação em um workflow dedicado.

Não confunda limitar a operação apresentada ao agente com limitar automaticamente a credencial do Google. Confira as permissões concedidas à conta conectada e mantenha a planilha de teste separada dos arquivos de trabalho. Uma ferramenta de leitura só faz sentido se as categorias precisarem vir da planilha; quando já estão nas instruções, acrescentá-la aumenta o acesso sem melhorar a triagem.

Coloque a aprovação na ação de gravação

Configure a ferramenta que inclui linhas para exigir aprovação antes da execução. Na apresentação oficial dos Agents, a n8n explica que uma ferramenta marcada como sensível pausa para a decisão Approve ou Reject; o histórico em Sessions mostra mensagens, ferramentas usadas e aprovações pendentes. A aprovação pertence à chamada da ferramenta, não a uma promessa escrita nas instruções.

Faça um pedido sem autorização para gravar: “Classifique esta solicitação e sugira uma resposta: não consigo entrar na conta de demonstração”. O agente deve devolver a categoria e a sugestão sem pedir a ação de planilha. Depois, envie uma solicitação fictícia que peça explicitamente o registro. Antes de escolher Approve, examine qual ferramenta foi chamada, o destino configurado e os valores propostos para a nova linha.

Se a categoria ou o conteúdo estiver incorreto, escolha Reject. A recusa cancela aquela chamada; o agente pode continuar a conversa, mas não deve tratar o registro como concluído. Esse teste separa dois comportamentos que podem parecer iguais numa resposta em texto: sugerir uma providência e efetivamente alterar os dados.

Teste o rascunho e examine as sessões

Abra Preview e converse com a versão em rascunho. Envie um caso de categoria clara, outro ambíguo e um pedido fora do escopo, como “apague todos os registros”. No caso ambíguo, espere um pedido de esclarecimento. No último, a ausência de ferramenta de exclusão deve impedir a ação, mesmo que o agente interprete a mensagem como uma ordem.

Preview executa o agente com as ferramentas que você conectou; por isso, mantenha o destino de teste durante essa etapa. Faça também uma tentativa de gravação recusada e confira diretamente se nenhuma linha apareceu na planilha. Se o agente disser que registrou o pedido após Reject, ajuste as instruções e repita o cenário. Se chamar uma ferramenta sem necessidade, revise a descrição e a finalidade dela ou remova-a.

Em Sessions, compare cada mensagem com as chamadas de ferramenta e as respostas obtidas. O histórico ajuda a distinguir uma classificação ruim de uma ferramenta mal escolhida ou de uma aprovação pendente. Guarde junto dos cenários aceitos a identificação da versão publicada: assim, uma mudança posterior pode ser associada à configuração que estava ativa quando a solicitação foi processada.

Publique com um caminho de recuperação

Depois de verificar classificação, gravação aprovada e gravação recusada, selecione Publish. A publicação cria uma versão do rascunho; edições posteriores continuam no rascunho até outra publicação. Canais e agendamentos usam a versão publicada, então conecte apenas o meio de entrada que a rotina de triagem realmente exige.

Envie um pedido fictício por esse meio e localize a sessão correspondente. Isso permite conferir o comportamento da versão publicada, além daquele observado no Preview. Se uma alteração futura produzir chamadas indevidas, use Unpublish para interromper novas execuções do agente ou recupere uma versão anterior pelo histórico de publicações. Antes de colocá-la em operação novamente, confira as ferramentas vinculadas e repita os cenários de teste: recuperar instruções antigas não revisa, por si só, o acesso concedido às ferramentas.

Leia também:

• OpenAI relata seis desvios — um agente publicou arquivo sem permissão
• Agente de IA com acesso demais: quatro controles antes da produção
• OpenAI revela seis desvios — um agente publicou arquivo sem autorização