Todas las plantillas Por el equipo NappAI Atención al Cliente Ecommerce
Flujo de Atención al Cliente con sistema de nivelación para integrarse con un ecommerce
+4
graph TD
%%{init: {'theme': 'mc','layout': 'elk'}}%%
ChatInput-larrt[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Input]
style ChatInput-larrt stroke:#a170ff
LanggraphReactAgent-e7sh0[Detector de Intención]
style LanggraphReactAgent-e7sh0 stroke:#a170ff
ConditionalRouter-e0whx[Conditional Router]
style ConditionalRouter-e0whx stroke:#a170ff
ConditionalRouter-k37bb[Conditional Router2]
style ConditionalRouter-k37bb stroke:#a170ff
ConditionalRouter-7onzp[Conditional Router3]
style ConditionalRouter-7onzp stroke:#a170ff
GoogleGenerativeAIModel-hrflu[Gemini]
style GoogleGenerativeAIModel-hrflu stroke:#a170ff
LanggraphReactAgent-feiuj[Agent]
style LanggraphReactAgent-feiuj stroke:#a170ff
GoogleGenerativeAIModel-0aobu[Gemini2]
style GoogleGenerativeAIModel-0aobu stroke:#a170ff
GoogleGenerativeAIEmbeddings-fnjt0[Google Generative AI Embeddings]
style GoogleGenerativeAIEmbeddings-fnjt0 stroke:#a170ff
LanggraphReactAgent-r6l2z[Agent2]
style LanggraphReactAgent-r6l2z stroke:#a170ff
APIRequest-78xr1[API Request]
style APIRequest-78xr1 stroke:#a170ff
LanggraphReactAgent-py6gc[Agent3]
style LanggraphReactAgent-py6gc stroke:#a170ff
GoogleGenerativeAIModel-y15kz[Gemini3]
style GoogleGenerativeAIModel-y15kz stroke:#a170ff
GoogleGenerativeAIModel-gta86[Gemini4]
style GoogleGenerativeAIModel-gta86 stroke:#a170ff
TelegramMessage-zvrp9[Telegram Message]
style TelegramMessage-zvrp9 stroke:#a170ff
ChatOutput-16z2g[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output]
style ChatOutput-16z2g stroke:#a170ff
ChatOutput-0vfib[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output2]
style ChatOutput-0vfib stroke:#a170ff
ChatOutput-7h910[<div><img src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output3]
style ChatOutput-7h910 stroke:#a170ff
Prompt-c8k88[<div><img src="/_astro/square-terminal.BMOXc-nZ.svg" style="height: 20px !important;width: 20px !important"/></div>Prompt]
style Prompt-c8k88 stroke:#a170ff
LanggraphRAGAgent-4j24w[RAG Agent]
style LanggraphRAGAgent-4j24w stroke:#a170ff
GoogleGenerativeAIModel-lcmte[Gemini5]
style GoogleGenerativeAIModel-lcmte stroke:#a170ff
GoogleGenerativeAIEmbeddings-mn2ew[Google Generative AI Embeddings2]
style GoogleGenerativeAIEmbeddings-mn2ew stroke:#a170ff
SplitText-xm92m[<div><img src="/_astro/scissors-line-dashed.CajsPhTx.svg" style="height: 20px !important;width: 20px !important"/></div>Split Text]
style SplitText-xm92m stroke:#a170ff
GDriveFilesComponent-q2n9y[<div><img src="/_astro/google_drive.wKmDsV2c.svg" style="height: 20px !important;width: 20px !important"/></div>Google Drive File Manager]
style GDriveFilesComponent-q2n9y stroke:#a170ff
ParseData-dpd2k[<div><img src="/_astro/braces.Djq0PW4_.svg" style="height: 20px !important;width: 20px !important"/></div>Parse Data]
style ParseData-dpd2k stroke:#a170ff
Chroma-d83zz[<div><img src="/_astro/chroma.CDTUBZSx.svg" style="height: 20px !important;width: 20px !important"/></div>Chroma DB]
style Chroma-d83zz stroke:#a170ff
Chroma-0gshk[<div><img src="/_astro/chroma.CDTUBZSx.svg" style="height: 20px !important;width: 20px !important"/></div>Chroma DB2]
style Chroma-0gshk stroke:#a170ff
ChatInput-larrt -.- LanggraphReactAgent-e7sh0
linkStyle 0 stroke:#a170ff
GoogleGenerativeAIModel-hrflu -.- LanggraphReactAgent-e7sh0
linkStyle 1 stroke:#a170ff
LanggraphReactAgent-e7sh0 -.- ConditionalRouter-e0whx
linkStyle 2 stroke:#a170ff
ChatInput-larrt -.- ConditionalRouter-e0whx
linkStyle 3 stroke:#a170ff
ChatInput-larrt -.- ConditionalRouter-k37bb
linkStyle 4 stroke:#a170ff
ChatInput-larrt -.- ConditionalRouter-7onzp
linkStyle 5 stroke:#a170ff
LanggraphReactAgent-e7sh0 -.- ConditionalRouter-k37bb
linkStyle 6 stroke:#a170ff
LanggraphReactAgent-e7sh0 -.- ConditionalRouter-7onzp
linkStyle 7 stroke:#a170ff
ConditionalRouter-e0whx -.- LanggraphReactAgent-feiuj
linkStyle 8 stroke:#a170ff
GoogleGenerativeAIModel-0aobu -.- LanggraphReactAgent-feiuj
linkStyle 9 stroke:#a170ff
ConditionalRouter-k37bb -.- LanggraphReactAgent-r6l2z
linkStyle 10 stroke:#a170ff
APIRequest-78xr1 -.- LanggraphReactAgent-r6l2z
linkStyle 11 stroke:#a170ff
ConditionalRouter-7onzp -.- LanggraphReactAgent-py6gc
linkStyle 12 stroke:#a170ff
GoogleGenerativeAIModel-y15kz -.- LanggraphReactAgent-r6l2z
linkStyle 13 stroke:#a170ff
GoogleGenerativeAIModel-gta86 -.- LanggraphReactAgent-py6gc
linkStyle 14 stroke:#a170ff
TelegramMessage-zvrp9 -.- LanggraphReactAgent-py6gc
linkStyle 15 stroke:#a170ff
LanggraphReactAgent-py6gc -.- ChatOutput-0vfib
linkStyle 16 stroke:#a170ff
LanggraphReactAgent-r6l2z -.- ChatOutput-7h910
linkStyle 17 stroke:#a170ff
LanggraphReactAgent-feiuj -.- ChatOutput-16z2g
linkStyle 18 stroke:#a170ff
Prompt-c8k88 -.- LanggraphReactAgent-r6l2z
linkStyle 19 stroke:#a170ff
GoogleGenerativeAIModel-lcmte -.- LanggraphRAGAgent-4j24w
linkStyle 20 stroke:#a170ff
ParseData-dpd2k -.- SplitText-xm92m
linkStyle 21 stroke:#a170ff
GDriveFilesComponent-q2n9y -.- ParseData-dpd2k
linkStyle 22 stroke:#a170ff
LanggraphRAGAgent-4j24w -.- LanggraphReactAgent-feiuj
linkStyle 23 stroke:#a170ff
Chroma-d83zz -.- LanggraphRAGAgent-4j24w
linkStyle 24 stroke:#a170ff
GoogleGenerativeAIEmbeddings-fnjt0 -.- Chroma-d83zz
linkStyle 25 stroke:#a170ff
SplitText-xm92m -.- Chroma-0gshk
linkStyle 26 stroke:#a170ff
GoogleGenerativeAIEmbeddings-mn2ew -.- Chroma-0gshk
linkStyle 27 stroke:#a170ff
🧩 Descripción general
El flujo automatiza la atención al cliente de una plataforma de ecommerce. El usuario ingresa una consulta en un chat; un agente inteligente clasifica la intención en tres niveles (información, estado de pedido o solicitud de intervención humana). Según la clasificación, el flujo sigue la ruta correspondiente:
- Nivel 1 – Respuestas de conocimiento con búsqueda semántica en una base de datos vectorial.
- Nivel 2 – Consultas a la API interna del sistema para obtener datos transaccionales.
- Nivel 3 – Notificación a un agente humano vía Telegram.
El proceso utiliza modelos de lenguaje Gemini, embeddings de Google, ChromaDB y una serie de componentes especializados para la recuperación, la generación y la integración con servicios externos.
⚙️ Funcionalidades principales
- Detección automática de intención mediante un modelo de lenguaje que devuelve
nivel1,nivel2onivel3. - Enrutamiento condicional de la conversación según la intención detectada.
- Respuesta basada en búsqueda RAG (Retrieval‑Augmented Generation) usando embeddings y ChromaDB.
- Consulta dinámica a la API interna con parámetros extraídos del mensaje del usuario.
- Notificación automática a la mesa de ventas a través de Telegram cuando la intención requiere intervención humana.
- Ingestión y procesamiento de documentos desde Google Drive (extracción de texto, chunking y indexación en la base de datos vectorial).
🔄 Pasos del flujo de trabajo
| Nombre del componente | Rol en el flujo | Entradas clave | Salidas clave |
|---|---|---|---|
| Chat Input | Recibe la consulta del usuario. | Mensaje de texto, ID de conversación, sesión. | Mensaje de usuario (Message). |
| Detector de Intención | Clasifica la intención con Gemini. | Mensaje de usuario. | Palabra de clasificación (nivel1, nivel2, nivel3). |
| Conditional Router | Enruta la conversación según la clasificación. | Palabra de clasificación, mensaje. | Mensaje encaminado a la ruta correspondiente. |
| Agent (Nivel 1) | Genera respuesta de conocimiento usando RAG. | Mensaje encaminado, modelo Gemini, RAGAgent como herramienta. | Respuesta de texto. |
| RAGAgent | Recupera información relevante de ChromaDB. | Mensaje de consulta, modelo Gemini, retrievers de Chroma. | Datos recuperados y respuesta generada. |
| Agent (Nivel 2) | Genera respuesta consultando la API interna. | Mensaje encaminado, modelo Gemini, APIRequest como herramienta. | Respuesta de texto basada en datos de la API. |
| APIRequest | Ejecuta petición HTTP a la API de backend. | Parámetros de la solicitud (URL, método, headers, cuerpo). | Datos devueltos por la API. |
| Agent (Nivel 3) | Notifica a la mesa de ventas vía Telegram. | Mensaje encaminado, modelo Gemini, TelegramMessage como herramienta. | Mensaje de confirmación de envío a Telegram. |
| TelegramMessage | Envía notificación a Telegram. | Mensaje a enviar, ID de chat, token del bot. | Respuesta de Telegram (status). |
| Chat Output | Muestra la respuesta final al usuario. | Mensaje de respuesta (texto). | Mensaje visible en la interfaz de chat. |
| Data Ingestion (GDriveFileManager → ParseData → SplitText → ChromaDB) | Prepara documentos para la búsqueda RAG. | Identificador de archivos en Google Drive. | Vectores indexados en ChromaDB. |
| GoogleGenerativeAIEmbeddings | Convierte texto en embeddings. | Texto extraído. | Embeddings vectoriales. |
| ChromaDB | Almacena y recupera documentos por similitud. | Embeddings y metadatos. | Documentos relevantes. |
Nota: La fase de ingestión se ejecuta de forma independiente (por ejemplo, a intervalos programados) antes de que los usuarios interactúen con el flujo.
🧠 Notas
- Los modelos de lenguaje utilizados (Gemini 2 / 3 / 4 / 5) están configurados con parámetros
max_output_tokens,temperatureyinclude_thoughtsdesactivados para evitar pensamientos no deseados. - El
Conditional Routercompara la palabra de clasificación usando el operadorequals(caso insensible). - El
Agent (Nivel 2)emplea un prompt predefinido que instruye al modelo a responder exclusivamente con los resultados obtenidos por la herramientaAPIRequest. RAGAgenthabilita la comprobación de calidad de respuesta y la eliminación de documentos duplicados para optimizar la relevancia.- La notificación en Telegram incluye la opción de enviar texto plano; se pueden ampliar a otros formatos (fotos, documentos) si se requieren.
- Todos los componentes que requieren credenciales (
GoogleGenerativeAIModel,TelegramMessage,GDriveFileManager) obtienen sus tokens de una almacén seguro (credential_id).