Build AI Business Solutions with Workflow Automation | NappAI - Template: Gestión dinámica de datos con control de permisos

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% GoogleGenerativeAIModel-i707k[Gemini] style GoogleGenerativeAIModel-i707k stroke:#a170ff Airtable-s73yv[tabla de usuarios] style Airtable-s73yv stroke:#a170ff ParseData-cl1k4[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>chat id] style ParseData-cl1k4 stroke:#a170ff Airtable-po2dl[leer] style Airtable-po2dl stroke:#a170ff Prompt-atel3[<div><img src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt] style Prompt-atel3 stroke:#a170ff ParseData-dv38v[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>permiso de escritura] style ParseData-dv38v stroke:#a170ff ParseData-fa09s[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>nombre de usuario] style ParseData-fa09s stroke:#a170ff Airtable-f0dty[crear] style Airtable-f0dty stroke:#a170ff Airtable-l94gq[actualizar] style Airtable-l94gq stroke:#a170ff Airtable-5g9n1[borrar] style Airtable-5g9n1 stroke:#a170ff TelegramMessage-k3ykl[Telegram Message] style TelegramMessage-k3ykl stroke:#a170ff TelegramWebhook-1wmai[Telegram Webhook] style TelegramWebhook-1wmai stroke:#a170ff AdvancedAgent-ob1ay[Agent] style AdvancedAgent-ob1ay stroke:#a170ff ParseData-cl1k4 -.- Airtable-s73yv linkStyle 0 stroke:#a170ff Airtable-s73yv -.- ParseData-dv38v linkStyle 1 stroke:#a170ff Airtable-s73yv -.- ParseData-fa09s linkStyle 2 stroke:#a170ff ParseData-dv38v -.- Prompt-atel3 linkStyle 3 stroke:#a170ff ParseData-fa09s -.- Prompt-atel3 linkStyle 4 stroke:#a170ff TelegramWebhook-1wmai -.- ParseData-cl1k4 linkStyle 5 stroke:#a170ff TelegramWebhook-1wmai -.- Prompt-atel3 linkStyle 6 stroke:#a170ff Prompt-atel3 -.- AdvancedAgent-ob1ay linkStyle 7 stroke:#a170ff Airtable-po2dl -.- AdvancedAgent-ob1ay linkStyle 8 stroke:#a170ff Airtable-f0dty -.- AdvancedAgent-ob1ay linkStyle 9 stroke:#a170ff Airtable-l94gq -.- AdvancedAgent-ob1ay linkStyle 10 stroke:#a170ff Airtable-5g9n1 -.- AdvancedAgent-ob1ay linkStyle 11 stroke:#a170ff GoogleGenerativeAIModel-i707k -.- AdvancedAgent-ob1ay linkStyle 12 stroke:#a170ff AdvancedAgent-ob1ay -.- TelegramMessage-k3ykl linkStyle 13 stroke:#a170ff

Gestión dinámica de datos con control de permisos

🧩 Descripción general

Este flujo de trabajo automatiza el proceso de gestionar una base de datos de productos a través de una interfaz de chat de Telegram con control dinámico de permisos. Recibe un mensaje del usuario a través de un webhook de Telegram, verifica sus permisos administrativos desde una base de datos de usuarios en Airtable, y luego dirige su solicitud a un agente de IA. El agente, equipado con herramientas específicas, puede realizar operaciones de lectura, creación, actualización o eliminación en una base de Airtable de productos, pero solo si el usuario tiene los permisos de escritura apropiados. La respuesta final se envía de vuelta al usuario en Telegram.

⚙️ Características principales

Procesa las solicitudes entrantes de los usuarios desde un chat de Telegram.
Verifica dinámicamente los permisos del usuario desde una base de datos de Airtable antes de procesar las solicitudes.
Utiliza un agente de IA para interpretar el lenguaje natural y ejecutar las operaciones de base de datos apropiadas (CRUD).
Aplica un modelo de seguridad basado en permisos, permitiendo acciones de escritura solo para usuarios autorizados.
Envía respuestas estructuradas, generadas por IA, de vuelta al usuario a través de Telegram.

