En esta guía completa, exploraremos cómo configurar una solicitud HTTP en n8n para activar un agente en Tess AI. Si buscas automatizar interacciones con agentes de inteligencia artificial e integrarlo en tus flujos de trabajo, este tutorial es para ti.
n8n es una potente herramienta de automatización visual, mientras que Tess AI ofrece una plataforma robusta para crear y gestionar agentes de IA. Combinando ambos, puedes crear automatizaciones inteligentes y eficientes.
Introducción a n8n y Tess AI
n8n es una plataforma de automatización de flujos de trabajo que permite conectar diversas aplicaciones y servicios sin necesidad de escribir códigos complejos. Con su interfaz intuitiva, puedes arrastrar y soltar nodos para construir flujos de trabajo personalizados.
La Tess AI, por otro lado, es una plataforma de inteligencia artificial generativa que permite la creación de agentes inteligentes para diversos propósitos, desde chatbots hasta análisis de datos y tareas más complejas. Integrar estas dos herramientas abre un abanico de posibilidades para automatización inteligente.
Requisitos previos y primeros pasos en n8n
Antes de comenzar, asegúrate de tener una cuenta en n8n y un agente creado en la plataforma Tess AI. En n8n, comienza creando un nuevo flujo de trabajo. Para configurar la solicitud HTTP, utiliza la barra de búsqueda de nodos y busca "HTTP Request". Arrastra y suelta este nodo en tu flujo de trabajo, será el punto central para comunicarte con Tess AI.
La importancia de la documentación de Tess AI
Un recurso fundamental para configurar correctamente la solicitud HTTP es la documentación de Tess AI.
Navega hasta la sección de agentes y busca la parte que explica cómo "Ejecutar un Agente". Allí encontrarás información crucial sobre la estructura de la solicitud, los parámetros necesarios y ejemplos que pueden facilitar la configuración en n8n.
Tess AI generalmente ofrece ejemplos preconfigurados que pueden ser importados directamente a n8n, ahorrando tiempo y minimizando errores.
Importando la preconfiguración de Tess AI en n8n
Para simplificar la configuración inicial, Tess AI frecuentemente ofrece una "importación" con una preconfiguración para activar sus agentes.
Dentro del nodo "HTTP Request" en n8n, puedes encontrar una opción para importar configuraciones. Elimina cualquier configuración existente y pega la preconfiguración copiada de la documentación de Tess AI. Esta preconfiguración ya traerá la estructura básica de la solicitud, agilizando el proceso.
Descifrando los campos esenciales de la solicitud HTTP
Al importar la preconfiguración o configurarla manualmente, encontrarás tres campos principales que necesitan atención:
URL (Endpoint de la API): Este campo define a dónde se enviará la solicitud. Generalmente, sigue un patrón como https://tess.pareto.io/api/agents/{id}/execute. El {id} será reemplazado por el ID específico de tu agente en Tess AI.
Headers (Encabezados): Los encabezados son metadatos que acompañan la solicitud. Para Tess AI, el encabezado más importante es el de autorización. Este asegura que Tess AI reconozca que tienes permiso para activar el agente. Este encabezado generalmente incluye tu token de API.
Body (Cuerpo de la Solicitud): El cuerpo lleva los datos que deseas enviar para que el agente los procese. Aquí defines el mensaje del usuario, parámetros adicionales o cualquier información que el agente necesite para realizar su tarea. El formato del cuerpo generalmente es 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": "¡hola!" } ], "tools": "no-tools", "waitExecution": false }'
Obteniendo el ID del Agente en Tess AI
Cada agente que crees en Tess AI tiene un identificador único, el ID. Para encontrar el ID de tu agente, accede a la plataforma de Tess AI y abre la página del agente específico que deseas accionar. El ID generalmente aparece en la URL de la página. Por ejemplo, en una URL como https://tess.pareto.io/pt-BR/dashboard/user/content/templates/add-or-update/11333, el ID del agente es 11333. Copia este ID y reemplaza el placeholder {id} en la URL de la solicitud HTTP en n8n.
Generando e Insertando el Token de API de Tess AI
El Token de API es tu credencial de acceso a Tess AI. Para generarlo, en la plataforma de Tess AI, busca la sección "Tokens de API" o similar. Crea un nuevo token (recuerda que los tokens son confidenciales y deben mantenerse de forma segura).
Tras la creación, copia el token proporcionado. En n8n, dentro del nodo "HTTP Request", en la sección de headers, agrega un nuevo header con la clave Authorization y el valor Bearer {tu_token_aquí}, reemplazando {tu_token_aquí} por el token que copiaste. "Bearer" indica el tipo de token utilizado.
Personalizando el Mensaje Enviado al Agente
Dentro del body de la solicitud, defines el mensaje que será procesado por el agente. La estructura exacta del body dependerá de la configuración de tu agente en Tess AI, pero, para agentes de chat, es común usar una estructura JSON con campos como role y content.
El content es donde insertas el mensaje propiamente dicho. Si estás integrando con otras herramientas en n8n, como un input de chat de un usuario, puedes usar expresiones de n8n para insertar dinámicamente el mensaje del usuario en el campo content.
En n8n, utiliza la funcionalidad de expresiones (generalmente accesible por un ícono {}) para referenciar el input del mensaje e insertarlo en el lugar correcto dentro del JSON del body.
Optimizando la Solicitud: Eliminando Parámetros Innecesarios
Al configurar tu agente en Tess AI, puedes definir parámetros como modelo de lenguaje, temperatura (creatividad), etc. Si ya has predefinido estos parámetros en la configuración del agente, no es necesario enviarlos nuevamente en el body de la solicitud HTTP.
Simplificar el body, eliminando parámetros redundantes, puede hacer la solicitud más limpia y eficiente. Analiza las configuraciones de tu agente en Tess AI y verifica qué parámetros son realmente necesarios enviar en la solicitud.
Controlando el Tiempo de Respuesta con Wait for Execution
En algunas situaciones, especialmente con agentes más complejos que tardan más en responder, es importante configurar el nodo "HTTP Request" para esperar la respuesta antes de continuar con el flujo en n8n.
En el nodo "HTTP Request", busca una opción como "Wait for Execution" o "Esperar Ejecución" y configúrala como true. Esto asegura que n8n esperará a que Tess AI procese la solicitud y envíe la respuesta antes de ejecutar los siguientes nodos de tu flujo de trabajo.
Para agentes más rápidos, como los de chat simples, esta configuración puede ser menos crítica, pero para procesos más lentos, es esencial para asegurar que la respuesta se capture correctamente.
Probando y Validando el Flujo en n8n
Tras configurar todos los parámetros, es crucial probar el flujo en n8n. Ejecuta el nodo "HTTP Request" (puedes usar el botón "Execute Node" o similar).
Verifica el output del nodo. Si todo está configurado correctamente, deberías ver una respuesta de Tess AI en el output. Analiza la respuesta para asegurarte de que sea la esperada y que el agente de Tess AI haya sido accionado con éxito.
Si hay errores, revisa cada paso de la configuración, verificando el token, el ID del agente, la estructura del JSON en el body y la URL.
Esperamos que este artículo detallado sea útil y cumpla con sus expectativas!
