Infraestructura IA Multi Agente de Gestión Inmobiliaria con n8n

Resumen del Proyecto

Este proyecto es un sistema de backend complejo, sin interfaz de usuario (headless), construido enteramente sobre la plataforma de automatización de flujos de trabajo n8n. El sistema funciona como un "cerebro" operativo que da vida a una plataforma de gestión inmobiliaria, reemplazando tareas manuales con automatizaciones inteligentes.

El núcleo del proyecto es una arquitectura de múltiples agentes de IA, donde cada agente es un conjunto especializado de flujos de trabajo (workflows) en n8n. Un agente "Orquestador" principal recibe todas las peticiones, utiliza IA para comprender la intención del usuario, y delega la tarea al agente especialista correspondiente.

El sistema fue diseñado con la visión de una plataforma IA SaaS (Software como Servicio), donde la lógica de n8n es capaz de gestionar permisos y segregar el acceso a los datos según tres roles clave: Leads (Público), Clientes (Residentes) y Administradores.

Tecnologías Utilizadas

• n8n: La plataforma central para construir, probar y ejecutar todos los flujos de trabajo de automatización. Se utiliza para la orquestación de agentes, la lógica de negocio y la integración de servicios.

• Modelos de Lenguaje (IA): (Inferido) Integrados en los flujos de n8n para potenciar a los agentes. Se utilizan para:

  • Procesamiento de Intenciones (NLU): En el agente Orquestador, para entender qué quiere el usuario.
  • Ejecución de Tareas: En los sub-agentes, para procesar datos o generar respuestas.

• APIs y Webhooks: n8n actúa como el pegamento central, conectándose a APIs de terceros (como un CRM, Google Calendar, Supabase) y utilizando webhooks para recibir y enviar notificaciones en tiempo real.

• Base de Datos (ej. Supabase/PostgreSQL): Los flujos de n8n se conectan a una base de datos central para realizar operaciones CRUD (Crear, Leer, Actualizar, Eliminar) de forma segura.

• Nodos de n8n Utilizados:

  • Nodos Core: Start, IF, Switch, Merge, Code (para lógica compleja).
  • Nodos de IA: (ej. OpenAI, Mistral) para dotar de inteligencia a los agentes.
  • Nodos de Integración: HTTP Request, Webhook, Google Calendar, PostgreSQL/Supabase, Send Email/SMTP.
  • Nodos de Tareas: Cron (para tareas programadas), Read PDF, Edit Image.

Características del Sistema y Arquitectura Multi-Agente

La arquitectura se compone de un orquestador central y agentes especialistas, todos implementados como flujos de n8n.

• Agente Orquestador (Gateway Inteligente):

  • Es el punto de entrada principal (ej. vía un webhook o API).
  • Utiliza un nodo de IA para analizar la intención de la solicitud del usuario.
  • Verifica el rol del usuario (Lead, Cliente, Admin) para validar permisos.
  • Enruta la solicitud al flujo de n8n del agente especialista correcto.

• Agentes Especialistas (Workflows de n8n):

  • 🏢 Agente Ben y Fulcher (Gestión): Flujos para consultar disponibilidad de unidades, agendar visitas (conectándose al agente CRM), y gestionar contratos y renovaciones (conectándose al agente Ava).
  • 🛠️ Agente Alex (Operaciones): Flujos que implementan un sistema de tickets de soporte. Permite a los residentes crear/ver sus tickets y a los admins gestionarlos todos (CRUD completo).
  • ⚡️ Agente Ava (Ejecución): Flujos de "backend" no conversacionales, disparados por otros agentes. Utiliza nodos de generación de PDF y envío de email para crear y enviar facturas y contratos automáticamente.
  • 💰 Agente Rico (Finanzas): Conjunto de flujos seguros, accesibles solo por el rol de Admin, para realizar operaciones CRUD sobre los balances y datos financieros en la base de datos.
  • 📬 Agente CRM: Flujos que se integran con APIs de Calendario (para agendar visitas/mantenimiento) y Contactos (para gestionar la base de datos de usuarios).

• Sistema Proactivo (Webhooks y Cron):

  • Se utilizan nodos Cron en n8n para disparar tareas programadas, como el flujo del agente Ava para la facturación mensual automática.
  • Los flujos de trabajo utilizan HTTP Request para enviar webhooks a sistemas externos (ej. notificar a un canal de Slack) cuando ocurren eventos clave (ej. nuevo ticket de soporte, pago registrado).

Beneficios y Logros

• Automatización de Procesos de Negocio (BPA): Se automatizaron procesos inmobiliarios complejos de extremo a extremo, reduciendo drásticamente la carga de trabajo manual.
• Orquestación de IA (AIOps): Se demostró la capacidad de construir un sistema de IA multi-agente funcional utilizando n8n como la plataforma de orquestación central.
• Arquitectura Escalable (IA SaaS): El diseño de flujos de trabajo basados en roles en n8n sienta las bases para una plataforma SaaS multi-tenant segura y escalable, donde la lógica de negocio y los permisos están centralizados en el backend de automatización.
• Eficiencia de Desarrollo: Se utilizó el enfoque "low-code" de n8n para construir un sistema de backend complejo de forma rápida y eficiente, centrándose en la lógica de integración y de negocio.