Assistente do Google Calendar e Gmail

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% GoogleGenerativeAIModel-tknjq[Gemini] style GoogleGenerativeAIModel-tknjq stroke:#a170ff ChatInput-rkd4u[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Input] style ChatInput-rkd4u stroke:#a170ff ChatOutput-zcb0e[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-zcb0e stroke:#a170ff GmailMesageComponent-v67l4[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>Optener mensage] style GmailMesageComponent-v67l4 stroke:#a170ff googlecalendarcomponent-851vc[Optener Eventos] style googlecalendarcomponent-851vc stroke:#a170ff googlecalendarcomponent-alti6[Crear Eventos] style googlecalendarcomponent-alti6 stroke:#a170ff googlecalendarcomponent-5ngix[Eliminar Eventos] style googlecalendarcomponent-5ngix stroke:#a170ff GmailMesageComponent-wtkw1[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div> Enviar message] style GmailMesageComponent-wtkw1 stroke:#a170ff Prompt-jyrhr[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt simple] style Prompt-jyrhr stroke:#a170ff Prompt-1zh7i[<div><img alt="logo" src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>System Prompt ] style Prompt-1zh7i stroke:#a170ff TextInput-1i8g7[<div><img alt="logo" src="/_astro/type.Dy26vmDy.svg" style="height: 20px !important;width: 20px !important"/></div>correo de usuario] style TextInput-1i8g7 stroke:#a170ff AdvancedAgent-43uv9[Agent2] style AdvancedAgent-43uv9 stroke:#a170ff ChatInput-rkd4u -.- Prompt-jyrhr linkStyle 0 stroke:#a170ff TextInput-1i8g7 -.- Prompt-1zh7i linkStyle 1 stroke:#a170ff Prompt-jyrhr -.- AdvancedAgent-43uv9 linkStyle 2 stroke:#a170ff Prompt-1zh7i -.- AdvancedAgent-43uv9 linkStyle 3 stroke:#a170ff AdvancedAgent-43uv9 -.- ChatOutput-zcb0e linkStyle 4 stroke:#a170ff GmailMesageComponent-v67l4 -.- AdvancedAgent-43uv9 linkStyle 5 stroke:#a170ff GmailMesageComponent-wtkw1 -.- AdvancedAgent-43uv9 linkStyle 6 stroke:#a170ff googlecalendarcomponent-851vc -.- AdvancedAgent-43uv9 linkStyle 7 stroke:#a170ff googlecalendarcomponent-alti6 -.- AdvancedAgent-43uv9 linkStyle 8 stroke:#a170ff googlecalendarcomponent-5ngix -.- AdvancedAgent-43uv9 linkStyle 9 stroke:#a170ff GoogleGenerativeAIModel-tknjq -.- AdvancedAgent-43uv9 linkStyle 10 stroke:#a170ff

🧩 Descrição Geral

O fluxo de trabalho descreve um assistente virtual que atua como secretário digital, gerenciando eventos do Google Calendar, interagindo com o Gmail e enviando resumos diários por e‑mail. O agente opera em modo manual ou automático, respondendo a solicitações do usuário e, quando não há mensagem, consulta o calendário do dia e envia o resumo para o endereço fornecido.

⚙️ Funcionalidades Principais

Orquestração de solicitações de e‑mail e calendário: o agente processa comandos do usuário para enviar, ler ou atualizar e‑mails e criar, ler ou excluir eventos.
Execução automática: se não houver mensagem do usuário, o agente coleta os eventos do dia atual e envia um resumo ao e‑mail informado.
Integração com modelos de linguagem avançados: utiliza um modelo Gemini 2.5 Flash para raciocinar e gerar respostas coerentes.
Suporte a múltiplas ferramentas: pode chamar componentes que interagem com Gmail e Google Calendar para realizar as ações necessárias.
Persistência e streaming: suporta memória de estado e streaming de respostas, permitindo conversas contínuas e respostas em tempo real.

🔄 Passos do Fluxo de Trabalho

Nome do Componente	Papel no Fluxo	Entradas Principais	Saídas Principais
Entrada de Texto	Captura a mensagem do usuário	Texto do usuário	Mensagem formatada
Entrada de E‑mail	Recebe o endereço do usuário	E‑mail do usuário	Mensagem de e‑mail
Prompt simples	Gera a entrada para o agente a partir da mensagem	Mensagem do usuário	Prompt (entrada do agente)
Prompt do Sistema	Cria instruções de sistema para o agente	E‑mail do usuário, data atual	Prompt de sistema (instruções)
Modelo Gemini	Processa o prompt e gera raciocínio	Prompt e Prompt de sistema, modelo configurado	Resposta de linguagem
Agente Avançado	Executa lógica de decisão, chama ferramentas e gera resposta final	Entrada do agente, Prompt de sistema, modelo Gemini, ferramentas (Gmail, Calendar)	Resposta do agente (texto)
Saída de Chat	Exibe a resposta ao usuário	Resposta do agente	Mensagem final exibida

Observação: Os componentes de Gmail e Google Calendar são disponibilizados como ferramentas dentro do agente e não aparecem em sequência distinta no diagrama, pois são acionados conforme a necessidade do agente.

🧠 Notas

O fluxo requer credenciais válidas para o Google e para o modelo Gemini; sem elas o agente não conseguirá executar as ferramentas ou gerar respostas.
O agente pode ser configurado em modo manual (responde a mensagens do usuário) ou automático (consulta o calendário e envia resumo quando não há entrada).
As ferramentas de Gmail permitem enviar, responder, ler, atualizar e excluir mensagens, além de marcar como lidas. A ferramenta de Calendar permite criar, ler, atualizar e excluir eventos, inclusive com link de Google Meet.
O uso do parâmetro stream no modelo permite streaming de respostas, útil para interfaces interativas. Caso stream seja falso, a resposta será retornada de uma vez.
O agente suporta modo de memória e pode salvar o estado em cada iteração, permitindo manter contexto entre interações.
O parâmetro structured_output pode ser habilitado para forçar a saída em JSON; se desativado, a resposta será texto livre.
Se nenhuma mensagem for enviada pelo usuário, o agente executa a lógica de automação descrita no Prompt do Sistema: consulta os eventos do dia e envia o resumo por e‑mail.