graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% googlecalendarcomponent-jaqxl[Crear evento] style googlecalendarcomponent-jaqxl stroke:#a170ff GmailMesageComponent-uj25t[<div><img src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>Enviar correo] style GmailMesageComponent-uj25t stroke:#a170ff GDriveFilesComponent-0mjfr[<div><img src="/_astro/google_drive.wKmDsV2c.svg" style="height: 20px !important;width: 20px !important"/></div>Mover a carpeta de formularios] style GDriveFilesComponent-0mjfr stroke:#a170ff GSheetCellComponent-fmnmq[Obtener datos para preguntas] style GSheetCellComponent-fmnmq stroke:#a170ff googleFormscomponent-aowyt[Crear formulario] style googleFormscomponent-aowyt stroke:#a170ff googleFormsDatacomponent-gtnj5[Crear preguntas de formulario] style googleFormsDatacomponent-gtnj5 stroke:#a170ff GDriveFolderComponent-4gs0x[<div><img src="/_astro/google_drive.wKmDsV2c.svg" style="height: 20px !important;width: 20px !important"/></div>Obtener carpeta de formularios] style GDriveFolderComponent-4gs0x stroke:#a170ff ParseData-hsneb[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Obtener id de carpeta] style ParseData-hsneb stroke:#a170ff ParseData-l0t0p[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Obtener Datos] style ParseData-l0t0p stroke:#a170ff Prompt-63lqj[<div><img src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Consulta] style Prompt-63lqj stroke:#a170ff TextInput-m37hp[<div><img src="/_astro/type.Dy26vmDy.svg" style="height: 20px !important;width: 20px !important"/></div>Email a enviar] style TextInput-m37hp stroke:#a170ff LanggraphReactAgent-fkij3[Agent] style LanggraphReactAgent-fkij3 stroke:#a170ff OpenAIModel-4xmn9[<div><img src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI] style OpenAIModel-4xmn9 stroke:#a170ff ChatOutput-9yddi[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-9yddi stroke:#a170ff TextInput-60yea[<div><img src="/_astro/type.Dy26vmDy.svg" style="height: 20px !important;width: 20px !important"/></div>Nombre del formulario] style TextInput-60yea stroke:#a170ff GSheetCellComponent-fmnmq -.- googleFormsDatacomponent-gtnj5 linkStyle 0 stroke:#a170ff googleFormsDatacomponent-gtnj5 -.- googleFormscomponent-aowyt linkStyle 1 stroke:#a170ff GDriveFolderComponent-4gs0x -.- ParseData-hsneb linkStyle 2 stroke:#a170ff googleFormscomponent-aowyt -.- ParseData-l0t0p linkStyle 3 stroke:#a170ff ParseData-l0t0p -.- Prompt-63lqj linkStyle 4 stroke:#a170ff TextInput-m37hp -.- Prompt-63lqj linkStyle 5 stroke:#a170ff Prompt-63lqj -.- LanggraphReactAgent-fkij3 linkStyle 6 stroke:#a170ff GmailMesageComponent-uj25t -.- LanggraphReactAgent-fkij3 linkStyle 7 stroke:#a170ff OpenAIModel-4xmn9 -.- LanggraphReactAgent-fkij3 linkStyle 8 stroke:#a170ff LanggraphReactAgent-fkij3 -.- ChatOutput-9yddi linkStyle 9 stroke:#a170ff TextInput-m37hp -.- googlecalendarcomponent-jaqxl linkStyle 10 stroke:#a170ff googlecalendarcomponent-jaqxl -.- LanggraphReactAgent-fkij3 linkStyle 11 stroke:#a170ff TextInput-60yea -.- googleFormscomponent-aowyt linkStyle 12 stroke:#a170ff GDriveFilesComponent-0mjfr -.- LanggraphReactAgent-fkij3 linkStyle 13 stroke:#a170ff ParseData-hsneb -.- GDriveFilesComponent-0mjfr linkStyle 14 stroke:#a170ff

📄 Fluxo de Trabalho de Gerenciamento de Formulários Baseado em IA

🧩 Visão Geral

