Todos os templates Pela equipe NappAI Assistente Virtual
Agente inteligente que analisa e-mails e calendário, detecta informações relevantes e complementa com pesquisas na web para oferecer organização, contexto e recomendações úteis em tempo real.
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
GmailMesageComponent-mkt7v[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>enviar]
style GmailMesageComponent-mkt7v stroke:#a170ff
GmailMesageComponent-44crm[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>obtener]
style GmailMesageComponent-44crm stroke:#a170ff
googlecalendarcomponent-i0fv3[crear evento]
style googlecalendarcomponent-i0fv3 stroke:#a170ff
googlecalendarcomponent-v01iy[obtener eventos]
style googlecalendarcomponent-v01iy stroke:#a170ff
googlecalendarcomponent-pljlu[actualizar evento]
style googlecalendarcomponent-pljlu stroke:#a170ff
googlecalendarcomponent-4abze[eliminar evento]
style googlecalendarcomponent-4abze stroke:#a170ff
CalculatorTool-8cm5k[Calculator]
style CalculatorTool-8cm5k stroke:#a170ff
DuckDuckGoSearch-m7u5j[DuckDuckGo Search]
style DuckDuckGoSearch-m7u5j stroke:#a170ff
GmailMesageComponent-fytbb[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>responder]
style GmailMesageComponent-fytbb stroke:#a170ff
LanggraphSupervisorAgent-wsqta[Supervisor Agent]
style LanggraphSupervisorAgent-wsqta stroke:#a170ff
GmailMesageComponent-74mb7[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>eliminar]
style GmailMesageComponent-74mb7 stroke:#a170ff
GmailMesageComponent-2umqp[<div><img alt="logo" src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>marcar_leído]
style GmailMesageComponent-2umqp stroke:#a170ff
AdvancedAgent-70psk[AgenteBúsqueda]
style AdvancedAgent-70psk stroke:#a170ff
AdvancedAgent-v75tq[AgenteGmail]
style AdvancedAgent-v75tq stroke:#a170ff
AdvancedAgent-91o8w[AgenteCalendario]
style AdvancedAgent-91o8w stroke:#a170ff
TelegramWebhook-u9hpu[Telegram Webhook]
style TelegramWebhook-u9hpu stroke:#a170ff
TelegramMessage-7x695[Telegram Message]
style TelegramMessage-7x695 stroke:#a170ff
OpenAIModel-w05yo[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI]
style OpenAIModel-w05yo stroke:#a170ff
OpenAIModel-lv5xv[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI2]
style OpenAIModel-lv5xv stroke:#a170ff
OpenAIModel-pfy9p[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI3]
style OpenAIModel-pfy9p stroke:#a170ff
OpenAIModel-cproi[<div><img alt="logo" src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI4]
style OpenAIModel-cproi stroke:#a170ff
AdvancedAgent-v75tq -.- LanggraphSupervisorAgent-wsqta
linkStyle 0 stroke:#a170ff
GmailMesageComponent-2umqp -.- AdvancedAgent-v75tq
linkStyle 1 stroke:#a170ff
GmailMesageComponent-44crm -.- AdvancedAgent-v75tq
linkStyle 2 stroke:#a170ff
GmailMesageComponent-fytbb -.- AdvancedAgent-v75tq
linkStyle 3 stroke:#a170ff
GmailMesageComponent-74mb7 -.- AdvancedAgent-v75tq
linkStyle 4 stroke:#a170ff
GmailMesageComponent-mkt7v -.- AdvancedAgent-v75tq
linkStyle 5 stroke:#a170ff
AdvancedAgent-91o8w -.- LanggraphSupervisorAgent-wsqta
linkStyle 6 stroke:#a170ff
googlecalendarcomponent-i0fv3 -.- AdvancedAgent-91o8w
linkStyle 7 stroke:#a170ff
googlecalendarcomponent-pljlu -.- AdvancedAgent-91o8w
linkStyle 8 stroke:#a170ff
googlecalendarcomponent-v01iy -.- AdvancedAgent-91o8w
linkStyle 9 stroke:#a170ff
googlecalendarcomponent-4abze -.- AdvancedAgent-91o8w
linkStyle 10 stroke:#a170ff
CalculatorTool-8cm5k -.- AdvancedAgent-70psk
linkStyle 11 stroke:#a170ff
DuckDuckGoSearch-m7u5j -.- AdvancedAgent-70psk
linkStyle 12 stroke:#a170ff
AdvancedAgent-70psk -.- LanggraphSupervisorAgent-wsqta
linkStyle 13 stroke:#a170ff
TelegramWebhook-u9hpu -.- LanggraphSupervisorAgent-wsqta
linkStyle 14 stroke:#a170ff
LanggraphSupervisorAgent-wsqta -.- TelegramMessage-7x695
linkStyle 15 stroke:#a170ff
OpenAIModel-w05yo -.- LanggraphSupervisorAgent-wsqta
linkStyle 16 stroke:#a170ff
OpenAIModel-lv5xv -.- AdvancedAgent-v75tq
linkStyle 17 stroke:#a170ff
OpenAIModel-pfy9p -.- AdvancedAgent-91o8w
linkStyle 18 stroke:#a170ff
OpenAIModel-cproi -.- AdvancedAgent-70psk
linkStyle 19 stroke:#a170ff
🧩 Assistente Virtual
🧩 Descrição Geral
O Assistente Virtual integra inteligência artificial com Gmail, Google Calendar, busca na web e Telegram, oferecendo respostas automáticas e contextualizadas. Ele interpreta a intenção do usuário, consulta e manipula e‑mails e eventos, executa cálculos e pesquisas, e devolve as respostas por meio do Telegram em tempo real.
⚙️ Funcionalidades Principais
- Orquestração de agentes que analisam a mensagem e delegam tarefas a especialistas (Gmail, Calendar, Pesquisa).
- Manipulação de e‑mails: obter, enviar, responder e excluir, além de marcar como lidos.
- Gerenciamento de eventos de calendário: criar, atualizar, obter e excluir eventos, inclusive com links do Google Meet.
- Cálculos aritméticos via ferramenta de calculadora.
- Busca web no DuckDuckGo com limite de resultados.
- Resposta automática ao Telegram com integração de bot e envio de mensagens de texto.
🔄 Passos do Fluxo de Trabalho
| Nome do Componente | Papel no Fluxo | Entradas Principais | Saídas Principais |
|---|---|---|---|
| Telegram Webhook | Recebe a mensagem do usuário e a entrega ao supervisor | Payload do webhook (texto, chat‑id, etc.) | Mensagem formatada para o supervisor |
| Supervisor Agent | Interpreta a intenção, escolhe o agente apropriado e coleta as respostas | Mensagem de entrada do usuário | Resposta final em formato de texto |
| OpenAI Model (GPT‑4.1) | Fornece geração de linguagem para o supervisor e agentes | Texto de prompt, contexto | Texto gerado (prompt, justificativa) |
| Advanced Agent – Gmail | Orquestra operações de e‑mail (obter, enviar, responder, excluir) | Prompt de intenção, modelo GPT | Resposta do agente, chamada de ferramenta |
| Gmail Message Component – Get Emails | Recupera mensagens do Gmail | Get Message, número de e‑mails, filtros |
Lista de e‑mails |
| Gmail Message Component – Send Email | Envia um novo e‑mail | Destinatário, assunto, corpo, anexos | Confirmação de envio |
| Gmail Message Component – Reply Email | Responde a um e‑mail existente | ID do e‑mail, corpo da resposta | Confirmação de resposta |
| Gmail Message Component – Delete Email | Exclui um e‑mail | ID do e‑mail | Confirmação de exclusão |
| Advanced Agent – Calendar | Gerencia eventos (criar, obter, atualizar, excluir) | Prompt de intenção, modelo GPT | Resposta do agente, chamada de ferramenta |
| Google Calendar Component – Create Event | Cria um evento no calendário | Título, início, fim, participantes, local, descrição | ID do evento criado |
| Google Calendar Component – Update Event | Atualiza um evento existente | ID do evento, campos a alterar | ID do evento atualizado |
| Google Calendar Component – Delete Event | Remove um evento do calendário | ID do evento | Confirmação de exclusão |
| Advanced Agent – Search | Executa pesquisas e cálculos | Prompt de intenção, modelo GPT | Resposta do agente, chamada de ferramenta |
| Calculator Tool | Avalia expressões matemáticas | Expressão aritmética | Resultado numérico |
| DuckDuckGo Search | Busca informações na web | Consulta, número máximo de resultados | Lista de resultados de busca |
| Telegram Message | Envia a resposta final ao usuário no Telegram | Texto da resposta | Mensagem entregue ao chat do usuário |
Observação:
- Os componentes Gmail Message e Google Calendar têm múltiplas variantes (Get, Send, Reply, Delete, etc.); cada variante realiza a operação específica indicada no campo Operation.
- Todos os componentes que interagem com APIs externas utilizam credenciais configuradas em credential_id.
🧠 Notas Técnicas
- O Supervisor Agent atua como roteador, mas também pode gerar a resposta final se nenhuma ação especializada for necessária.
- O OpenAI Model (GPT‑4.1) é configurado para gerar respostas em JSON quando solicitado, o que facilita o consumo pelas ferramentas.
- Ferramentas de busca e cálculo são usadas apenas quando o prompt do usuário requer consulta externa ou aritmética; o agente decide dinamicamente qual ferramenta usar.
- As chamadas a APIs externas (Gmail, Calendar, Telegram) respeitam limites de taxa e têm política de retry automática definida nos parâmetros do Advanced Agent.
- O fluxo suporta modo batch – se o mapping_data for fornecido, cada item da lista será processado em paralelo (até 5 execuções simultâneas).
- Privacidade: todos os dados de e‑mail e calendário são tratados apenas nas chamadas de API; nenhum dado sensível é armazenado no fluxo.
- O Telegram Bot armazena mensagens apenas se should_store_message for verdadeiro, mas isso pode ser desativado conforme a política de retenção do usuário.
- Logs e debug: habilitar verbose no supervisor fornece trace detalhado das decisões e chamadas de ferramentas, útil para auditoria e depuração.