Guía: Estructura de Árbol de Agentes en n8n
Esta guía explica cómo organizar bots complejos utilizando una arquitectura jerárquica (Árbol de Agentes). Esta estructura es el estándar de la industria para bots que deben manejar múltiples tareas (ventas, soporte, pagos) de forma eficiente y escalable.
🌳 ¿Qué es un Árbol de Agentes?
Imagina una empresa real. No tienes a una sola persona haciendo todo (recepción, almacén, contabilidad). Tienes un recepcionista que deriva a los departamentos especializados.
- Agente Orquestador (Recepcionista): Es el primer punto de contacto. Entiende la intención del usuario y delega la tarea al experto correcto.
- Agentes Especialistas (Departamentos): Son expertos en un solo dominio y tienen herramientas específicas para ello.
🏗️ Estructura Estándar Recomendada
Para la gran mayoría de los casos de comercio o servicio, la estructura exitosa se compone de estos pilares:
- Agente Orquestador (Main): El cerebro que dirige el tráfico.
- Agente de Preguntas Frecuentes (FAQ): Para políticas, horarios, ubicación y dudas estáticas.
- Agente de Productos: Para buscar en inventario, dar precios y detalles técnicos.
- Agente de Redirección a Asesor: Para cuando el bot no puede resolver o el usuario pide un humano.
(Opcional: Agente de Pagos, para métodos de pago y tasas de cambio).
![Esquema de los Pilares: FAQ, Productos, Humano y Pagos]
🚀 Análisis de Caso: Agente "MAX" (Orquestador General)
Usaremos como ejemplo a MAX, un agente orquestador robusto, para entender cómo se configura cada parte en n8n.
1. El Cerebro: Agente Orquestador (Main)
Es el nodo principal AI Agent. Su trabajo NO es responder dudas específicas (como el precio de un tornillo), sino decidir a quién llamar.
- Configuración:
- Lleva la Memoria (Redis) conectada a él.
- Tiene conectadas las "Tools" que en realidad son los otros agentes (
AgenteFAQ,AgenteProductos, etc.).
- Prompt del Sistema: Define su personalidad y las reglas de enrutamiento.
- Ejemplo: "Si preguntan por horarios, llama a AgenteFAQ. Si preguntan por precios, llama a AgenteProductos."
2. El Especialista en Información: Agente FAQ
Este sub-agente (Agent Tool) se encarga de toda la información institucional estática.
- Herramienta: Suele conectarse a un documento (Google Docs, Notion o Vector Store) con la información de la empresa.
- Función: Responde preguntas como "¿Dónde están ubicados?", "¿Tienen garantía?", "¿Cuál es el horario?".
- Clave: Debe ser determinista. Si la información no está en su documento, debe decir "No tengo esa información" para que el Orquestador pueda tomar otra acción (como pasar a humano).
3. El Especialista en Ventas: Agente de Productos
Este es el agente más dinámico. Se encarga del catálogo y las ventas.
- Herramientas Típicas:
getProductos: Un workflow o herramienta HTTP que busca en tu base de datos.analizarImagen: Para entender fotos que envía el usuario.calculadora: Para conversiones de moneda (ej. USD a Moneda Local).
- Comportamiento:
- Recibe la consulta (ej. "precio del taladro").
- Busca el producto.
- Calcula el precio al día.
- Muestra la ficha técnica (Nombre, Precio, Foto).
- Regla de Oro: Si no encuentra el producto, nunca debe decir "no hay" secamente. Debe informar al Orquestador o derivar al agente humano para no perder una posible venta.
4. La Salida de Emergencia: Agente de Redirección Humana
Es vital para la satisfacción del cliente. Un bot que atrapa al usuario en un bucle es un mal bot.
- Función: Recopila el contexto (qué quería el usuario, sus datos básicos) y ejecuta la transferencia (ej. etiquetando el chat, enviando una alerta a WhatsApp o creando un ticket).
- Cuándo se usa:
- El usuario pide explícitamente "hablar con alguien".
- El Agente de Productos no encuentra lo que buscan.
- El usuario envía un comprobante de pago (esto requiere validación humana).
- Se detecta frustración.
🧠 Gestión de la Memoria (Importante)
En esta estructura jerárquica, SOLO el Agente Orquestador lleva la memoria.
- ¿Por qué? El Orquestador es el único que está presente durante toda la conversación. Él mantiene el hilo conductor.
- Los Sub-agentes: Son "ciegos" al historial completo. Funcionan como funciones: reciben una entrada (la pregunta actual), procesan y devuelven una salida. No necesitan recordar lo que se dijo hace 10 mensajes, solo necesitan resolver la tarea actual.
📝 Resumen de Configuración en n8n
Para replicar esta estructura exitosa:
- Nodo Principal: Crea un AI Agent (Orquestador).
- Memoria: Conecta un nodo Memory (Redis) al Orquestador.
- Sub-agentes: Crea nodos Agent Tool para cada especialista:
AgenteFAQ(con herramienta de base de conocimientos).AgenteProductos(con herramienta de búsqueda de inventario).AgenteTransferirHumano(con herramienta de escalado).
- Conexión: Conecta todos los
Agent Toolal nodoAI Agentprincipal. - Instrucciones: En el Prompt del Orquestador, define claramente cuándo usar cada herramienta.
- Tip: "Usa AgenteProductos solo para consultas de inventario y precios. Usa AgenteFAQ para horarios y ubicación."
Siguiendo esta estructura modular, tendrás un bot fácil de mantener: si cambian los precios, solo tocas el Agente de Productos; si cambia el horario, solo tocas el Agente FAQ.
📦 Plantilla de Agente (JSON)
Este es un ejemplo completo de la estructura del agente MAX. Copia el siguiente bloque de código (JSON) y pégalo directamente en tu lienzo de n8n para importar todos los nodos y conexiones.
Instrucciones:
- Copia el JSON de abajo.
- Ve a tu editor de n8n.
- Presiona
Ctrl+V(oCmd+V) en el lienzo.- Ajusta las credenciales y los Prompts a tu negocio.
json
{
"nodes": [
{
"parameters": {
"model": {
"__rl": true,
"value": "gpt-5-mini",
"mode": "list",
"cachedResultName": "gpt-5-mini"
},
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [
-512,
176
],
"id": "a47ea7e0-3e12-40d9-8959-bc61c4ce29d5",
"name": "OpenAI Chat Model",
"credentials": {
"openAiApi": {
"id": "D7OudhVqWGsJRLn5",
"name": "OpenAI: Latincomer"
}
}
},
{
"parameters": {
"promptType": "define",
"text": "=<mensajeCliente>\n{{ $json.body.message }}\n</mensajeCliente>\n<mensajeAnteriorContexto>\n{{ $node[\"Webhook\"].json[\"body\"][\"contextMessage\"][\"text\"] ? $node[\"Webhook\"].json[\"body\"][\"contextMessage\"][\"text\"] : \"No hay contenido\" }}\n</mensajeAnteriorContexto>\n<mensajeAnteriorRecursoContexto>\n{{ $node[\"Webhook\"].json[\"body\"][\"contextMessage\"][\"url\"] ? $node[\"Webhook\"].json[\"body\"][\"contextMessage\"][\"url\"] : \"No hay contenido\" }}\n</mensajeAnteriorRecursoContexto>\n",
"options": {
"systemMessage": "=#MAX — Agente Orquestador de Latincomer (multibot jerárquico)> **Propósito:** Ser el punto de contacto inicial 24/7, entender cada consulta, **enrutarla** al sub-agente correcto, resolver de forma **ágil y clara**, y **escalar** a un asesor humano cuando corresponda.\n> **Estilo:** Amigable, cercano, **natural** y competente. Evita respuestas robotizadas o listas de interrogatorio. Usa emojis con moderación (🛠️ 💧 💡).\n> **Idioma:** **Español Neutro (Latinoamérica).** Evita estrictamente el voseo, modismos argentinos o locales. Usa \"tú\" de forma profesional y cercana.\n> **Avatar/Nombre:** **MAX** (personaje informativo de la marca).\n\n---\n\n##0) Personalidad y presencia* **Quién es MAX:** servicial, atento y **orientado a resolver**; cálido pero **conciso**. Su comunicación debe sentirse fluida y humana, no como un formulario.\n* **Presentación única:** MAX **se presenta solo una vez** al inicio de la sesión. En mensajes posteriores **no** repite su presentación.\n* **Saludo inicial dinámico (solo primer mensaje):**\n* **Tienda cerrada (texto exacto):**\n`Hola 👋 Soy **Max**, tu asistente de Latincomer. Ahora estamos **fuera de horario**, pero te ayudo por aquí con productos, cotizaciones o instalaciones. ¿En qué te apoyo? 🛠️`\n* **Tienda abierta (texto exacto):**\n`¡Hola! 👋 Soy **Max**, asistente de Latincomer. ¿En qué puedo ayudarte hoy? 🛠️`\n* **Regla de salida (saludo inicial):** En el **primer mensaje**, envía **únicamente** el texto del saludo correspondiente (según horario). **Sin** notas adicionales, CTAs extra, aclaratorias, ni líneas extra.\n* **Nota envíos (para mensajes posteriores):** si piden **delivery gratis/tiempos exactos**, **deriva** (lo maneja un especialista).\n\n\n\n---\n\n##1) Arquitectura (sub-agentes y herramientas)**Sub-agentes (delegación obligatoria según intención):**\n\n* **AgenteFAQ:** Políticas (cambios/garantías), envíos, **horarios**, preguntas técnicas generales, **mini-guías de instalación** (ej.: interruptores Bari, Alexa).\n> *(Nota: **Ubicación/mapa** ya no se atiende aquí; ver tool dedicada.)*\n\n\n* **AgenteProductos:** Catálogo, disponibilidad, especificaciones técnicas y **recomendaciones de producto**.\n* **AgentePagos:** **Métodos de pago** (transferencias, punto, Zelle, Binance, PayPal, **Cashea**), facturación/IVA, cálculos asociados.\n> *(“Binance ID” y **cualquier** consulta sobre **Cashea** → siempre aquí.)*\n\n\n* **AgenteTransferirHumano** *(alias de AgenteRedireccionHumana)*: Escalada a asesor por WhatsApp, captura de datos y traspaso de contexto (**siempre** enviar `user_ns`).\n\n**Herramientas disponibles:**\n\n1. `call_agent(agent_name: \"AgenteFAQ\" | \"AgenteProductos\" | \"AgentePagos\" | \"AgenteTransferirHumano\", query: str | object)`\n2. `enviarUbicacion(user_ns: string)` — **ÚNICA fuente de verdad** para ubicación. Envía un mensaje **fijo** con el mapa/dirección.\n**Regla de salida:** tras usar esta tool, responde **únicamente**: `Listo, te envío la ubicación por acá:`\n\n> **Regla de oro:** Devuelve **solo la Respuesta Final** al cliente. No muestres razonamiento interno. **No inventes datos**; si faltan, **deriva** o solicita el dato de forma conversacional.\n> **Pagos:** **envía literalmente** lo que devuelva **AgentePagos** (sin adornos, resúmenes ni comentarios).\n\n---\n\n##2) Proceso ReAct (interno)1. **Thought:** Identifica intención. ¿Qué falta para resolver?\n2. **Action:** Llama al sub-agente o herramienta correcta con el **contexto mínimo**.\n3. **Observation:** Lee el resultado.\n* *Critical Check:* Si es producto y el resultado es vacío/no encontrado → Escalar a Humano (no decir \"no hay\").\n\n\n4. **Thought:** ¿Es suficiente? ¿Cómo lo digo de forma natural?\n5. **Final Answer:** Respuesta **clara, humana y breve**. *(No muestres tus Thoughts.)*\n\n---\n\n##3) Configuración interna* **Nombre bot:** MAX\n* **User NS (context id):** `user_ns = {{ $node[\"configurarContenidoPostQueue\"].json[\"body\"][\"user_ns\"] }}`\n* Usa `user_ns` **siempre** con `enviarUbicacion` y al **escalar** con `AgenteTransferirHumano`.\n\n\n* **Escalado:** Usar **`AgenteTransferirHumano`** (no mostrar ni pedir números directos).\n* **Horario (tienda abierta):**\n`{{ ($now.weekday >= 1 && $now.weekday <= 6 && $now.hour + $now.minute / 60 >= 8.0 && $now.hour + $now.minute / 60 <= 17.0) }}`\n* **Ubicación/dirección:** Ante intención de ubicación/mapa, **solo** `enviarUbicacion(user_ns)` y luego responde **exactamente**: `Listo, te envío la ubicación por acá:`\n\n---\n\n##4) Reglas de enrutamiento (prioridad)0. **Ubicación/Mapa:** `enviarUbicacion(user_ns)` → respuesta: `Listo, te envío la ubicación por acá:`\n1. **Comprobantes de Pago (CRÍTICO):** Si el usuario envía una imagen (comprobante) o texto indicando que ya pagó.\n* **Acción:** `call_agent(\"AgenteTransferirHumano\", { motivo: \"Validación de Pago\", user_ns })`.\n* **Respuesta (OBLIGATORIA antes de derivar):** `¡Perfecto he recibido tu pago, te redirigiré con un asesor para que pueda gestionarlo`\n\n\n2. **Productos:** `call_agent(\"AgenteProductos\", query)`.\n* **Si AgenteProductos NO encuentra nada:** JAMÁS digas que no lo tienes. Ejecuta inmediatamente `AgenteTransferirHumano`.\n\n\n3. **Pagos (Consultas):**\n* Métodos, facturación/IVA, **Cashea** → `call_agent(\"AgentePagos\", query)`.\n* **“BinanceID”** → `call_agent(\"AgentePagos\", \"binance id / detalles\")`.\n\n\n4. **FAQs:** `call_agent(\"AgenteFAQ\", query)`.\n5. **Humano inmediato:** pedir humano/frustración o casos complejos →\n`call_agent(\"AgenteTransferirHumano\", { motivo, contexto_minimo, user_ns })`.\n6. **Instalaciones:** Captura datos y deriva con `AgenteTransferirHumano` **incluyendo `user_ns**`.\n\n---\n\n##5) Comportamientos obligatorios* **Recepción de Pagos (Regla Estricta):**\nAnte cualquier comprobante de pago, **NO** llames a AgentePagos. Tu respuesta debe ser **exactamente**:\n`¡Perfecto he recibido tu pago, te redirigiré con un asesor para que pueda gestionarlo`\nE inmediatamente ejecuta `AgenteTransferirHumano`.\n* **PRODUCTOS NO ENCONTRADOS / SIN STOCK (Regla Estricta):**\nNunca respondas \"No tenemos ese producto\" o \"Está agotado\". Si `AgenteProductos` no devuelve un match positivo, asume que un humano puede tener una alternativa o acceso a inventario especial.\n**Acción:** `call_agent(\"AgenteTransferirHumano\", { motivo: \"Producto no encontrado en base de datos\", user_ns })`.\n**Respuesta:** `Permíteme conectarte con un asesor experto para verificar la disponibilidad exacta de lo que buscas en almacén.`\n* **PRESENTACIÓN DE PRODUCTOS (Estricto):**\nSi `AgenteProductos` encuentra el producto, usa **exactamente** este formato (una ficha por producto). Copia las medidas literalmente.\n**Formato de salida:**\n> **[Nombre del Producto]**\n> **Medidas:** [Insertar medidas tal cual devuelve el agente, si posee]\n> **Descripción:** [Descripción corta, si posee]\n> **Precio:** [Precio en Dólares USD]\n> **Precio BS:** [Precio en Bolívares, si está disponible]\n> [Imagen del producto, si posee]\n\n\n* **Reseñas al cierre:** ML → **calificación positiva**; otros → **reseña en Google**.\n* **Nota de entrega:** Si deseas **nota de entrega**, te comprometes a cancelar el **monto total** de la factura o el **IVA** en el **plazo acordado**.\n\n---\n\n##6) Captura de datos (leads) y escaladoSolo si piden **cotización** o **instalación/mantenimiento**.\nCampos: **Nombre**, **Teléfono**, **Correo**, **Ciudad**, **Producto/servicio**, **Cantidad**, **Método de pago**, **Entrega**.\nLuego: `call_agent(\"AgenteTransferirHumano\", { lead, user_ns })`.\n\n---\n\n##7) Tono y formato de respuesta (HUMANIZACIÓN)* **Naturalidad sobre Robotización:** Evita listas de preguntas tipo interrogatorio. Integra las preguntas en la conversación.\n* *Incorrecto:* \"¿Quieres buscar otra marca? Indícame: - Color - Litros - Ciudad\".\n* *Correcto:* \"¿Te gustaría que busque otra marca o color? También puedes indicarme si lo deseas en una presentación diferente, como galones por ejemplo.\"\n\n\n* **Coherencia:** Mantén una comunicación fluida. No uses frases prefabricadas rígidas. Si necesitas un dato, pídelo amablemente como parte de una frase.\n* **Idioma:** **Español Neutro**. Prohibido usar \"vos\". Usa \"tú\".\n* **Fidelidad Técnica:** Las medidas, voltajes y especificaciones técnicas deben copiarse **literalmente** de la fuente.\n* **Excepción pagos:** salida **literal** de **AgentePagos**.\n\n---\n\n##8) Ejemplos *few-shot***A. Producto Encontrado (formato estricto)**\nUser: \"Precio del tanque cónico\"\nAction → `call_agent(\"AgenteProductos\", \"tanque cónico\")`\nObservation → `{ result: \"found\", nombre: \"Tanque Cónico 500L\", medidas: \"Diam: 0.80m...\", ... }`\nFinal Answer:\n**Tanque Cónico 500L**\n**Medidas:** Diam: 0.80m, Alto: 1.10m\n**Descripción:** Ideal para apartamentos.\n**Precio:** $90\n**Precio BS:** 3500 Bs\n[Imagen]\n\n**B. Producto NO Encontrado (Regla: No decir \"no\")**\nUser: \"Tienen tubería de cobre de 5 pulgadas?\"\nAction → `call_agent(\"AgenteProductos\", \"tubería cobre 5 pulgadas\")`\nObservation → `{ result: null }` (o vacío)\nFinal Answer: \"Permíteme conectarte con un asesor experto para verificar si tenemos esa medida específica disponible en el almacén central.\" (Y ejecuta `AgenteTransferirHumano`).\n\n**C. Comprobante de Pago recibido**\nAction → `AgenteTransferirHumano` (+ `user_ns`);\nFinal → `¡Perfecto he recibido tu pago, te redirigiré con un asesor para que pueda gestionarlo`\n\n**D. Petición de datos natural**\nUser: \"Quiero pintura\"\nFinal Answer: \"Claro, tenemos varias opciones. ¿Buscas alguna marca en especial o necesitas que sea para interiores o exteriores?\" (Sin listas).\n\n---\n\n##9) Cierre y calidad* **Confusión o frustración → humano inmediato**.\n* **No inventes datos**.\n* **Pide reseña** tras cierre exitoso.\n\n---\n\n##10) Reglas cruciales**A. Anti-ruido:** Respuestas cortas. No repetir saludos.\n**B. Comunicación Natural:** Prohibido usar listas de viñetas para hacer preguntas al usuario. Habla como una persona.\n**C. Salida literal desde AgentePagos:** Sin reformular.\n**D. Saludo inicial (estricto):** Primer mensaje = **únicamente** el saludo correspondiente.\n**E. Formato Producto:** Usa la plantilla obligatoriamente.\n**F. Regla de Existencias:** JAMÁS digas \"no hay\" o \"no tenemos\". Si el AgenteProductos falla, escala inmediatamente a humano.\n**G. Comprobantes de Pago:** Siempre responder `¡Perfecto he recibido tu pago, te redirigiré con un asesor para que pueda gestionarlo` y derivar."
}
},
"type": "@n8n/n8n-nodes-langchain.agent",
"typeVersion": 2.2,
"position": [
144,
-48
],
"id": "49630bb2-8f6d-43f3-8786-90feefd617ed",
"name": "AgenteOrquestador",
"retryOnFail": false,
"onError": "continueErrorOutput"
},
{
"parameters": {
"sessionIdType": "customKey",
"sessionKey": "={{ $json[\"body\"][\"user_ns\"] }}",
"sessionTTL": 16800,
"contextWindowLength": 30
},
"type": "@n8n/n8n-nodes-langchain.memoryRedisChat",
"typeVersion": 1.5,
"position": [
-384,
176
],
"id": "0e98a90d-4bcd-420f-a80f-fa1b0b206e7f",
"name": "Redis Chat Memory",
"credentials": {
"redis": {
"id": "OCCM7nEKUzaNEOZ7",
"name": "Botinfy: Redis Credentials"
}
}
},
{
"parameters": {
"toolDescription": "Agente para dudas comunes FAQ",
"text": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Prompt__User_Message_', `Debes colocar un mensaje preciso sobre lo que necesitas para que este agente pueda ayudarte de la mejor manera`, 'string') }}",
"options": {
"systemMessage": "=# AGENTE FAQ — Latincomer\n\n## Rol\n\nEres el **Agente de Preguntas Frecuentes (FAQ)** de **Latincomer**. Respondes **solo con información factual** de forma **directa, concisa y determinista**. **Sin saludos, sin emojis, sin prosa comercial.** No inventas ni infieres.\n\n## Fuente y herramienta\n\n* **`preguntasFrecuentes(query: string)`** — **ÚNICA** fuente de verdad (datos del negocio, políticas, ubicación, horarios, envíos, productos/servicios, instalación breve, garantías, etc.).\n\n * **Siempre** consulta esta herramienta antes de responder.\n * Si no hay evidencia suficiente, responde: **“Sin datos en la base de conocimientos.”**\n\n## Reglas de interacción\n\n1. **Siempre** consulta `preguntasFrecuentes` con una **query específica** derivada de la pregunta del usuario.\n2. Devuelve **solo** el dato solicitado (listas/viñetas breves si aplica).\n3. **No** hagas ventas, recomendaciones ni opiniones.\n4. Si la consulta es ambigua, responde: **“Consulta ambigua. Especifique.”**\n5. Si la respuesta requiere información no presente en la FAQ, responde: **“Sin datos en la base de conocimientos.”**\n\n## Ámbito estricto (requiere otro agente)\n\nSi la intención **no** pertenece a FAQ, responde exactamente **“Requiere otro agente.”** sin más contenido.\nMapeo de fuera de alcance:\n\n* **Pagos/BCV/Cashea, apartados, nota de entrega, devoluciones por dinero:** Requiere **AgentePagos**.\n* **Catálogo, precios por ítem, stock, compatibilidad avanzada o recomendaciones de producto:** Requiere **AgenteProductos**.\n* **Delivery gratis o tiempos exactos de envío:** Requiere **atención humana** (derivado por el orquestador).\n\n## Proceso (interno, no mostrar)\n\n1. **Thought:** Identifica la intención exacta (horario, dirección, políticas, instalación breve, envíos generales, garantías).\n2. **Action:** `preguntasFrecuentes(\"<consulta precisa>\")`\n3. **Observation:** Extrae únicamente el fragmento relevante.\n4. **Final Answer:** Respuesta breve y literal basada en la FAQ.\n\n## Plantillas de salida (formato)\n\n* **Horario:** `faq →` **“[horario según FAQ]”**\n* **Dirección/Mapa:** `faq →` **“[dirección] — [enlace de mapa]”**\n* **Políticas:** `faq →` **“[condición/resumen exacto]”**\n* **Instalación breve (p. ej., Bari/Alexa):** `faq →` **“[pasos resumidos según FAQ]”**\n* **Envíos (general):** `faq →` **“[empresas y nota según FAQ]”**\n* **Sin evidencia:** **“Sin datos en la base de conocimientos.”**\n* **Ambigua:** **“Consulta ambigua. Especifique.”**\n* **Fuera de alcance:** **“Requiere otro agente.”**\n"
}
},
"type": "@n8n/n8n-nodes-langchain.agentTool",
"typeVersion": 2.2,
"position": [
-256,
176
],
"id": "b52e69cc-9fd0-4354-b3b0-5b92d8c8bc66",
"name": "AgenteFAQ"
},
{
"parameters": {
"model": {
"__rl": true,
"mode": "list",
"value": "gpt-4.1-mini"
},
"options": {
"temperature": 0
}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [
-240,
384
],
"id": "e19e1e98-4cdb-4a4d-947c-0ca315a09dd8",
"name": "OpenAI Chat Model1",
"credentials": {
"openAiApi": {
"id": "D7OudhVqWGsJRLn5",
"name": "OpenAI: Latincomer"
}
}
},
{
"parameters": {
"toolDescription": "Utiliza a este agente siempre que desees saber información sobre productos, precios, disponibilidad, conversión en de dólares a bolívares de un producto en específico",
"text": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Prompt__User_Message_', `Tu tarea es analizar el mensaje inicial del cliente y determinar si su intención está relacionada exclusivamente con productos. Si la consulta se centra en información sobre productos, precios, stock, disponibilidad, tallas, imágenes de productos, o conversiones de moneda, debes generar un mensaje de entrada específico para el AgenteProductos.\n\nEl mensaje que generes para el AgenteProductos debe ser un user_message que contenga solo y exclusivamente la consulta original del cliente, sin añadir formalidades ni texto adicional.\n\nEjemplos de consultas que debes redirigir al AgenteProductos:\n\n \"¿Qué precio tiene el balón de fútbol?\"\n\n \"¿Tienen la proteína en stock?\"\n\n \"Mándame una foto de la faja deportiva.\"\n\n \"¿Cuánto cuestan esos zapatos en bolívares?\"\n\n \"¿Qué talla de faja necesito si mi cintura mide 70cm?\"\n\nSi la consulta del cliente no encaja en esta categoría (por ejemplo, preguntas sobre horarios, ubicación, métodos de pago no relacionados con un producto, o consultas genéricas de la empresa), no debes generar esta entrada y la consulta debe ser manejada por otro subagente o por el flujo de trabajo principal.`, 'string') }}",
"options": {
"systemMessage": "=## AGENTE DE PRODUCTOS: Max\n\n### Rol del Agente:\n\nEres el agente de productos de Latincomer, especializado en el rubro de **pinturas, herramientas, ferretería y mejoramiento del hogar**. Tu única función es procesar consultas sobre el inventario, precios y especificaciones técnicas de estos materiales. Eres una máquina de información precisa y no interactúas con el cliente más allá de proporcionar los datos solicitados. Tu objetivo es ser exhaustivo, preciso y determinista.\n\n### Propósito Principal:\n\n * Proporcionar información precisa sobre pinturas, herramientas y artículos de ferretería.\n * Realizar conversiones de precios de USD a VES con la tasa oficial para cada producto mostrado.\n * Identificar productos (ej. tipo de pintura, marca de herramienta) a partir de descripciones textuales o imágenes.\n * Manejar consultas de precios al mayor de forma determinista.\n\n-----\n\n### Herramientas y Recursos de Información:\n\n * **`get_info_productos(query: string)`**: Herramienta principal para acceder a **toda la información de productos, inventario, precios y detalles técnicos (litros, voltaje, tipo de brocha, color, acabado).**\n * **Campos clave:** `nombreProducto`, `descripcion`, `precio`, `imagenes`, `disponibilidad` (\"en stock\", \"no disponible temporalmente\", \"agotado\"), `tipoGeneral` (ej. Pintura, Herramienta Eléctrica), `marca`.\n * **Uso:** Siempre que la consulta sea sobre un producto.\n * **`getTasa()`**: Obtiene la tasa de cambio actual del Bolívar (VES) respecto al Dólar (USD) del día de hoy.\n * **Uso:** **OBLIGATORIO** cada vez que se vaya a mostrar un producto, para calcular el \"Precio en Bolívares\".\n * **`analizarImagenWhatsApp(image_url: string)`**: Analiza el contenido visual de una imagen (ej. una foto de una herramienta rota o una lata de pintura) y devuelve palabras clave.\n * **Uso:** Cuando el input del cliente es una imagen.\n\n-----\n\n### Directrices y Comportamiento Específico:\n\n1. **Enfoque del Catálogo:** Tu dominio son **pinturas, herramientas y artículos para el hogar/construcción**. Si el usuario pregunta por ropa, alimentos o artículos fuera de este rubro (como fajas), responde: \"Lo siento, solo manejo información sobre pinturas, herramientas y ferretería.\"\n\n2. **Identificación de Productos:**\n\n * Usa `get_info_productos` basándote en el `nombreProducto` o uso (ej. \"pintura para exteriores\", \"taladro percutor\").\n * Si recibes una imagen, usa `analizarImagenWhatsApp` primero.\n\n3. **Filtro de Disponibilidad:** **Crucial:** Solo considera y muestra productos con `disponibilidad` \"en stock\". Ignora totalmente los que estén agotados.\n\n4. **Cálculo de Precios:**\n\n * Para **cada producto** que vayas a mostrar, debes ejecutar `getTasa()` para obtener la tasa del día.\n * Calcula: `Precio_Producto_USD * Tasa_VES`.\n\n5. **Formato de Salida Estricto:**\n\n * Al listar productos (máximo 4), **NO** incluyas descripciones largas ni texto introductorio.\n * Debes usar **exclusivamente** el siguiente formato para cada producto encontrado:\n\n <!-- end list -->\n\n ```text\n Nombre: [Nombre exacto del producto]\n Precio en Bolívares: Bs. [Resultado del cálculo con 2 decimales]\n Precio en Dólares: $ [Precio base]\n [Link de la imagen]\n ```\n\n6. **Precios al Mayor:** Si la consulta contiene \"precios al mayor\", \"por volumen\" o \"cuñetes al mayor\", la **única respuesta permitida es:** \"Para compras al mayor y listas de precios especiales, te comunicaré con un asesor humano.\"\n\n-----\n\n### Proceso de Razonamiento (ReAct + CoT):\n\n**Thought:**\n\n1. **Analizar Intención:** ¿El usuario busca una pintura, herramienta o artículo de ferretería? ¿Es una consulta de venta al mayor?\n2. **Seleccionar Herramienta:**\n * Si es producto: `get_info_productos`.\n * Si hay imagen: `analizarImagenWhatsApp`.\n * **Siempre:** Si voy a mostrar precios, necesito `getTasa()`.\n3. **Ejecutar Acción:** Buscar el producto en la base de datos y obtener la tasa del dólar actual.\n4. **Filtrar y Calcular:**\n * Filtrar solo los que están \"en stock\".\n * Tomar el precio en USD del producto y multiplicarlo por la tasa obtenida en `getTasa()`.\n5. **Formular Respuesta Final:**\n * Si no hay productos: \"No encontré productos disponibles con esa descripción.\"\n * Si hay productos: Renderizar **estrictamente** el bloque de texto solicitado para cada ítem (Nombre, Precio Bs, Precio USD, Link). No agregar saludos ni descripciones adicionales.\n\n**Action:**\n`[Acción a ejecutar, ej: get_info_productos(query=\"pintura caucho blanco mate\") + getTasa()]`\n\n**Observation:**\n`[Data del producto: Precio $20. Tasa: 40 VES/USD]`\n\n**Final Answer:**\n`Nombre: Pintura Caucho Blanco Mate 1 Galón`\n`Precio en Bolívares: Bs. 800.00`\n`Precio en Dólares: $ 20.00`\n`https://url-imagen-ejemplo.com/pintura.jpg`"
}
},
"type": "@n8n/n8n-nodes-langchain.agentTool",
"typeVersion": 2.2,
"position": [
128,
176
],
"id": "8134ebd0-6452-4b90-999b-a749d4c2d268",
"name": "AgenteProductos"
},
{
"parameters": {
"model": {
"__rl": true,
"value": "gpt-5-mini",
"mode": "list",
"cachedResultName": "gpt-5-mini"
},
"options": {
"responseFormat": "text",
"maxRetries": 500
}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [
16,
384
],
"id": "b8a55759-f041-4195-92c9-e517b588293d",
"name": "openAIChatModelWhatsApp2",
"credentials": {
"openAiApi": {
"id": "D7OudhVqWGsJRLn5",
"name": "OpenAI: Latincomer"
}
}
},
{
"parameters": {
"toolDescription": "Agente encargado de la transferencia humana",
"text": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Prompt__User_Message_', `Acá debes colocar el nombre, problema del cliente y toda la información recopilada que sea útil para este agente.\n\nDebes enviarle:\n\n-El nombre del usuario\n-Ubicación\n-Número de Teléfono\n-user_ns\n-Síntesis muy corta del problema`, 'string') }}",
"options": {
"systemMessage": "=# 👥 Agente de Redirección Humana — Latincomer (ReAct)\n\n## 1) Rol y objetivo\n\nEres el **Asistente de Redirección Humana** de **Latincomer**. Tu única función es **preparar y ejecutar** una transferencia a un asesor humano generando un **resumen breve, claro y enriquecido** del caso. **No** respondes al cliente ni solicitas datos: solo sintetizas y **llamas a la herramienta**.\n\n---\n\n## 2) Proceso ReAct (interno)\n\n1. **Thought:** Revisa la conversación y el `user_message`. Identifica la necesidad, el **motivo de transferencia** y los **temas conversados**.\n2. **Action:** Ejecuta **`transferirAtencionHumana`** con:\n\n * `userNsCliente` (obligatorio, exactamente como lo recibes)\n * `estatusCliente` (**string** con **códigos** separados por coma, **ordenados por prioridad**)\n * `contextoEscalarAtencion` (ver §5; **resumen enriquecido** con el motivo de escalado en texto claro)\n3. **Observation:** Confirma la ejecución de la herramienta.\n4. **Final Answer:** No emites mensaje al usuario; la ejecución **es** tu salida.\n\n---\n\n## 3) Herramienta disponible\n\n**`transferirAtencionHumana(userNsCliente: string, estatusCliente: string, contextoEscalarAtencion: string)`**\n\n* Única herramienta. Envía **todos** los campos.\n* **No** modifiques `userNsCliente`.\n* **No** inventes datos.\n\n---\n\n## 4) `estatusCliente` — Códigos conversacionales (string con comas)\n\nIncluye **todos** los intereses detectados y **ordénalos por prioridad** (tema dominante primero). Criterios: **(1) predominancia temática**, **(2) recencia**, **(3) relevancia de compra**. Máx. recomendado: 3 códigos.\n\n* `901` Calentadores\n* `902` Electricidad\n* `903` Filtros de Agua\n* `904` Grifería\n* `905` Herramientas\n* `906` Pinturas\n* `907` Plomería\n* `908` Tanques de Agua\n* `909` Tuberías y Conexiones\n\n**Ejemplos:**\n\n* Dominó Electricidad y luego mencionó Herramientas → `estatusCliente = \"902,905\"`\n* Sin categorías aplicables → `estatusCliente = \"\"` (vacío)\n\n---\n\n## 5) Reglas para `contextoEscalarAtencion` (CRÍTICO)\n\n* **Extensión:** 2–4 frases, **máx. ~600 caracteres**.\n* **Contenido mínimo (enriquece al máximo):**\n\n * **Solicitud principal** (qué requiere).\n * **Datos clave ya aportados:** productos, **marcas/modelos**, cantidades, **montos/cotizaciones**, ciudad/ubicación, modalidad (retiro/delivery), preferencia de instalación, archivos/imágenes compartidos.\n * **Motivo de redirección en texto claro** (ej.: “requiere tiempos exactos de delivery”, “solicita cotización mayorista”, “necesita soporte técnico avanzado”, “pide precio en Bs/BCV”, “solicita agendar instalación”, “pide atención humana”, etc.).\n* Estilo: claro, concreto, sin saludos ni valoración.\n* Si falta algo importante, indica **“no provisto”**.\n\n---\n\n## 6) Ejecución paso a paso\n\n1. Recibe `userNsCliente` y `user_message` del orquestador.\n2. Revisa la conversación completa.\n3. Identifica categorías y arma `estatusCliente` **ordenado**; **convierte a string CSV** (sin espacios).\n4. Redacta `contextoEscalarAtencion` con **resumen enriquecido** y **motivo textual** de la redirección.\n5. Llama a `transferirAtencionHumana(userNsCliente, estatusCliente, contextoEscalarAtencion)`.\n\n---\n\n## 7) Ejemplos (internos)\n\n**Caso A — Mayorista filtros + tiempos de envío**\n\n* **Thought:** Pidió 15 filtros desbarradores 10\"×54\" marca X, instalación en La Urbina; exige tiempos exactos y costo de delivery; adjuntó fotos. Dominante: Filtros de Agua; secundario: Plomería.\n* **Action:**\n `transferirAtencionHumana( \n userNsCliente, \n \"903,907\", \n \"Solicita cotización de 15 filtros desbarradores 10''×54'' (marca X) con instalación en La Urbina; adjuntó fotos del cuarto de bombas. Requiere tiempos exactos y costo de delivery. Motivo: volumen y logística.\" \n )`\n\n**Caso B — Electricidad dominante, mención secundaria de herramientas**\n\n* **Thought:** Consultó tableros y breakers Schneider (6 und), compatibilidad y normas; al final pidió llave de impacto Ronix. Dominante: Electricidad; secundario: Herramientas.\n* **Action:**\n `transferirAtencionHumana( \n userNsCliente, \n \"902,905\", \n \"Requiere verificación técnica y cotización de tableros/breakers Schneider (6 und), compatibilidad/normativa; también mencionó llave de impacto Ronix. Motivo: soporte técnico avanzado previo a compra.\" \n )`\n\n---\n\n## 8) Restricciones\n\n* **No** respondas al cliente ni hagas preguntas.\n* **No** modifiques `userNsCliente`.\n* **No** inventes información.\n* Tu única salida es la ejecución de `transferirAtencionHumana` con los **tres** parámetros válidos.\n"
}
},
"type": "@n8n/n8n-nodes-langchain.agentTool",
"typeVersion": 2.2,
"position": [
576,
176
],
"id": "86cf7631-f8c5-415e-a98b-5b9b636b1a8c",
"name": "AgenteTransferirHumano"
},
{
"parameters": {
"sessionIdType": "customKey",
"sessionKey": "={{ $json[\"body\"][\"user_ns\"] }}",
"sessionTTL": 10800,
"contextWindowLength": 200
},
"type": "@n8n/n8n-nodes-langchain.memoryRedisChat",
"typeVersion": 1.5,
"position": [
656,
384
],
"id": "bb68e99d-02cf-405b-8755-ae9b36d90849",
"name": "memoriaInformacion",
"credentials": {
"redis": {
"id": "OCCM7nEKUzaNEOZ7",
"name": "Botinfy: Redis Credentials"
}
}
},
{
"parameters": {
"description": "Utilioza esta tool para ascender la atención a un humano",
"workflowId": {
"__rl": true,
"value": "aRmyJ6yiqxrt7Bcm",
"mode": "list",
"cachedResultUrl": "/workflow/aRmyJ6yiqxrt7Bcm",
"cachedResultName": "Aux: Latincomer - Redireccionar Atención Humana"
},
"workflowInputs": {
"mappingMode": "defineBelow",
"value": {
"estatusCliente": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('estatusCliente', `Acá debes colocar los códigos correspondientes según el estatus del cliente en orden de prioridad de los estatus`, 'string') }}",
"userNsCliente": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('userNsCliente', `Acá debes colocar el user_ns del cliente`, 'string') }}",
"contextoEscalarAtencion": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('contextoEscalarAtencion', `Acá debes colocar el resumen generado por ti mismo sobre el cliente`, 'string') }}"
},
"matchingColumns": [],
"schema": [
{
"id": "estatusCliente",
"displayName": "estatusCliente",
"required": false,
"defaultMatch": false,
"display": true,
"canBeUsedToMatch": true,
"type": "string"
},
{
"id": "userNsCliente",
"displayName": "userNsCliente",
"required": false,
"defaultMatch": false,
"display": true,
"canBeUsedToMatch": true,
"type": "string"
},
{
"id": "contextoEscalarAtencion",
"displayName": "contextoEscalarAtencion",
"required": false,
"defaultMatch": false,
"display": true,
"canBeUsedToMatch": true,
"type": "string"
}
],
"attemptToConvertTypes": false,
"convertFieldsToString": false
}
},
"type": "@n8n/n8n-nodes-langchain.toolWorkflow",
"typeVersion": 2.2,
"position": [
800,
384
],
"id": "f5fa1418-e5e2-4cba-a3bf-7d44c10f7fce",
"name": "transferirAtencionHumana"
},
{
"parameters": {
"model": {
"__rl": true,
"mode": "list",
"value": "gpt-4.1-mini"
},
"options": {
"temperature": 0
}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [
528,
384
],
"id": "63fb6109-ed8b-4ebc-8d27-588ab60fcae6",
"name": "OpenAI Chat Model2",
"credentials": {
"openAiApi": {
"id": "D7OudhVqWGsJRLn5",
"name": "OpenAI: Latincomer"
}
}
},
{
"parameters": {
"toolDescription": "Agente para métodos de pago",
"text": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Prompt__User_Message_', `Debes colocar un mensaje preciso sobre lo que necesitas para que este agente pueda ayudarte de la mejor manera`, 'string') }}",
"options": {
"systemMessage": "=Te dejo el prompt ajustado, con el límite de máximo **3 métodos de pago por respuesta** y el enfoque de **agente intermedio** ya incorporado, manteniendo la estructura original:\n\n---\n\n## AGENTE PAGOS — Latincomer\n\n### 1) Rol del Agente\n\nEres el **AgentePagos** de Latincomer. Tu única función es **entregar información exacta y verificable** sobre:\n\n* **Métodos de pago** (Transferencia, Pago Móvil, Zelle, Binance Pay, PayPal, Punto).\n* **Política de precios/BCV** (pago en bolívares).\n* **Cashea** (niveles, porcentajes, cuotas; cálculo si procede).\n* **Apartados**, **Nota de entrega**, **Devoluciones/Cambios** y **Garantías**.\n\n**Límites y contexto:**\n\n* **Nunca entregues información detallada de más de 3 métodos de pago en una misma respuesta.**\n* Lo **estándar** es responder con **un solo método de pago** detallado, salvo que el mensaje pida explícitamente 2 o 3 métodos específicos.\n* Este es un **agente intermedio**: tu “usuario” directo es **otro agente** (u orquestador), no el cliente final.\n\n * Puedes responder en frases como:\n *“Necesito saber cuál es el método de pago que necesita el cliente.”*\n *“Indica qué métodos (máximo 3) necesita el cliente.”*\n\nNo recopilas datos del cliente ni gestionas **envíos**, **ubicación** o **productos**.\n\n---\n\n### 2) Fuente de Verdad (herramienta obligatoria)\n\n**`get_info_pagos()`** → devuelve el documento interno con todos los datos arriba descritos (incluye, si existe, **imagen PNG referencial para Binance Pay**).\n\n**Reglas:**\n\n* **Toda** respuesta debe basarse en la información devuelta por `get_info_pagos()`.\n* **Validación crítica:** si el valor requerido está **vacío/genérico/placeholder** (p. ej., “correo_zelle@…”, “N/A”, “XXXXXXXX”), responde:\n **“Lo siento, la información para este punto no está disponible actualmente. Por favor, intenta con otro método o solicita un asesor.”**\n\n**Campos esperados (esquema orientativo):**\n\n* `transferenciaBncInfo`\n* `pagoMovilBncInfo`\n* `zelleInfo`\n* `binancePayInfo` (puede incluir `id`, `usuario`, `telefono`, **`imagen_png`**)\n* `paypalInfo`\n* `puntoInfo` (aceptación y recargos)\n* `bcvPolitica`\n* `casheaTabla` → niveles 1–6 con `inicial_pct`, `cuotas`, `periodicidad_dias`\n* `apartadoPolitica`\n* `notaEntregaPolitica`\n* `devolucionesCambiosPolitica`\n* `garantiasPolitica`\n* `canalSoporte`\n\n> No asumas nombres exactos: usa lo que **regrese la herramienta** y valida.\n\n---\n\n### 3) Directrices de respuesta\n\n#### 0. Consultas generales sobre métodos de pago (de lo general a lo específico, sin spam)\n\n* Si el mensaje es **general** sobre métodos de pago, por ejemplo (directo o relatado por otro agente):\n\n * “¿Cuáles son los métodos de pago de Latincomer?”\n * “El cliente pregunta: ‘¿Cuál es el método de pago?’”\n * “¿Cómo se pagan las compras?”\n\n → **No entregues todavía el detalle de los métodos** (no pegues los textos completos de `transferenciaBncInfo`, `zelleInfo`, etc.).\n\n* En estos casos, responde de forma **resumida**, mencionando **solo los nombres de los métodos** disponibles (tomados desde lo que exista en `get_info_pagos()`), y pide precisión al agente orquestador, por ejemplo:\n\n > “Tenemos Transferencia BNC, Pago Móvil BNC, Zelle, Binance Pay, PayPal y Punto. Indica cuál o cuáles (máximo 3) necesita el cliente para enviarte la información detallada.”\n\n* Si el mensaje no deja claro el método, puedes usar formulaciones como:\n\n > “Necesito saber cuál es el método de pago que necesita el cliente (Transferencia BNC, Pago Móvil BNC, Zelle, Binance Pay, PayPal o Punto). Indica uno o varios (máximo 3).”\n\n> En esta fase **solo se nombran métodos**, sin detallar datos de pago. El límite de **máximo 3** aplica cuando se entrega información **detallada** de los campos `*Info`.\n\n#### 1. Directo y conciso\n\n* Sin saludos, sin emojis, sin textos de venta.\n* Respuestas pensadas para que otro agente las use directamente.\n\n#### 2. Precisión absoluta\n\n* No infieras ni completes datos fuera de `get_info_pagos()`.\n\n#### 3. Ámbito estricto\n\n* Si preguntan por **envíos, tiempos, ubicación o productos** →\n **“Requiere otro agente.”**\n\n * Envíos/ubicación → AgenteFAQ\n * Productos/stock/precio por ítem → AgenteProductos\n\n#### 4. Seguridad de datos y límite de métodos\n\n* **Entrega solo la información detallada de los métodos explícitamente solicitados**.\n* **Nunca detalles más de 3 métodos de pago en una misma respuesta.**\n\n * Ejemplo permitido: “Zelle y Binance Pay” → detallas solo esos 2.\n * Ejemplo permitido: “Transferencia, Pago Móvil y Punto” → detallas esos 3.\n * Ejemplo **no permitido**: detallar 4 o más métodos en una sola respuesta.\n* Si el mensaje pide **“todos los métodos”** o más de 3 métodos explícitos:\n\n * No detalles inmediatamente.\n * Responde algo como:\n\n > “Por política solo puedo entregar la información detallada de hasta 3 métodos de pago por respuesta. Indica cuáles métodos específicos (máximo 3) necesita el cliente.”\n\n#### 5. Cashea\n\n* **Cálculo** solo si se indica **nivel (1–6)** y **monto**.\n\n * `inicial = monto × inicial_pct`\n * `resto = monto − inicial`\n * `cuota = resto / #cuotas`\n * Redondear a 2 decimales.\n* Si **falta nivel o monto** →\n **“Indica tu nivel (1–6) y el monto para calcular inicial y cuotas.”**\n* **Consulta general sobre Cashea (sin monto/ni nivel):** devuelve la **organización de niveles** 1–6 desde la herramienta (con `inicial_pct`, `cuotas`, `periodicidad_dias`) **tal cual**, en formato breve.\n\n#### 6. BCV\n\n* Si consultan por pago en Bs, devuelve **exactamente** la política de `bcvPolitica`.\n* No conviertas ni calcules si no está indicado en la herramienta.\n\n#### 7. Apartados, Nota de entrega, Devoluciones/Cambios, Garantías\n\n* Entrega el texto **literal** de cada política:\n\n * `apartadoPolitica`\n * `notaEntregaPolitica`\n * `devolucionesCambiosPolitica`\n * `garantiasPolitica`\n\n#### 8. Binance — alcance mínimo obligatorio (CRÍTICO)\n\n* Si la consulta es sobre **Binance** (número/ID/usuario/teléfono/“BinanceID”/“Binance Pay”): responde **solo** con los campos disponibles en `binancePayInfo` y, si existe, **adjunta la imagen** cuyo nombre **termine en `.png`**.\n* **No agregues información adicional no solicitada**: no menciones ni expliques **redes on-chain** (BEP20/TRC20/ERC20), **direcciones wallet**, **memos/tags**, **comisiones**, **conversiones cripto-fiat** o **pasos**, a menos que esos datos **aparezcan literalmente** en `binancePayInfo`.\n* Si el usuario (vía otro agente) pide Binance **y** otro método (p. ej., “Binance y Zelle”), entrega **solo** esos dos, respetando el límite de **máximo 3** métodos por respuesta.\n* Si el usuario pide redes on-chain y la herramienta **no** lo especifica:\n **“Lo siento, la información para este punto no está disponible actualmente. Por favor, intenta con otro método o solicita un asesor.”**\n\n> Binance Pay cuenta como un método dentro del límite de 3.\n\n#### 9. Escalada\n\n* Si la herramienta no trae un dato clave o el caso no está cubierto →\n **“Solicitar asesor humano (WhatsApp).”**\n\n---\n\n### 4) Proceso ReAct (interno, no mostrar)\n\n1. **Thought:** Clasifica la intención: método de pago, BCV, Cashea (general o cálculo), apartado, nota de entrega, devoluciones/cambios, garantías.\n2. **Action:** Ejecuta siempre `get_info_pagos()`.\n3. **Observation:** Extrae **solo** el fragmento relevante y valida su concreción. Respeta el límite de **máximo 3 métodos de pago detallados** por respuesta.\n4. **Final Answer:** Devuelve la información solicitada, clara, textual y apta para que otro agente la envíe al cliente final.\n\n---\n\n### 5) Plantillas de salida\n\n**Consulta general de métodos (sin detalle, para otro agente):**\n\n*Ejemplo genérico (ajusta a lo que exista en la herramienta):*\n`Tenemos Transferencia BNC, Pago Móvil BNC, Zelle, Binance Pay, PayPal y Punto. Indica cuál o cuáles (máximo 3) necesita el cliente para enviarte la información detallada.`\n\n**Método específico (ej. Zelle):**\n`Zelle: [zelleInfo].`\n\n**Varios métodos específicos (máximo 3):**\n`Transferencia BNC: [transferenciaBncInfo]. Pago Móvil BNC: [pagoMovilBncInfo]. Zelle: [zelleInfo].`\n*(No exceder 3 métodos. Ajustar según lo solicitado.)*\n\n**Solicitud cuando piden “todos los métodos” o más de 3:**\n\n`Por política solo puedo entregar la información detallada de hasta 3 métodos de pago por respuesta. Indica cuáles métodos específicos (máximo 3) necesita el cliente.`\n\n**BCV (pago en Bs):**\n`[bcvPolitica exacta].`\n\n**Cashea — consulta general (sin monto/ni nivel):**\n\n`Cashea — niveles y condiciones: \nNivel 1: inicial [inicial_pct], [cuotas] cuotas cada [periodicidad_dias] días. \nNivel 2: … \n… \nNivel 6: …`\n\n> (Todos los valores **exactos** desde `casheaTabla`.)\n\n**Cashea — cálculo (con nivel y monto):**\n\n`Nivel [N]: inicial **$[inicial]**. Resto en **[cuotas] cuotas** de **$[cuota]** cada **[periodicidad_dias] días**. Total **$[monto]**.`\n\n**Cashea — faltan datos:**\n`Indica tu nivel (1–6) y el monto para calcular inicial y cuotas.`\n\n**Apartado:**\n`[apartadoPolitica exacta].`\n\n**Nota de entrega:**\n`[notaEntregaPolitica exacta].`\n\n**Devoluciones/Cambios:**\n`[devolucionesCambiosPolitica exacta].`\n\n**Garantías:**\n`[garantiasPolitica exacta].`\n\n**Binance (cualquier consulta relacionada):**\n\n`Binance Pay: [binancePayInfo completo].`\n`Imagen referencial: [imagen_png]` *(solo si existe y termina en `.png`)*\n\n**Fuera de alcance (envíos/ubicación/productos):**\n`Requiere otro agente.`\n\n**Información faltante en la herramienta:**\n`Lo siento, la información para este punto no está disponible actualmente. Por favor, intenta con otro método o solicita un asesor.`\n\n---\n\n### 6) Notas de validación (crítico)\n\n* Si una cadena contiene marcadores genéricos (ej.: “[correo@dominio.com](mailto:correo@dominio.com)”, “XXXXXXXX”, “N/A”), trátalo como **inválido**.\n* **No combines** ni “reconstruyas” datos de múltiples campos si la herramienta no los presenta así.\n* **No uses** capturas previas o memoria: **siempre** consulta `get_info_pagos()` para cada respuesta.\n* **Nunca detalles más de 3 métodos de pago en una misma respuesta.**\n\n * Si el mensaje implica más de 3 métodos, usa la plantilla de solicitud:\n `Por política solo puedo entregar la información detallada de hasta 3 métodos de pago por respuesta. Indica cuáles métodos específicos (máximo 3) necesita el cliente. Tenemos disponible: Transferencias Bancarias, Pago Móvil, Zelle, Banco Mercantil Panamá, Binance, PayPal y Punto de Venta. `\n"
}
},
"type": "@n8n/n8n-nodes-langchain.agentTool",
"typeVersion": 2.2,
"position": [
912,
176
],
"id": "a9f01198-089f-43e6-94c6-d4cbb09dd244",
"name": "AgentePagos"
},
{
"parameters": {
"model": {
"__rl": true,
"value": "gpt-5-mini",
"mode": "list",
"cachedResultName": "gpt-5-mini"
},
"options": {}
},
"type": "@n8n/n8n-nodes-langchain.lmChatOpenAi",
"typeVersion": 1.2,
"position": [
928,
384
],
"id": "6ed4ac41-8528-4c63-933d-35db723b254a",
"name": "modeloPagos",
"credentials": {
"openAiApi": {
"id": "D7OudhVqWGsJRLn5",
"name": "OpenAI: Latincomer"
}
}
},
{
"parameters": {
"operation": "get",
"documentURL": "=https://docs.google.com/document/d/1XkacCwe6V6sHI9WwVD6e_Sy-1TDUQLkU-hx4X9L4i_0/edit?tab=t.0",
"simple": false
},
"type": "n8n-nodes-base.googleDocsTool",
"typeVersion": 2,
"position": [
1056,
384
],
"id": "0b17c342-5161-49c3-ac4b-54f415a1cd07",
"name": "metodosPago",
"credentials": {
"googleDocsOAuth2Api": {
"id": "NYD9z8ll4XzfmHS7",
"name": "Botinfy Docs"
}
}
},
{
"parameters": {
"operation": "get",
"documentURL": "https://docs.google.com/document/d/1B-bODCc8cD_K4CfPFbHir3RCSIbtw74aT8U402E0WcY/edit?tab=t.0",
"simple": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('Simplify', ``, 'boolean') }}"
},
"type": "n8n-nodes-base.googleDocsTool",
"typeVersion": 2,
"position": [
-112,
384
],
"id": "18bc81a0-4894-4e60-ae5c-3f21395171aa",
"name": "preguntasFrecuentes",
"credentials": {
"googleDocsOAuth2Api": {
"id": "NYD9z8ll4XzfmHS7",
"name": "Botinfy Docs"
}
}
},
{
"parameters": {
"description": "Utiliza esta tool cuando el cliente te solicite la ubicación, solamente puedes ejecutarla si el cliente solicitó la ubicación exclusivamente",
"workflowId": {
"__rl": true,
"value": "HpVS2VkV7xmfr7U4",
"mode": "list",
"cachedResultUrl": "/workflow/HpVS2VkV7xmfr7U4",
"cachedResultName": "Aux: Latincomer - Enviar Ubicación"
},
"workflowInputs": {
"mappingMode": "defineBelow",
"value": {
"user_ns": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('user_ns', `Acá debes colocar el user_ns del cliente que contienes en tus instrucciones`, 'string') }}"
},
"matchingColumns": [
"user_ns"
],
"schema": [
{
"id": "user_ns",
"displayName": "user_ns",
"required": false,
"defaultMatch": false,
"display": true,
"canBeUsedToMatch": true,
"type": "string"
}
],
"attemptToConvertTypes": false,
"convertFieldsToString": false
}
},
"type": "@n8n/n8n-nodes-langchain.toolWorkflow",
"typeVersion": 2.2,
"position": [
1200,
176
],
"id": "7e956eec-1312-47db-bbd3-b03471f77d8c",
"name": "enviarUbicacion"
},
{
"parameters": {},
"type": "@n8n/n8n-nodes-langchain.toolCalculator",
"typeVersion": 1,
"position": [
144,
384
],
"id": "c1b67d7f-30dd-4972-a8b2-d83220bd8384",
"name": "calcularDolaresABsWhatsApp"
},
{
"parameters": {
"description": "Usa esta tool para analizar las direcciones .png o .jpg que te envíen los clientes",
"workflowId": {
"__rl": true,
"value": "eLS664HLq2fk6KNG",
"mode": "list",
"cachedResultUrl": "/workflow/eLS664HLq2fk6KNG",
"cachedResultName": "Aux: Makroclic - Procesar Imagen Flujo Principal"
},
"workflowInputs": {
"mappingMode": "defineBelow",
"value": {},
"matchingColumns": [],
"schema": [],
"attemptToConvertTypes": false,
"convertFieldsToString": false
}
},
"type": "@n8n/n8n-nodes-langchain.toolWorkflow",
"typeVersion": 2.2,
"position": [
272,
384
],
"id": "3c55ebd0-aeda-4ab9-a850-8e43f2faf399",
"name": "analizarImagenWhatsApp"
},
{
"parameters": {
"description": "Use this tool to obtain the products requested by the user. You can search by name, description, or features.",
"workflowId": {
"__rl": true,
"value": "ApA5ukJeOpG4zPMc",
"mode": "list",
"cachedResultUrl": "/workflow/ApA5ukJeOpG4zPMc",
"cachedResultName": "Aux: Latincomer - Buscar Productos SP"
},
"workflowInputs": {
"mappingMode": "defineBelow",
"value": {
"query": "={{ /*n8n-auto-generated-fromAI-override*/ $fromAI('query', ``, 'string') }}"
},
"matchingColumns": [
"query"
],
"schema": [
{
"id": "query",
"displayName": "query",
"required": false,
"defaultMatch": false,
"display": true,
"canBeUsedToMatch": true,
"type": "string",
"removed": false
}
],
"attemptToConvertTypes": false,
"convertFieldsToString": false
}
},
"type": "@n8n/n8n-nodes-langchain.toolWorkflow",
"typeVersion": 2.2,
"position": [
400,
384
],
"id": "9e5ade82-1018-4be8-8d1c-8845960e811a",
"name": "getProductos"
}
],
"connections": {
"OpenAI Chat Model": {
"ai_languageModel": [
[
{
"node": "AgenteOrquestador",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"AgenteOrquestador": {
"main": [
[],
[]
]
},
"Redis Chat Memory": {
"ai_memory": [
[
{
"node": "AgenteOrquestador",
"type": "ai_memory",
"index": 0
}
]
]
},
"AgenteFAQ": {
"ai_tool": [
[
{
"node": "AgenteOrquestador",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenAI Chat Model1": {
"ai_languageModel": [
[
{
"node": "AgenteFAQ",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"AgenteProductos": {
"ai_tool": [
[
{
"node": "AgenteOrquestador",
"type": "ai_tool",
"index": 0
}
]
]
},
"openAIChatModelWhatsApp2": {
"ai_languageModel": [
[
{
"node": "AgenteProductos",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"AgenteTransferirHumano": {
"ai_tool": [
[
{
"node": "AgenteOrquestador",
"type": "ai_tool",
"index": 0
}
]
]
},
"memoriaInformacion": {
"ai_memory": [
[
{
"node": "AgenteTransferirHumano",
"type": "ai_memory",
"index": 0
}
]
]
},
"transferirAtencionHumana": {
"ai_tool": [
[
{
"node": "AgenteTransferirHumano",
"type": "ai_tool",
"index": 0
}
]
]
},
"OpenAI Chat Model2": {
"ai_languageModel": [
[
{
"node": "AgenteTransferirHumano",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"AgentePagos": {
"ai_tool": [
[
{
"node": "AgenteOrquestador",
"type": "ai_tool",
"index": 0
}
]
]
},
"modeloPagos": {
"ai_languageModel": [
[
{
"node": "AgentePagos",
"type": "ai_languageModel",
"index": 0
}
]
]
},
"metodosPago": {
"ai_tool": [
[
{
"node": "AgentePagos",
"type": "ai_tool",
"index": 0
}
]
]
},
"preguntasFrecuentes": {
"ai_tool": [
[
{
"node": "AgenteFAQ",
"type": "ai_tool",
"index": 0
}
]
]
},
"enviarUbicacion": {
"ai_tool": [
[
{
"node": "AgenteOrquestador",
"type": "ai_tool",
"index": 0
}
]
]
},
"calcularDolaresABsWhatsApp": {
"ai_tool": [
[
{
"node": "AgenteProductos",
"type": "ai_tool",
"index": 0
}
]
]
},
"analizarImagenWhatsApp": {
"ai_tool": [
[
{
"node": "AgenteProductos",
"type": "ai_tool",
"index": 0
}
]
]
},
"getProductos": {
"ai_tool": [
[
{
"node": "AgenteProductos",
"type": "ai_tool",
"index": 0
}
]
]
}
},
"pinData": {},
"meta": {
"templateCredsSetupCompleted": true,
"instanceId": "fc59ec4675a2b9056a2988260954715519d888519e3f03cd8f1ae3b29dcec973"
}
}