Monte seu primeiro AI Agent com Chat Trigger e modelo

O AI Agent recebe uma mensagem, consulta um modelo de chat e escolhe ferramentas para responder. Você pode começar com uma calculadora: ela permite conferir o resultado sem integrar outro sistema de negócio. O agente exige pelo menos uma ferramenta conectada, além do modelo.

Monte as conexões

Crie um workflow e adicione Chat Trigger. Ligue sua saída ao AI Agent. No conector de modelo do agente, adicione OpenAI Chat Model ou outro modelo compatível listado na documentação do Tools Agent. Configure a credencial do provedor e selecione um modelo disponível para seu acesso.

No conector de ferramentas, adicione Calculator. Esse Node executa cálculos matemáticos quando o agente o chama. A ligação de ferramenta tem uma função diferente da conexão principal entre Chat Trigger e AI Agent: o modelo escolhe quando usar a calculadora durante a execução.

Configure a mensagem

No agente, mantenha Prompt em Take from previous node automatically. Essa opção espera o campo chatInput, fornecido pelo Chat Trigger. Em System Message, use uma instrução de exercício:

1
Responda em português do Brasil. Para cálculos matemáticos, use Calculator.
2
Apresente a expressão calculada e o resultado recebido da ferramenta.

Essa instrução orienta o comportamento. Você ainda precisa conferir se a ferramenta foi chamada. Ative Return Intermediate Steps para incluir os passos intermediários na saída do agente durante a investigação.

Teste no chat do editor

Mantenha Make Chat Publicly Available desligado enquanto constrói. Abra a interface manual de chat e envie uma expressão simples. Compare o resultado exibido com o retorno do Calculator na execução.

Cada mensagem recebida pelo Chat Trigger inicia uma execução do workflow. Se o modelo falhar, confira a credencial e a configuração do modelo. Se responder sem usar Calculator, reveja a instrução e os passos intermediários antes de acrescentar mais ferramentas.

Use a versão atual do agente

O n8n 3.0 remove o AI Agent v1 e os modos antigos, incluindo SQL Agent, Conversational Agent e ReAct Agent. Permanece o Tools Agent. Atualize templates antigos para a versão atual do Node antes da migração e repita o teste da ferramenta. A mudança exige conferir o agente usado no workflow, além da versão instalada do n8n.