🔄 Pasos del flujo de trabajo

Nombre del componente	Rol en el flujo de trabajo	Entradas clave	Salidas clave
Webhook de Telegram	Recibe el mensaje inicial del usuario y los metadatos de Telegram.	Datos del mensaje entrante de Telegram.	Datos estructurados del mensaje y texto del mensaje en bruto.
Analizar datos (chat id)	Extrae el ID de chat único del usuario de los datos del webhook entrante.	Datos del webhook en bruto.	ID de chat formateado.
Airtable (tabla de usuarios)	Consulta la base de datos de usuarios para recuperar el perfil y los permisos del usuario basándose en su ID de chat.	ID de chat para filtrar.	Datos del registro del usuario, incluyendo permisos de administrador.
Analizar datos (permiso de escritura)	Extrae el indicador específico de permiso de escritura del usuario de los datos del registro del usuario.	Datos del registro del usuario.	Estado del permiso de escritura formateado.
Analizar datos (nombre de usuario)	Extrae el nombre del usuario de los datos del registro del usuario.	Datos del registro del usuario.	Nombre de usuario formateado.
Prompt	Construye la instrucción final para el agente de IA combinando el estado de permiso del usuario, su nombre de usuario y el mensaje original.	Permiso de escritura, nombre de usuario y mensaje original del usuario.	Un prompt estructurado para el agente.
Modelo Google Generative AI	Proporciona el modelo de lenguaje central que impulsa el razonamiento y la toma de decisiones del agente de IA.	Configuración del modelo (ej., Gemini 2.5 Flash).	Una instancia configurada del modelo de lenguaje.
Airtable (leer)	Sirve como herramienta para que el agente lea registros de la base de datos de productos.	Configurado como una herramienta.	Interfaz de herramienta para leer datos.
Airtable (crear)	Sirve como herramienta para que el agente cree nuevos registros en la base de datos de productos.	Configurado como una herramienta.	Interfaz de herramienta para crear datos.
Airtable (actualizar)	Sirve como herramienta para que el agente actualice registros existentes en la base de datos de productos.	Configurado como una herramienta.	Interfaz de herramienta para actualizar datos.
Airtable (borrar)	Sirve como herramienta para que el agente borre registros de la base de datos de productos.	Configurado como una herramienta.	Interfaz de herramienta para borrar datos.
Agente Avanzado	El agente de IA central que interpreta la solicitud del usuario, selecciona la herramienta correcta basándose en la intención y los permisos, y formula una respuesta.	Prompt del sistema, prompt del usuario, modelo de lenguaje y herramientas de Airtable disponibles.	Una respuesta de texto que responde a la consulta del usuario o confirma la acción tomada.
Mensaje de Telegram	Envía la respuesta final del agente de vuelta al usuario en el chat original de Telegram.	Respuesta de texto del agente.	Mensaje enviado al usuario de Telegram.

🧠 Notas

La seguridad del flujo de trabajo se basa en el campo Permisos de administrador en el Airtable de usuarios. El prompt del sistema del agente le instruye explícitamente a realizar operaciones de escritura solo si se concede este permiso.
El agente está configurado con un prompt del sistema específico que define su rol, las reglas de permisos y el formato de respuesta esperado.
Todos los componentes de Airtable están configurados en "Modo Herramienta", haciéndolos disponibles para que el agente los use dinámicamente basándose en la conversación.
El flujo de trabajo asume credenciales de API preconfiguradas y válidas para los servicios de Telegram y Airtable.
La identificación del usuario y el filtrado de permisos dependen de que coincida un campo chatid en el mensaje de Telegram y en la tabla de usuarios de Airtable.