Build AI Business Solutions with Workflow Automation | NappAI - Template: AI Agent

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% Prompt-pfcxi[<div><img src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Instrucciones] style Prompt-pfcxi stroke:#a170ff LanggraphReactAgent-8scqw[Agent] style LanggraphReactAgent-8scqw stroke:#a170ff ChatOutput-g8z2x[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-g8z2x stroke:#a170ff TextInput-m9s4i[<div><img src="/_astro/type.Dy26vmDy.svg" style="height: 20px !important;width: 20px !important"/></div>Momento a comprobar] style TextInput-m9s4i stroke:#a170ff TextInput-c0vec[<div><img src="/_astro/type.Dy26vmDy.svg" style="height: 20px !important;width: 20px !important"/></div>Tema a comprobar] style TextInput-c0vec stroke:#a170ff Chroma-uql7r[<div><img src="/_astro/chroma.CDTUBZSx.svg" style="height: 20px !important;width: 20px !important"/></div>Cargar de DB] style Chroma-uql7r stroke:#a170ff ParseData-uxz7v[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Obtener Texto] style ParseData-uxz7v stroke:#a170ff OpenAIEmbeddings-85qva[<div><img src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI Embeddings2] style OpenAIEmbeddings-85qva stroke:#a170ff GSheetCellComponent-b94wx[Registrar en Agenda de Citas] style GSheetCellComponent-b94wx stroke:#a170ff OpenAIModel-4jw7u[<div><img src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI] style OpenAIModel-4jw7u stroke:#a170ff googlecalendarcomponent-m343k[Obtener Eventos] style googlecalendarcomponent-m343k stroke:#a170ff ParseData-64ynd[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Obtener Datos de evento] style ParseData-64ynd stroke:#a170ff Chroma-jofgi[<div><img src="/_astro/chroma.CDTUBZSx.svg" style="height: 20px !important;width: 20px !important"/></div>Subir a DB] style Chroma-jofgi stroke:#a170ff OpenAIEmbeddings-i5sb1[<div><img src="/_astro/openAI.BhmuxEs3.svg" style="height: 20px !important;width: 20px !important"/></div>OpenAI Embeddings] style OpenAIEmbeddings-i5sb1 stroke:#a170ff LanguageRecursiveTextSplitter-hfflv[Language Recursive Text Splitter] style LanguageRecursiveTextSplitter-hfflv stroke:#a170ff googlecalendarcomponent-m343k -.- ParseData-64ynd linkStyle 0 stroke:#a170ff Prompt-pfcxi -.- LanggraphReactAgent-8scqw linkStyle 1 stroke:#a170ff OpenAIModel-4jw7u -.- LanggraphReactAgent-8scqw linkStyle 2 stroke:#a170ff LanggraphReactAgent-8scqw -.- ChatOutput-g8z2x linkStyle 3 stroke:#a170ff TextInput-m9s4i -.- Prompt-pfcxi linkStyle 4 stroke:#a170ff GSheetCellComponent-b94wx -.- LanggraphReactAgent-8scqw linkStyle 5 stroke:#a170ff TextInput-c0vec -.- Prompt-pfcxi linkStyle 6 stroke:#a170ff OpenAIEmbeddings-i5sb1 -.- Chroma-jofgi linkStyle 7 stroke:#a170ff OpenAIEmbeddings-85qva -.- Chroma-uql7r linkStyle 8 stroke:#a170ff Chroma-uql7r -.- ParseData-uxz7v linkStyle 9 stroke:#a170ff ParseData-uxz7v -.- Prompt-pfcxi linkStyle 10 stroke:#a170ff ParseData-64ynd -.- LanguageRecursiveTextSplitter-hfflv linkStyle 11 stroke:#a170ff LanguageRecursiveTextSplitter-hfflv -.- Chroma-jofgi linkStyle 12 stroke:#a170ff

🧩 Visão Geral

O fluxo de trabalho é um “Assistente de Secretaria” baseado em IA que recupera automaticamente eventos do Google Calendar, os resume, registra as informações em uma planilha do Google Sheets e entrega o resultado por meio de uma interface de chat. Ao integrar engenharia de prompt, raciocínio de LLM, busca vetorial e manipulação de planilhas, ele simplifica o gerenciamento de eventos e reduz a entrada manual.

