Build AI Business Solutions with Workflow Automation | NappAI

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% GmailMesageComponent-mkt7v[<div><img src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>enviar] style GmailMesageComponent-mkt7v stroke:#a170ff GmailMesageComponent-44crm[<div><img 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 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 src="/_astro/gmail.CLxyIGOu.svg" style="height: 20px !important;width: 20px !important"/></div>eliminar] style GmailMesageComponent-74mb7 stroke:#a170ff GmailMesageComponent-2umqp[<div><img 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 src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI] style OpenAIModel-w05yo stroke:#a170ff OpenAIModel-lv5xv[<div><img src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI2] style OpenAIModel-lv5xv stroke:#a170ff OpenAIModel-pfy9p[<div><img src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI3] style OpenAIModel-pfy9p stroke:#a170ff OpenAIModel-cproi[<div><img 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

Asistente Virtual

🧩 Overview

This workflow implements an intelligent virtual assistant that automates the management of personal tasks by orchestrating a team of specialized AI agents. It interprets user requests received via Telegram, analyzes the intent, and delegates the appropriate actions to dedicated agents for handling emails, calendar events, web searches, and calculations. The system consolidates the results and provides a coherent, helpful response back to the user, streamlining productivity and information retrieval.

⚙️ Main Features

Uses a supervisor agent to interpret user intent and coordinate the execution of tasks across specialized worker agents.
Integrates with Gmail for reading, sending, replying to, and managing emails.
Manages Google Calendar for creating, retrieving, updating, and deleting events.
Performs web searches and basic arithmetic calculations to gather and process information.
Provides a conversational interface via Telegram for receiving user queries and delivering responses.

🔄 Workflow Steps

Component Name	Role in the Workflow	Key Inputs	Key Outputs
Telegram Webhook	Listens for incoming user messages from the Telegram chat interface.	User Message from Telegram	User Query
Supervisor Agent	Acts as the central orchestrator. It interprets the user's query, determines which specialized agent should handle it, and manages the execution flow.	User Query, Language Model, Worker Agents	Delegation Instructions, Final Response
Gmail Agent	A specialized worker agent that handles all email-related tasks using its connected tools.	Instructions from Supervisor, Language Model	Email Operation Results
Calendar Agent	A specialized worker agent that manages all calendar event operations using its connected tools.	Instructions from Supervisor, Language Model	Calendar Operation Results
Search Agent	A specialized worker agent that performs web searches and calculations using its connected tools.	Instructions from Supervisor, Language Model	Search Results, Calculation Results
Gmail Tools (Get, Send, Reply, Delete, Mark)	A set of tools that provide the Gmail Agent with the ability to interact with the user's inbox.	Agent Instructions, Email Details	Email Data, Confirmation
Calendar Tools (Create, Get, Update, Delete)	A set of tools that provide the Calendar Agent with the ability to interact with the user's Google Calendar.	Agent Instructions, Event Details	Event Data, Confirmation
DuckDuckGo Search Tool	Enables the Search Agent to perform web searches to find recent information.	Search Query	Search Results
Calculator Tool	Enables the Search Agent to perform basic arithmetic calculations.	Arithmetic Expression	Calculation Result
OpenAI Model (Multiple)	Provides the language model capabilities that power the reasoning and decision-making of all AI agents in the workflow.	System Prompts, User Queries	Agent Reasoning, Text Generation
Telegram Message	Sends the final consolidated response from the Supervisor Agent back to the user on Telegram.	Final Response Text	Message Sent Confirmation

🧠 Notes

The workflow is designed around a hierarchical agent architecture where a supervisor coordinates multiple specialized worker agents.
Each worker agent (Gmail, Calendar, Search) is equipped with a specific system prompt and a dedicated set of tools to perform its functions efficiently.
The system requires valid API credentials for OpenAI, Google services (Gmail, Calendar), and Telegram to function.
The supervisor agent's system prompt defines the behavior and roles of all worker agents, ensuring they operate within their designated domains.
The workflow is initiated by a user message sent to a connected Telegram bot.