Neste guia completo, vamos explorar como configurar uma requisição HTTP no n8n para acionar um agente na Tess AI. Se você busca automatizar interações com agentes de inteligência artificial e integrar isso aos seus fluxos de trabalho, este tutorial é para você.
O n8n é uma poderosa ferramenta de automação visual, enquanto a Tess AI oferece uma plataforma robusta para criar e gerenciar agentes de IA. Combinando os dois, você pode criar automações inteligentes e eficientes.
Introdução ao n8n e Tess AI
O n8n é uma plataforma de automação de workflows que permite conectar diversas aplicações e serviços sem a necessidade de escrever códigos complexos. Com sua interface intuitiva, você pode arrastar e soltar nós para construir fluxos de trabalho personalizados.
A Tess AI, por outro lado, é uma plataforma de inteligência artificial generativa que possibilita a criação de agentes inteligentes para diversas finalidades, desde chatbots até análise de dados e tarefas mais complexas. Integrar essas duas ferramentas abre um leque de possibilidades para automação inteligente.
Pré-requisitos e Primeiros Passos no n8n
Antes de começarmos, certifique-se de ter uma conta no n8n e um agente criado na plataforma Tess AI. No n8n, inicie criando um novo workflow. Para começarmos a configurar a requisição HTTP, utilize a barra de busca de nós e procure por "HTTP Request". Arraste e solte este nó no seu workflow, ele será o ponto central para comunicarmos com a Tess AI.
A Importância da Documentação da Tess AI
Um recurso fundamental para configurar corretamente a requisição HTTP é a documentação da Tess AI.
Navegue até a seção de agentes e procure pela parte que explica como "Executar um Agente". Lá, você encontrará informações cruciais sobre a estrutura da requisição, os parâmetros necessários e exemplos que podem facilitar a configuração no n8n.
A Tess AI geralmente oferece exemplos pré-configurados que podem ser importados diretamente para o n8n, economizando tempo e minimizando erros.
Importando a Pré-configuração da Tess AI para o n8n
Para simplificar a configuração inicial, a Tess AI muitas vezes disponibiliza um "import" com uma pré-configuração para acionar seus agentes.
Dentro do nó "HTTP Request" no n8n, você pode encontrar uma opção para importar configurações. Exclua qualquer configuração existente e cole a pré-configuração copiada da documentação da Tess AI. Essa pré-configuração já trará a estrutura básica da requisição, agilizando o processo.
Decifrando os Campos Essenciais da Requisição HTTP
Ao importar a pré-configuração ou ao configurar manualmente, você encontrará três campos principais que precisam de atenção:
URL (Endpoint da API): Este campo define para onde a requisição será enviada. Geralmente, segue um padrão como https://tess.pareto.io/api/agents/{id}/execute. O {id} será substituído pelo ID específico do seu agente na Tess AI.
Headers (Cabeçalhos): Os headers são metadados que acompanham a requisição. Para a Tess AI, o mais importante é o header de autorização. Ele garante que a Tess AI reconheça que você tem permissão para acionar o agente. Este header geralmente inclui o seu token de API.
Body (Corpo da Requisição): O body carrega os dados que você deseja enviar para o agente processar. Aqui, você define a mensagem do usuário, parâmetros adicionais ou qualquer informação que o agente necessite para executar sua tarefa. O formato do body geralmente é JSON.
curl --request POST \ --url 'https://tess.pareto.io/api/agents/{id}/execute' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "temperature": "1", "model": "tess-ai-light", "messages": [ { "role": "user", "content": "hello there!" } ], "tools": "no-tools", "waitExecution": false }'
Obtendo o ID do Agente na Tess AI
Cada agente que você cria na Tess AI possui um identificador único, o ID. Para encontrar o ID do seu agente, acesse a plataforma da Tess AI e abra a página do agente específico que você deseja acionar. O ID geralmente aparece na URL da página. Por exemplo, em uma URL como https://tess.pareto.io/pt-BR/dashboard/user/content/templates/add-or-update/11333, o ID do agente é 11333. Copie este ID e substitua o placeholder {id} na URL da requisição HTTP no n8n.
Gerando e Inserindo o Token de API da Tess AI
O Token de API é a sua credencial de acesso à Tess AI. Para gerá-lo, na plataforma da Tess AI, procure pela seção "Tokens de API" ou similar. Crie um novo token (lembre-se de que tokens são confidenciais e devem ser mantidos em segurança).
Após a criação, copie o token fornecido. No n8n, dentro do nó "HTTP Request", na seção de headers, adicione um novo header com a chave Authorization e o valor Bearer {seu_token_aqui}, substituindo {seu_token_aqui} pelo token que você copiou. O "Bearer" indica o tipo de token utilizado.
Personalizando a Mensagem Enviada ao Agente
Dentro do body da requisição, você define a mensagem que será processada pelo agente. A estrutura exata do body dependerá da configuração do seu agente na Tess AI, mas, para agentes de chat, é comum utilizar uma estrutura JSON com campos como role e content.
O content é onde você insere a mensagem propriamente dita. Se você estiver integrando com outras ferramentas no n8n, como um input de chat de um usuário, você pode usar expressões do n8n para inserir dinamicamente a mensagem do usuário no campo content.
No n8n, utilize a funcionalidade de expressões (geralmente acessada por um ícone {}) para referenciar o input de mensagem e inseri-lo no lugar correto dentro do JSON do body.
Otimizando a Requisição: Removendo Parâmetros Desnecessários
Ao configurar seu agente na Tess AI, você pode definir parâmetros como modelo de linguagem, temperatura (criatividade), etc. Se você já predefiniu esses parâmetros na configuração do agente, não é necessário enviá-los novamente no body da requisição HTTP.
Simplificar o body, removendo parâmetros redundantes, pode tornar a requisição mais limpa e eficiente. Analise as configurações do seu agente na Tess AI e veja quais parâmetros são realmente necessários enviar na requisição.
Controlando o Tempo de Resposta com Wait for Execution
Em algumas situações, especialmente com agentes mais complexos que demoram mais para responder, é importante configurar o nó "HTTP Request" para aguardar a resposta antes de prosseguir com o fluxo no n8n.
No nó "HTTP Request", procure por uma opção como "Wait for Execution" ou "Esperar Execução" e defina-a como true. Isso garante que o n8n esperará a Tess AI processar a requisição e enviar a resposta antes de executar os próximos nós do seu workflow.
Para agentes mais rápidos, como os de chat simples, essa configuração pode ser menos crítica, mas para processos mais demorados, é essencial para garantir que a resposta seja capturada corretamente.
Testando e Validando o Fluxo no n8n
Após configurar todos os parâmetros, é crucial testar o fluxo no n8n. Execute o nó "HTTP Request" (você pode usar o botão "Execute Node" ou similar).
Verifique o output do nó. Se tudo estiver configurado corretamente, você deverá ver uma resposta da Tess AI no output. Analise a resposta para garantir que ela é a esperada e que o agente da Tess AI foi acionado com sucesso.
Se houver erros, revise cada etapa da configuração, verificando o token, o ID do agente, a estrutura do JSON no body e a URL.
Integrando com Outras Aplicações: Exemplo com WhatsApp
A verdadeira potência do n8n se revela na integração com outras aplicações. Imagine que você queira que seu agente da Tess AI responda a mensagens recebidas no WhatsApp. Você pode criar um fluxo no n8n que:
Recebe mensagens do WhatsApp (utilizando um nó de integração com WhatsApp API).
Extrai o texto da mensagem recebida.
Envia essa mensagem para o agente da Tess AI através do nó "HTTP Request" que configuramos.
Recebe a resposta do agente.
Envia a resposta de volta para o WhatsApp do usuário (novamente, utilizando um nó de integração com WhatsApp API).
Este é apenas um exemplo, o n8n oferece integrações com inúmeras outras plataformas, como CRMs, emails, redes sociais, bancos de dados, etc.
Segurança e Boas Práticas na Automação
Proteja seu Token de API: Nunca compartilhe seu token de API da Tess AI em locais públicos ou não seguros. Ele dá acesso aos seus agentes e dados. Utilize variáveis de ambiente ou cofres de segredos no n8n para armazenar tokens e outras credenciais sensíveis de forma segura.
Monitoramento e Custos: Fique atento ao uso da API da Tess AI, especialmente se você tiver um plano pago. Monitore o número de requisições e os custos associados para evitar surpresas na fatura.
Expandindo as Capacidades do seu Agente e Automação
Personalização Avançada do Agente: A Tess AI oferece diversas opções para personalizar o comportamento dos seus agentes. Explore a configuração de prompts iniciais, contextos, memórias e outras funcionalidades para refinar como o agente interage.
Fluxos de Trabalho Complexos: O n8n permite criar fluxos de trabalho muito mais elaborados do que apenas acionar um agente e enviar uma resposta. Você pode adicionar lógica condicional (se/senão), loops, processamento de dados, armazenamento de informações, e muito mais. Explore as diversas funcionalidades do n8n para criar automações realmente poderosas.
Histórico de Conversas: Para agentes de chat mais avançados, você pode implementar mecanismos para manter o histórico das conversas. Isso permite que o agente se lembre do contexto anterior e forneça respostas mais relevantes e personalizadas.
Esperamos que este artigo detalhado seja útil e atenda às suas expectativas!
