Todos os templates Pela equipe NappAI Bot de gestión de eventos en Telegram
Este flujo es utilizado para mediante una integración con telegram programar eventos en google calendar
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
TelegramWebhook-no237[Telegram Webhook]
style TelegramWebhook-no237 stroke:#a170ff
ParseData-e810l[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Parse Message]
style ParseData-e810l stroke:#a170ff
TelegramMessage-m4cr5[Telegram Message]
style TelegramMessage-m4cr5 stroke:#a170ff
googlecalendarcomponent-xva04[Crear Eventos]
style googlecalendarcomponent-xva04 stroke:#a170ff
GoogleGenerativeAIModel-cx7b4[Gemini]
style GoogleGenerativeAIModel-cx7b4 stroke:#a170ff
AdvancedAgent-27y8e[Agent]
style AdvancedAgent-27y8e stroke:#a170ff
TelegramWebhook-no237 -.- ParseData-e810l
linkStyle 0 stroke:#a170ff
ParseData-e810l -.- AdvancedAgent-27y8e
linkStyle 1 stroke:#a170ff
TelegramMessage-m4cr5 -.- AdvancedAgent-27y8e
linkStyle 2 stroke:#a170ff
googlecalendarcomponent-xva04 -.- AdvancedAgent-27y8e
linkStyle 3 stroke:#a170ff
GoogleGenerativeAIModel-cx7b4 -.- AdvancedAgent-27y8e
linkStyle 4 stroke:#a170ff
Bot de gestão de eventos no Telegram
🧩 Visão Geral
Este fluxo de trabalho automatiza o processo de receber solicitações de usuários via Telegram e gerenciar eventos no Google Agenda. Ele escuta mensagens recebidas, interpreta a intenção do usuário de criar ou gerenciar eventos e utiliza um agente de IA para executar as ações apropriadas. O sistema garante comunicação clara enviando uma confirmação ou resultado de volta ao usuário no Telegram, proporcionando uma experiência de assistente pessoal perfeita.
⚙️ Principais Funcionalidades
- Recebe e processa mensagens de usuários de um webhook do Telegram.
- Extrai e estrutura informações-chave como a mensagem do usuário, ID do chat e ID da mensagem.
- Utiliza um agente de IA para interpretar solicitações em linguagem natural e decidir sobre as ações necessárias.
- Integra-se com o Google Agenda para criar eventos com base nas instruções do usuário.
- Envia respostas automatizadas de volta ao usuário no Telegram para confirmar ações ou fornecer resultados.
🔄 Etapas do Fluxo de Trabalho
| Nome do Componente | Função no Fluxo de Trabalho | Entradas Principais | Saídas Principais |
|---|---|---|---|
| Webhook do Telegram | Recebe a mensagem inicial do usuário e o payload da plataforma Telegram. | Dados do webhook recebidos contendo a mensagem do usuário e metadados. | Dados brutos da mensagem para processamento. |
| Analisar Mensagem | Estrutura os dados brutos do webhook extraindo o texto do usuário, ID do chat e ID da mensagem em um formato claro. | Dados brutos do webhook. | Texto formatado contendo a mensagem do usuário, ID do chat e ID da mensagem. |
| Modelo Gemini | Fornece a capacidade central do modelo de linguagem que alimenta o raciocínio e a tomada de decisão do agente de IA. | Parâmetros de configuração do modelo. | Uma instância do modelo de linguagem configurada para o agente. |
| Criar Eventos (Google Agenda) | Serve como uma ferramenta para o agente interagir com o Google Agenda, permitindo-lhe criar eventos. | Configuração e descrição da ferramenta. | Uma ferramenta que o agente pode chamar para criar eventos na agenda. |
| Mensagem do Telegram | Serve como uma ferramenta para o agente enviar mensagens de texto de volta ao usuário no Telegram. | Configuração e descrição da ferramenta. | Uma ferramenta que o agente pode chamar para enviar respostas. |
| Agente | O componente central de IA que interpreta a solicitação do usuário, decide quais ferramentas usar (ex.: criar um evento na agenda) e orquestra a execução. | Mensagem formatada do usuário, o modelo de linguagem e as ferramentas disponíveis (Telegram e Google Agenda). | Uma mensagem de resposta final baseada no resultado das ações executadas. |
🧠 Notas
- O fluxo de trabalho é acionado por uma mensagem recebida de um webhook de bot do Telegram.
- O agente de IA é instruído a usar um formato de data ISO 8601 estrito (AAAA-MM-DD para eventos de dia inteiro, AAAA-MM-DDTHH:MM:SS para eventos com horário) ao criar eventos na agenda para garantir precisão.
- A instrução de sistema do agente instrui explicitamente a concluir sua execução enviando uma mensagem de resultado de volta ao usuário via Telegram.
- O fluxo de trabalho requer credenciais de API válidas para o Bot do Telegram e serviços do Google para funcionar.
- O raciocínio do agente é limitado por uma contagem máxima de iterações para evitar loops infinitos.