Processador de Mensagens não lidas

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% ParseData-ptp7g[<div><img alt="logo" src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Obtener Datos] style ParseData-ptp7g stroke:#a170ff Prompt-7qn0s[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Consulta] style Prompt-7qn0s stroke:#a170ff OpenAIModel-kx9h5[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI] style OpenAIModel-kx9h5 stroke:#a170ff ChatOutput-ugeve[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-ugeve stroke:#a170ff GmailMesageComponent-riqjp[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>Obtener Mensajes] style GmailMesageComponent-riqjp stroke:#a170ff GmailMesageComponent-1gc2u[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>Marcar como leído] style GmailMesageComponent-1gc2u stroke:#a170ff TextInput-1cb9o[<div><img alt="logo" src="/_astro/type.Dy26vmDy.svg" style="height: 20px !important;width: 20px !important"/></div>Tema a comprobar] style TextInput-1cb9o stroke:#a170ff AdvancedAgent-csduv[Agent2] style AdvancedAgent-csduv stroke:#a170ff GmailMesageComponent-riqjp -.- ParseData-ptp7g linkStyle 0 stroke:#a170ff ParseData-ptp7g -.- Prompt-7qn0s linkStyle 1 stroke:#a170ff TextInput-1cb9o -.- Prompt-7qn0s linkStyle 2 stroke:#a170ff Prompt-7qn0s -.- AdvancedAgent-csduv linkStyle 3 stroke:#a170ff AdvancedAgent-csduv -.- ChatOutput-ugeve linkStyle 4 stroke:#a170ff OpenAIModel-kx9h5 -.- AdvancedAgent-csduv linkStyle 5 stroke:#a170ff GmailMesageComponent-1gc2u -.- AdvancedAgent-csduv linkStyle 6 stroke:#a170ff

🧩 Descrição Geral

O fluxo automatiza a leitura de e‑mails no Gmail, formata os dados em texto, gera uma consulta inteligente com o modelo OpenAI e, em seguida, permite que um agente de IA marque os e‑mails como lidos quando apropriado. O resultado é apresentado em um chat interativo, facilitando a tomada de decisão baseada em informações de e‑mail em tempo real.

⚙️ Funcionalidades Principais

Busca e extração de e‑mails a partir de filtros e consultas no Gmail.
Conversão de dados de e‑mail para um formato de texto estruturado.
Criação dinâmica de prompts que combinam a lista de e‑mails e um tema definido pelo usuário.
Processamento do prompt por um agente avançado que utiliza um modelo OpenAI e ferramentas de ação.
Marcação automática de e‑mails como lidos quando o agente determina que a ação é necessária.
Apresentação do resultado em um chat de saída interativo.

🔄 Passos do Fluxo de Trabalho

Nome do Componente	Papel no Fluxo	Entradas Principais	Saídas Principais
Obter Mensagens	Busca e recupera e‑mails do Gmail	Labels, número de e‑mails, consulta	Dados de e‑mail
Obter Dados	Converte os dados de e‑mail em texto estruturado	Dados de e‑mail	Texto formatado
Consulta	Monta o prompt que será enviado ao agente	Texto formatado, tema	Prompt de mensagem
Modelo OpenAI	Fornece a LLM que será usada pelo agente	Configurações de modelo (ex.: GPT‑4.1)	Modelo de linguagem
Agente Avançado	Processa o prompt, utiliza ferramentas e gera resposta	Prompt, Modelo OpenAI, Ferramentas (ex.: Marcar como lido)	Mensagem de resposta
Marcar como Lido	Ferramenta opcional que marca e‑mails como lidos	ID do e‑mail, número de e‑mails, marca	Status de marcação
Chat Output	Exibe a resposta do agente no chat	Mensagem de resposta	Mensagem de chat

Observação: O componente Marcar como Lido atua apenas como ferramenta dentro do agente; ele é invocado pelo agente quando decide que a marcação é necessária.

🧠 Notas

O fluxo exige credenciais válidas tanto para a API do Gmail quanto para a API da OpenAI.
As consultas de e‑mail são filtradas por labels e palavras‑chave; parâmetros inadequados podem resultar em nenhum e‑mail retornado.
O modelo OpenAI pode ser configurado para gerar respostas em JSON (modo JSON Mode) se o agente precisar de estruturação de dados.
A ferramenta Marcar como Lido pode alterar o status de vários e‑mails em lote; verifique o parâmetro num_of_emails para evitar operações indesejadas.
O chat de saída pode ser integrado a interfaces de usuário existentes, pois recebe a mensagem formatada em texto puro.