🛠️ Construye tu Agente IA en Make

Paso 1: Creación del Agente de IA "Donna"

Este es el cerebro del sistema. Aquí definirás su identidad y conectarás el modelo de lenguaje que utilizarás.

1. Navega a la sección de Agentes de IA: En el panel izquierdo de Make.com, haz clic en "AI Agents" y luego en el botón para crear un nuevo agente.
2. Conecta tu Modelo de Lenguaje (LLM):
   • Haz clic en "Add" para conectar un LLM de tu elección, como OpenAI.
   • Deberás proporcionar tu clave API (API Key).
3. Configura los Detalles del Agente:

   Campo en Make	Valor / Mapeo de Datos
   Nombre del Agente	Donna Asistente V2
   Modelo	Elige tu modelo preferido (ej. GPT-4o, GPT-3.5-turbo).
   System prompt	Pega el texto de "System Prompt – Donna" que se proporcionó. ## Identidad Te llamas **Donna** y eres la asistente personal de **Joaco Malig**. Eres su **secretaria ejecutiva digital**. ... (y el resto del prompt)
   Memoria del Agente	Recomienda un historial de 10 mensajes.

Revisado y actualizado a la última versión.

Paso 2: Telegram (Escenario Principal)

Este escenario será la puerta de entrada para todas tus interacciones con Donna.

1. Módulo 1: Telegram Bot - Watch Updates
   • Disparador (Trigger): Watch Updates
   • Conexión: Crea un nuevo bot en Telegram con BotFather y usa el token API para conectar en Make.
2. Módulo 2: Router
   • Agrega un router para bifurcar el flujo.
3. Módulo 3: Set a variable (Ruta de Texto)
   • Filtro: "si es texto" - `{{1.message.text}}` (condición: `exist`).
   • Mapeo de datos:

     Campo en Make	Valor / Mapeo de Datos
     Variable name	texto
     Variable value	{{1.message.text}}

4. Módulo 4: AI Agent - Run an Agent
   • Acción: Run an Agent
   • Mapeo de datos:

     Campo en Make	Valor / Mapeo de Datos
     Agent	Selecciona tu agente **Donna**.
     Thread ID	{{1.message.from.id}}
     Additional System Instructions	Pega el "Additional System Prompt – Donna" proporcionado.
     Input	{{2.texto}} (desde el módulo Set Variable)

5. Módulo 5: Telegram Bot - Send a Text Message
   • Acción: Send a Text Message or a Reply
   • Mapeo de datos:

     Campo en Make	Valor / Mapeo de Datos
     Chat ID	{{1.message.chat.id}}
     Text	{{4.response}} (la respuesta del agente)

Revisado y actualizado a la última versión.

Paso 3: Gmail (Escenario de Herramienta)

Este escenario independiente será la "herramienta" que Donna llamará para enviar correos.

1. Define los Inputs del Escenario:
   • Haz clic en "Scenario inputs and outputs" en la parte inferior.
   • Crea tres inputs de tipo Text y márcalos como **Required**:
     • input_correo
     • input_asunto
     • input_cuerpo
2. Módulo 1: Gmail - Send an email
   • Acción: Send an email (o la de tu proveedor)
   • Conexión: Conecta tu cuenta de Gmail.
   • Mapeo de datos:

     Campo en Make	Valor / Mapeo de Datos
     To	{{var.input.input_correo}}
     Subject	{{var.input.input_asunto}}
     Content	{{var.input.input_cuerpo}}

3. Módulo 2: Scenarios - Return an Output
   • Acción: Return an Output
   • Mapeo de datos:

     Campo en Make	Valor / Mapeo de Datos
     Variable de confirmación	"Se ha enviado el correo electrónico con éxito."

Revisado y actualizado a la última versión.

Gestión de Errores

La gestión de errores es crucial para la robustez del escenario. En este caso, la configuración de la ruta de texto tiene una estrategia simple: si el texto no existe, la ruta se ignora. Sin embargo, para un escenario más completo, se pueden usar manejadores de errores.

Estrategia Básica con Routers

La configuración del router en el escenario principal ya funciona como una gestión de errores simple. Si el mensaje no tiene texto (ruta inferior), el flujo simplemente no continúa por esa rama, evitando errores. La misma lógica aplica para la ruta de voz, donde el filtro "si es audio" evita que un mensaje de texto intente ser descargado como archivo de voz.

Errores Potenciales y Soluciones Avanzadas

Un error común podría ser que la API de Gmail no responda o que el destinatario del correo sea inválido. Para manejar esto, se puede configurar una ruta de error en el módulo de Gmail del escenario de la herramienta.

Solución: En la configuración del módulo de Gmail, haz clic en el botón de la llave inglesa (o clic derecho) y selecciona **"Error handling"**. Puedes usar:

• Resume: Para que el escenario continúe a pesar del error (útil si no es crítico).
• Break: Para detener el escenario y marcar el error (útil para errores que impiden la ejecución completa).

Fundamentos de Make AI Agents