🎥Como Integrar a Tess AI com o N8N🗒️

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:
  • 1. Recebe mensagens do WhatsApp (utilizando um nó de integração com WhatsApp API).
    2. Extrai o texto da mensagem recebida.
    3. Envia essa mensagem para o agente da Tess AI através do nó "HTTP Request" que configuramos.
    4. Recebe a resposta do agente.
    5. 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 a forma 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!