Este fluxo automatiza o processo completo de criação de um Google Form a partir de dados de uma planilha, publica o formulário, move o arquivo para uma pasta específica no Drive, agenda um evento de revisão no Google Calendar e notifica um usuário via Gmail. Um agente de IA orquestra todas as etapas usando o modelo de linguagem da OpenAI e integra-se ao ecossistema Google através de componentes dedicados.

⚙️ Funcionalidades Principais

Extração de dados de uma planilha Google para construir perguntas do formulário.
Criação dinâmica de formulário com título e descrição definidos pelo usuário.
Notificação automática por email para um destinatário especificado.
Agendamento de evento no calendário para uma reunião de revisão.
Gerenciamento de arquivos que move o formulário criado para uma pasta do Drive escolhida.
Tomada de decisão baseada em IA que interpreta os dados do formulário e coordena as ferramentas.

🔄 Etapas do Fluxo

Componente	Papel no Fluxo	Entradas Principais	Saídas Principais
Google Sheet Cell Component	Extrai dados das perguntas da planilha.	ID da planilha, Nome da aba, Intervalo de células, Flag de cabeçalho	Dados estruturados das perguntas (Data)
Google Forms Data Component	Transforma os dados da planilha em objetos de perguntas do formulário.	Dados das perguntas, Modo de mapeamento	Lista de perguntas do formulário (Data)
Google Forms Component	Cria um novo formulário Google com título e perguntas fornecidas.	Título, Descrição, Lista de perguntas	Metadados do formulário (Data)
Text Input (Nome do Formulário)	Coleta o título desejado do formulário do usuário.	Texto do título fornecido pelo usuário	Mensagem de título
Parse Data (Detalhes do Formulário)	Formata os metadados do formulário em um prompt legível.	Dados do formulário, Template	Texto com detalhes do formulário
Prompt	Constrói o prompt de IA usando os detalhes do formulário e o email do destinatário.	Texto do formulário, Email do destinatário	Prompt de mensagem
Text Input (Email para Envio)	Captura o endereço de email do destinatário.	Endereço de email	Mensagem de email
Langgraph React Agent	Orquestra o processo completo, invocando ferramentas com base no prompt.	Prompt, Modelo LLM, Conjunto de ferramentas (Gmail, Calendar, Drive)	Mensagem de resposta
Google Calendar Component	Cria ou recupera um evento de calendário para a reunião de revisão.	Resumo, Participantes, Datas, Descrição	Dados do evento do calendário
Gmail Message Component	Envia um email de notificação ao destinatário.	Destinatário, Assunto, Corpo, Anexos	Confirmação de envio de email
Google Drive Files Component	Move o formulário recém-criado para a pasta especificada no Drive.	ID do arquivo, ID da pasta, Operação (Move)	Resultado da operação no Drive
Chat Output	Exibe a mensagem final da IA para o usuário.	Mensagem de resposta	Mensagem de chat visível

Observação: O componente Parse Data que extrai o ID da pasta para a operação no Drive é invocado internamente pelo agente; não é exposto como etapa separada para o usuário.

🧠 Notas

O fluxo requer credenciais válidas do Google Cloud para APIs do Forms, Drive e Calendar, e uma chave de API da OpenAI para o LLM.
Todas as interações com ferramentas (Gmail, Calendar, Drive) exigem que o usuário conceda os escopos apropriados (ex.: https://www.googleapis.com/auth/gmail.send, https://www.googleapis.com/auth/calendar.events, https://www.googleapis.com/auth/drive.file).
O agente depende do template do Prompt para guiar o LLM; modificar o template pode alterar as ações geradas.
O evento do Calendar é criado com o resumo padrão “Revisión formulario” e inclui o link do formulário no corpo.
O componente Gmail envia emails em texto simples; anexos podem ser adicionados se necessário.
O Drive realiza atualmente a operação de Move; outras operações (Upload, Copy, Delete) podem ser habilitadas se necessário.
O fluxo é projetado para um formulário por execução, mas pode ser expandido para processamento em lote ativando o modo de mapeamento nos componentes relevantes.
O tratamento de erros é gerenciado em nível de componente; se uma ferramenta falhar, o agente pode ser configurado para tentar novamente ou pular a etapa.