⚙️ Principais Funcionalidades

Recupera eventos de um Google Calendar específico.
Transforma dados dos eventos em resumos em linguagem natural.
Busca em uma base vetorial por contexto relevante dos eventos.
Gera uma resposta concisa e amigável ao usuário via chat.
Registra detalhes dos eventos no Google Sheets com um layout de cabeçalho predefinido.

🔄 Etapas do Fluxo de Trabalho

Nome do Componente	Função no Fluxo de Trabalho	Entradas Principais	Saídas Principais
Momento a comprobar	Fornece o momento especificado pelo usuário (ex.: “mañana”) que delimita a busca de eventos.	Texto “mañana”	Texto “mañana”
Tema a comprobar	Fornece a categoria do evento (ex.: “Daily”) usada no template do prompt.	Texto “Daily”	Texto “Daily”
Instruções (Prompt)	Constrói um prompt dinâmico contendo o momento, o tema e os dados extraídos do calendário.	Momento, Tema, Texto do Evento	Mensagem de prompt
Google Calendar Assistant (Obtener Eventos)	Obtém os eventos do Google Calendar selecionado.	Seleção do calendário, operação “Get”	Dados dos eventos do calendário
Obtener Datos de evento (ParseData)	Formata os dados brutos do calendário em um documento estruturado.	Dados dos eventos do calendário	Dados de eventos estruturados
Language Recursive Text Splitter	Divide os documentos dos eventos em blocos adequados para embeddings.	Dados de eventos estruturados	Dados fragmentados
Subir a DB (Chroma)	Armazena os blocos em uma base vetorial, criando embeddings para buscas futuras.	Dados fragmentados, embeddings	Entradas vetoriais armazenadas
OpenAI Embeddings	Gera embeddings para os blocos de eventos.	Dados fragmentados	Vetores de embeddings
Cargar de DB (Chroma)	Recupera blocos relevantes da base vetorial usando uma consulta de busca.	Consulta de busca, embeddings	Blocos de eventos recuperados
Obtener Texto (ParseData)	Converte os blocos recuperados em texto simples para o prompt.	Blocos recuperados	Descrição dos eventos em texto simples
OpenAI Model (OpenAI)	Fornece o LLM usado pelo agente.	Nome do modelo, system prompt	Instância do LLM
Langgraph React Agent	Orquestra a conversa, chama o LLM e ferramentas, e produz a resposta no chat.	Prompt, LLM, ferramentas	Resposta no chat
Registrar en Agenda de Citas (GSheetCellComponent)	Adiciona uma nova linha na planilha com detalhes do evento (nome, data, status).	Resposta do chat, dados do evento	Atualização da planilha
Chat Output	Exibe a resposta do agente ao usuário.	Resposta do chat	Mensagem exibida

Os componentes são executados na ordem mostrada acima, com o fluxo de dados seguindo da esquerda para a direita conforme as conexões.

🧠 Notas

O componente Google Calendar requer credenciais OAuth 2.0 válidas configuradas para o provedor googleCalendar.
O componente Google Sheet espera que a planilha contenha uma linha de cabeçalho com as colunas “Info de la cita”, “Fecha” e “Estado”.
A base vetorial Chroma está configurada com o nome da coleção nappai e é persistida no diretório calendar_assistant.
A geração de embeddings usa o modelo text-embedding-3-small por padrão; isso pode ser ajustado para vetores de maior dimensão, se necessário.
O template de prompt limita respostas apenas aos campos necessários, solicitando esclarecimentos ao LLM caso a entrada seja ambígua.
O fluxo assume que as entradas de “momento” e “tema” do usuário são coerentes com os dados do calendário, evitando resultados vazios.
A depuração pode ser feita ativando o modo verboso no agente Langgraph (Verbose = true).
Todos os componentes respeitam o parâmetro Mapping Mode; o processamento em lote é suportado quando ativado, embora o layout atual utilize o modo de registro único.

Esta documentação oferece uma visão funcional e concisa do fluxo de trabalho do assistente de IA, mantendo os detalhes técnicos abstraídos.