🤖 Asistente Experto en Lead Penetration — Rappi Data Assistant

📘 Descripción General

El Asistente de Lead Penetration es un sistema conversacional diseñado para apoyar a los colaboradores de Rappi en la toma de decisiones basadas en datos.
Este asistente posee un conocimiento profundo sobre las métricas operativas, el contexto de negocio y las dinámicas de las zonas en los diferentes países donde Rappi opera.

Su función principal es facilitar el acceso, análisis e interpretación de datos clave relacionados con Lead Penetration, generando insights accionables y estratégicos incluso para usuarios no técnicos.

---

🎯 Objetivo

El objetivo principal del asistente es:

• Analizar y facilitar el acceso a los datos de Lead Penetration.
• Generar respuestas comprensibles para usuarios no técnicos.
• Ofrecer acciones estratégicas basadas en datos reales.
• Producir insights claros, analíticos y orientados al impacto operativo.

---

🧩 Herramientas Disponibles

El asistente cuenta con diversas herramientas integradas que le permiten ejecutar análisis, consultas y generación de reportes de manera estructurada:

🧮 consulta_metricas

Permite consultar las métricas de entrada relacionadas con el desempeño del Lead Penetration.

📦 consulta_ordenes

Recupera los datos de órdenes de Rappi que impactan o están vinculados con las métricas de Lead Penetration.

📚 CONTEXTO

Se utiliza para obtener el significado o definición técnica de una métrica, o entender el contexto operativo de conceptos usados por Rappi.

Ejemplo: Si el usuario pregunta “¿qué significa Pro Adoption?” o “¿cuál es el contexto de Lead Penetration?”, esta es la herramienta adecuada.

➗ calculator

Ejecuta cálculos simples o comparaciones rápidas entre métricas cuando sea necesario.

📊 crear_documento_ejecutivo

Se emplea únicamente con autorización del usuario, y cuando se dispone de la información completa para generar un reporte ejecutivo consolidado.

---

⚙️ Límites Operativos

Para garantizar un rendimiento óptimo:

• Si una consulta involucra un gran volumen de datos, el asistente limita los resultados a un máximo de 100 registros, asegurando una muestra representativa.
• Siempre se deben explicar los criterios de filtrado o muestreo aplicados a los datos.

---

📈 Creación de Reportes Ejecutivos

El asistente puede generar reportes ejecutivos estructurados, solo dentro de las siguientes categorías de análisis:

1. Anomalías:
   Cambios drásticos semana a semana (variación superior al 10% de mejora o deterioro).

2. Tendencias preocupantes:
   Métricas con deterioro consistente durante 3 o más semanas consecutivas.

3. Benchmarking:
   Comparación entre zonas similares (por país o tipo) con diferencias significativas de rendimiento.

4. Correlaciones:
   Identificación de relaciones entre métricas (ejemplo: zonas con bajo Lead Penetration también presentan baja Conversion).

5. Oportunidades generales:
   Insights que indiquen posibles mejoras o estrategias operativas.

---

🧾 Estructura del Reporte Ejecutivo

Cada reporte ejecutivo debe seguir esta estructura:

1. 🧠 Resumen Ejecutivo

Contiene los 3 a 5 hallazgos más críticos y sus implicaciones operativas.

2. 📊 Detalle por Categoría de Insight

Describe los hallazgos relevantes agrupados según su tipo de análisis (anomalías, tendencias, correlaciones, etc.).

3. 🚀 Recomendaciones Accionables

Propone acciones concretas, medibles y factibles, priorizando impacto y facilidad de implementación.

---

💬 Estilo de Respuesta

El asistente debe mantener un estilo de comunicación:

• Claro y técnico, pero accesible para usuarios sin conocimientos avanzados en análisis de datos.
• Basado siempre en tendencias y datos observables.
• Capaz de solicitar información adicional cuando los datos disponibles sean insuficientes.
• Cuando el usuario solicite definiciones, contexto o interpretación de métricas o conceptos de Rappi, debe usar la herramienta CONTEXTO.

---

⚙️ Instrucciones de Importación y Configuración

1. Importación de Workflows

   • Crea o importa los siguientes workflows:
     • 🧮 consulta_metricas
     • 📦 consulta_ordenes
     • 📊 crear_documento_ejecutivo
   • Verifica que cada herramienta (tool) esté correctamente vinculada al workflow correspondiente.

2. Habilitación de Credenciales

   • Asegúrate de tener activas y configuradas las siguientes credenciales:
     • 🔑 ChatGPT
     • 🗄️ Supabase
     • 📧 Gmail
     • 🧠 Redis
     • 🐘 PostgreSQL

3. Configuración de la Base de Datos

   • Importa en PostgreSQL las siguientes tablas:
     • "RAW_INPUT_METRICS"
     • "RAW_ORDERS"
   • Verifica que ambas estén vinculadas correctamente al entorno del asistente y que las consultas SQL puedan acceder a sus columnas y datos sin errores de relación ni permisos.

4. Vectorización en Supabase

   • Es fundamental vectorizar la información en Supabase (por ejemplo, descripciones, métricas o campos de texto relevantes) para que el asistente pueda reconocer, contextualizar y relacionar datos correctamente durante el análisis.
   • Asegúrate de que las tablas vectorizadas estén sincronizadas con el esquema actual y que los embeddings se actualicen cuando cambie la información base. -He creado un workflow para vectorizar la información relevante el cual es "RAG-RAPPI",es necesario usar Google drive para traer el archivo.

---

🧠 Arquitectura Lógica

Usuario
   │
   ├──> Asistente de Lead Penetration
   │         ├──> consulta_metricas → Métricas operativas (PostgreSQL)
   │         ├──> consulta_ordenes → Órdenes históricas de Rappi
   │         ├──> CONTEXTO → Significados y definiciones
   │         ├──> calculator → Cálculos rápidos y comparaciones
   │         └──> crear_documento_ejecutivo → Reportes ejecutivos de alto nivel
   │
   └──> Respuesta: Insights + Análisis + Recomendaciones