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

Gestão dinâmica de dados com controle de permissões

🧩 Visão Geral

Este fluxo de trabalho automatiza o processo de gerenciamento de um banco de dados de produtos por meio de uma interface de chat do Telegram com controle dinâmico de permissões. Ele recebe uma mensagem do usuário via webhook do Telegram, verifica suas permissões administrativas a partir de um banco de dados de usuários no Airtable e, em seguida, direciona sua solicitação para um agente de IA. O agente, equipado com ferramentas específicas, pode realizar operações de leitura, criação, atualização ou exclusão em uma base de produtos do Airtable, mas apenas se o usuário tiver as permissões de escrita apropriadas. A resposta final é enviada de volta ao usuário no Telegram.

⚙️ Principais Funcionalidades

Processa solicitações recebidas dos usuários a partir de um chat do Telegram.
Verifica dinamicamente as permissões do usuário a partir de um banco de dados do Airtable antes de processar as solicitações.
Utiliza um agente de IA para interpretar linguagem natural e executar operações apropriadas no banco de dados (CRUD).
Impõe um modelo de segurança baseado em permissões, permitindo ações de escrita apenas para usuários autorizados.
Envia respostas estruturadas, geradas pela IA, de volta ao usuário via Telegram.

🔄 Etapas do Fluxo de Trabalho

Nome do Componente	Função no Fluxo de Trabalho	Entradas Principais	Saídas Principais
Webhook do Telegram	Recebe a mensagem inicial do usuário e metadados do Telegram.	Dados da mensagem recebida do Telegram.	Dados estruturados da mensagem e texto bruto da mensagem.
Analisar Dados (chat id)	Extrai o ID de chat único do usuário a partir dos dados do webhook recebido.	Dados brutos do webhook.	ID de chat formatado.
Airtable (tabela de usuários)	Consulta o banco de dados de usuários para recuperar o perfil e as permissões do usuário com base em seu ID de chat.	ID de chat para filtragem.	Dados do registro do usuário, incluindo permissões de administrador.
Analisar Dados (permissão de escrita)	Extrai o sinalizador específico de permissão de escrita do usuário a partir dos dados do registro do usuário.	Dados do registro do usuário.	Status de permissão de escrita formatado.
Analisar Dados (nome de usuário)	Extrai o nome do usuário a partir dos dados do registro do usuário.	Dados do registro do usuário.	Nome de usuário formatado.
Prompt	Constrói a instrução final para o agente de IA combinando o status de permissão, o nome de usuário e a mensagem original do usuário.	Permissão de escrita, nome de usuário e mensagem original do usuário.	Um prompt estruturado para o agente.
Modelo Google Generative AI	Fornece o modelo de linguagem central que alimenta o raciocínio e a tomada de decisão do agente de IA.	Configuração do modelo (ex: Gemini 2.5 Flash).	Uma instância configurada do modelo de linguagem.
Airtable (ler)	Serve como uma ferramenta para o agente ler registros do banco de dados de produtos.	Configurado como uma ferramenta.	Interface de ferramenta para leitura de dados.
Airtable (criar)	Serve como uma ferramenta para o agente criar novos registros no banco de dados de produtos.	Configurado como uma ferramenta.	Interface de ferramenta para criação de dados.
Airtable (atualizar)	Serve como uma ferramenta para o agente atualizar registros existentes no banco de dados de produtos.	Configurado como uma ferramenta.	Interface de ferramenta para atualização de dados.
Airtable (excluir)	Serve como uma ferramenta para o agente excluir registros do banco de dados de produtos.	Configurado como uma ferramenta.	Interface de ferramenta para exclusão de dados.
Agente Avançado	O agente de IA central que interpreta a solicitação do usuário, seleciona a ferramenta correta com base na intenção e nas permissões e formula uma resposta.	Prompt do sistema, prompt do usuário, modelo de linguagem e ferramentas do Airtable disponíveis.	Uma resposta em texto respondendo à consulta do usuário ou confirmando a ação realizada.
Mensagem do Telegram	Envia a resposta final do agente de volta ao usuário no chat original do Telegram.	Resposta em texto do agente.	Mensagem enviada ao usuário do Telegram.

🧠 Notas

A segurança do fluxo de trabalho é baseada no campo Permisos de administrador no Airtable de usuários. O prompt do sistema do agente instrui explicitamente a realizar operações de escrita apenas se essa permissão for concedida.
O agente é configurado com um prompt de sistema específico que define sua função, as regras de permissão e o formato de resposta esperado.
Todos os componentes do Airtable são configurados no "Modo Ferramenta", tornando-os disponíveis para o agente usar dinamicamente com base na conversa.
O fluxo de trabalho assume credenciais de API pré-configuradas e válidas para os serviços Telegram e Airtable.
A identificação do usuário e a filtragem de permissões dependem de um campo chatid correspondente na mensagem do Telegram e na tabela de usuários do Airtable.