Entendendo a Necessidade
Imagine que você queira automatizar a interação entre um usuário e um agente de IA. Por exemplo, ao receber uma mensagem de um cliente via WhatsApp, você deseja que essa mensagem seja processada por um agente da Tess AI, que responderá de forma inteligente ao cliente. Para isso, precisamos criar um fluxo onde a mensagem do usuário é enviada ao agente, e a resposta do agente é retornada ao usuário.
Passo a Passo Explicado
Iniciando no N8N
Abra o N8N e crie um novo fluxo de trabalho. Esta será a base onde construiremos nossa automação.
O N8N funciona com 'nós', que representam ações ou serviços. Cada nó pode receber, processar ou enviar dados, e você pode conectá-los para criar fluxos complexos.
Adicionando o Nó de Requisição HTTP
No painel de busca do N8N, digite "HTTP" para encontrar o nó "HTTP Request".
Adicione este nó ao seu fluxo. Este nó será responsável por enviar uma requisição à API da Tess AI para acionar o agente.
Configurando a Requisição HTTP
Referência à Documentação da Tess AI:
Acesse a documentação da Tess AI e navegue até a seção que explica como "Executar um Agente" via API.
Lá, você encontrará exemplos de requisições e detalhes sobre os parâmetros necessários.
Importando Configurações:
Para facilitar, você pode copiar um exemplo de configuração da documentação e colá-lo no N8N.
Dentro do nó "HTTP Request", limpe quaisquer configurações existentes e cole a pré-configuração obtida.
Entendendo os Componentes da Requisição:
URL: É o endpoint da API da Tess AI onde a requisição será enviada. Geralmente segue o formato https://api.tess.ai/agents/{agent_id}/execute.
Método: Usaremos o método POST, pois estaremos enviando dados (a mensagem do usuário) para serem processados.
Headers: Necessitamos de um header de autorização para autenticar nossa requisição. Isso é feito através do token de API fornecido pela Tess AI.
Body (Corpo): Aqui, incluímos os dados que serão enviados ao agente, como a mensagem do usuário, parâmetros de configuração, etc.
Obtendo o ID do Agente
Cada agente criado na Tess AI possui um ID único.
Para obter o ID do seu agente:
Acesse a plataforma da Tess AI e abra o agente que você criou.
O ID geralmente aparece na URL da página do agente. Por exemplo, se a URL for https://app.tess.ai/agents/1034, o ID é 1034.
Copie esse ID e substitua na URL da API na configuração do N8N.
Gerando e Inserindo o Token de API
Gerar o Token:
Na plataforma da Tess AI, vá até a seção "API Tokens" ou "Tokens de API".
Crie um novo token. Lembre-se que este token é sensível e deve ser mantido seguro.
Após criar, copie o token para uso imediato.
Inserir no Header de Autorização:
No N8N, na configuração do nó "HTTP Request", insira o token nos headers da requisição.
O header deve ser algo como: Authorization: Bearer {seu_token_aqui}.
Isso autenticará sua requisição, permitindo que a Tess AI reconheça e processe o pedido.
Personalizando a Mensagem para o Agente
Entendendo o Payload:
No corpo da requisição, você define o conteúdo da mensagem que será enviada ao agente.
Isso inclui a mensagem do usuário e, dependendo de como seu agente foi configurado, pode incluir outros parâmetros como temperatura, modelo de linguagem, etc.
Editando o Conteúdo:
No JSON do body, localize onde está definido "content": "Hello there".
Substitua "Hello there" pela variável que contém a mensagem do usuário.
No N8N, você pode usar a funcionalidade de expressões para inserir variáveis dinâmicas obtidas de outros nós (por exemplo, mensagens recebidas via WhatsApp).
Exemplo:
Se você tiver um nó anterior que captura a mensagem de entrada (por exemplo, um nó que recebe mensagens do WhatsApp), você pode inserir essa variável no campo content.
Clique em "Add Expression" ou similar, e selecione a variável que representa a mensagem do usuário.
Removendo Parâmetros Desnecessários
Simplificando a Configuração dos Agentes dentro da Tess AI:
Se você já pré-definiu certos parâmetros no agente (como modelo de IA, temperatura, etc.), não é necessário enviá-los na requisição.
Note que esses parâmetros estão presentes nas configurações avançadas na criação de agentes!
Você pode remover esses parâmetros do JSON para simplificar.
Configurando o Tempo de Espera pela Resposta
Na configuração do nó HTTP, ajuste para que o fluxo aguarde a resposta do agente antes de prosseguir.
Isso geralmente é feito ajustando o parâmetro wait for execution para true.
Isso é importante pois queremos que o fluxo receba a resposta do agente para poder processá-la ou enviá-la de volta ao usuário.
Testando o Fluxo
Executando o Fluxo:
Salve todas as configurações e execute o fluxo no N8N.
Você pode enviar uma mensagem de teste para ver se tudo está funcionando corretamente.
Verificando a Resposta:
No N8N, você verá a resposta do agente no output do nó HTTP Request.
Verifique se a resposta faz sentido e corresponde ao que você espera.
Resolução de Problemas:
Se você não receber uma resposta ou ocorrer um erro no fluxo do N8N, verifique:
Se o token está correto e válido.
Se o campo wait execution está como "true"
Se o ID do agente está correto.
Se o JSON está bem formatado.
Se a mensagem do usuário está sendo corretamente inserida.
Além disso, caso o erro aconteça e você tenha o log dele, coloque-o na Tess AI e ela certamente irá lhe trazer alternativas de solução!
Integrando com Outros Serviços
Envio da Resposta ao Usuário:
Depois de receber a resposta do agente, você pode adicioná-la ao fluxo para ser enviada de volta ao usuário.
Por exemplo, se você estiver integrando com o WhatsApp, pode adicionar um nó que envia a mensagem de volta ao usuário via API do WhatsApp!
Considerações sobre Segurança e Boas Práticas
Proteja seus Tokens:
Não compartilhe seus tokens de API. Eles proporcionam acesso aos seus agentes e devem ser mantidos seguros.
Evite incluí-los em códigos públicos ou documentos compartilhados.
Valide as Entradas do Usuário:
Considere implementar validações ou sanitizações na mensagem do usuário antes de enviá-la ao agente, para evitar comportamentos indesejados.
Monitore o Uso e os Custos:
Dependendo do plano que você possui na Tess AI, pode haver limites ou custos associados ao uso dos agentes.
Monitore suas chamadas à API e certifique-se de que está dentro dos limites desejados.
Conclusão
Integrar um agente da Tess AI com o N8N via requisição HTTP permite criar soluções poderosas que combinam automação de fluxos de trabalho com inteligência artificial. Embora envolva alguns passos técnicos, a combinação de uma documentação clara da Tess AI e a interface amigável do N8N facilita o processo.
Ao entender não apenas o "como", mas também o "porquê" de cada etapa, você estará melhor preparado para adaptar e expandir sua solução conforme necessário, criando agentes inteligentes que interagem de forma eficaz com seus usuários ou clientes.
Documentação da Tess AI: Sempre consulte a documentação oficial para detalhes atualizados sobre a API e funcionalidades disponíveis.
