Classificador de Correio Inteligente

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% GmailMesageComponent-hy2ma[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>Gmail Message] style GmailMesageComponent-hy2ma stroke:#a170ff GoogleGenerativeAIModel-vgbbh[Gemini] style GoogleGenerativeAIModel-vgbbh stroke:#a170ff GmailMesageComponent-b2dd1[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>VENTA] style GmailMesageComponent-b2dd1 stroke:#a170ff Prompt-yx16c[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt] style Prompt-yx16c stroke:#a170ff Switch-ml52o[Switch] style Switch-ml52o stroke:#a170ff GmailMesageComponent-dzaho[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>IMPORTANTE] style GmailMesageComponent-dzaho stroke:#a170ff GmailMesageComponent-gsepm[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>URGENTE] style GmailMesageComponent-gsepm stroke:#a170ff GmailMesageComponent-imh3h[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>NORMAL] style GmailMesageComponent-imh3h stroke:#a170ff CreateData-j2wcd[Create Data] style CreateData-j2wcd stroke:#a170ff Prompt-yx16c -.- GoogleGenerativeAIModel-vgbbh linkStyle 0 stroke:#a170ff Switch-ml52o -.- GmailMesageComponent-dzaho linkStyle 1 stroke:#a170ff Switch-ml52o -.- GmailMesageComponent-gsepm linkStyle 2 stroke:#a170ff Switch-ml52o -.- GmailMesageComponent-imh3h linkStyle 3 stroke:#a170ff GoogleGenerativeAIModel-vgbbh -.- CreateData-j2wcd linkStyle 4 stroke:#a170ff CreateData-j2wcd -.- Switch-ml52o linkStyle 5 stroke:#a170ff Switch-ml52o -.- GmailMesageComponent-b2dd1 linkStyle 6 stroke:#a170ff GmailMesageComponent-hy2ma -.- Prompt-yx16c linkStyle 7 stroke:#a170ff

🧩 Descrição Geral

O fluxo automatiza a classificação de e‑mails recebidos no Gmail. Ele extrai diariamente as mensagens não etiquetadas, utiliza o modelo Gemini para identificar a categoria do e‑mail (Urgente, Importante, Venda ou Normal) e, em seguida, aplica automaticamente a etiqueta correspondente, movendo‑o para a fila de processamento. O processo garante uma organização inteligente e a atribuição de prioridades sem intervenção manual.

⚙️ Funcionalidades Principais

Coleta diária de e‑mails sem a etiqueta “ETIQUETADO”.
Análise semântica com o modelo Gemini para classificação precisa.
Criação dinâmica de registros de classificação contendo a etiqueta e o ID do e‑mail.
Roteamento automático por meio de um switch condicional.
Aplicação de múltiplas etiquetas e mudança de estado do e‑mail (ex.: “ETIQUETADO”).
Execução em lote e paralelismo controlado por parâmetros de execução.

🔄 Passos do Fluxo de Trabalho

Nome do Componente	Papel no Fluxo	Entradas Principais	Saídas Principais
Gmail Message	Obtém e‑mails da caixa de entrada sem a etiqueta “ETIQUETADO”	Query (`-label:ETIQUETADO`), número de e‑mails (10), credenciais	Dados das mensagens (cabeçalhos, corpo, ID)
Prompt	Constrói o prompt a ser enviado ao modelo Gemini, inserindo o corpo do e‑mail	Texto do e‑mail (campo `Cuerpo_del_correo`)	Prompt formatado
Gemini	Gera a categoria (URGENTE, IMPORTANTE, VENTA, NORMAL) a partir do prompt	Prompt, parâmetros do modelo (modelo, temperatura, etc.)	Texto da categoria
Create Data	Cria um registro contendo a etiqueta e o ID do e‑mail	Texto da categoria, ID do e‑mail	Registro estruturado (`etiqueta`, `id`)
Switch	Roteia o registro para a etiqueta correta	Registro com campo `etiqueta`	Fluxos separados por categoria
Gmail Message (VENDA)	Aplica etiquetas “VENTA” e “ETIQUETADO” ao e‑mail correspondente	Registro com `id`, etiquetas a adicionar	E‑mail atualizado
Gmail Message (IMPORTANTE)	Aplica etiquetas “IMPORTANTE” e “ETIQUETADO” ao e‑mail	Registro com `id`, etiquetas a adicionar	E‑mail atualizado
Gmail Message (URGENTE)	Aplica etiquetas “URGENTE” e “ETIQUETADO” ao e‑mail	Registro com `id`, etiquetas a adicionar	E‑mail atualizado
Gmail Message (NORMAL)	Aplica etiquetas “NORMAL” e “ETIQUETADO” ao e‑mail	Registro com `id`, etiquetas a adicionar	E‑mail atualizado

Observação: Os componentes “Label Component” presentes apenas na visualização do fluxo servem como notas de descrição e não processam dados; portanto, não são listados como passos de execução.

🧠 Notas

O modelo Gemini é configurado com o endpoint “gemini‑2.5‑flash” e temperatura 0,5, garantindo respostas concisas e confiáveis.
O switch utiliza a chave etiqueta para decidir a rota; qualquer valor que não corresponda a nenhuma das quatro categorias resultará em não processamento (padrão desativado).
Todos os componentes de atualização de etiqueta recebem mail_id proveniente do registro criado, assegurando que apenas o e‑mail analisado seja alterado.
O fluxo está preparado para execução em lote, com 10 e‑mails por iteração e paralelismo de até 5 threads, otimizando desempenho em ambientes de alto volume.
As credenciais de acesso ao Gmail são gerenciadas de forma segura via campo credential_id, evitando exposição de chaves no código.
Para garantir que o fluxo não fique bloqueado por dados vazios, os parâmetros skip_if_empty_input e skip_branch_if_empty_output estão habilitados em todos os componentes que recebem dados de entrada.