Agente de Gestión y Normalización (Supabase)

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% AdvancedAgent-c7337[Agent] style AdvancedAgent-c7337 stroke:#a170ff GoogleGenerativeAIModel-ha7vb[Gemini] style GoogleGenerativeAIModel-ha7vb stroke:#a170ff ChatInput-scyl4[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Input] style ChatInput-scyl4 stroke:#a170ff ChatOutput-92g4x[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-92g4x stroke:#a170ff SupabaseComponent-nn4yr[Supabase] style SupabaseComponent-nn4yr stroke:#a170ff SupabaseComponent-z7v6b[Supabase2] style SupabaseComponent-z7v6b stroke:#a170ff SupabaseComponent-ug1hf[Supabase3] style SupabaseComponent-ug1hf stroke:#a170ff SupabaseComponent-wulup[Supabase4] style SupabaseComponent-wulup stroke:#a170ff AdvancedAgent-c7337 -.- ChatOutput-92g4x linkStyle 0 stroke:#a170ff GoogleGenerativeAIModel-ha7vb -.- AdvancedAgent-c7337 linkStyle 1 stroke:#a170ff ChatInput-scyl4 -.- AdvancedAgent-c7337 linkStyle 2 stroke:#a170ff SupabaseComponent-nn4yr -.- AdvancedAgent-c7337 linkStyle 3 stroke:#a170ff SupabaseComponent-z7v6b -.- AdvancedAgent-c7337 linkStyle 4 stroke:#a170ff SupabaseComponent-ug1hf -.- AdvancedAgent-c7337 linkStyle 5 stroke:#a170ff SupabaseComponent-wulup -.- AdvancedAgent-c7337 linkStyle 6 stroke:#a170ff

🧩 Descripción general

El flujo Agente de Gestión y Normalización (Supabase) automatiza la interacción con usuarios que introducen descripciones de muebles y garantiza que los datos insertados en la tabla Muebles de Supabase cumplan las reglas de integridad y formato definidas. El agente recibe la petición, la procesa con el modelo Gemini, valida y normaliza la información, y ejecuta las operaciones CRUD correspondientes antes de responder al usuario.

⚙️ Funcionalidades principales

Recibir y almacenar la entrada del usuario en la conversación.
Procesar la petición con un agente avanzado que utiliza Gemini como modelo LLM.
Aplicar reglas de normalización: categorías, materiales, colores, nombres y precios.
Ejecutar operaciones de Insert, Update, Get y Delete sobre la tabla Muebles mediante herramientas de Supabase.
Construir y enviar una respuesta coherente al usuario a través del chat.

🔄 Pasos del flujo de trabajo

Nombre del componente	Rol en el flujo	Entradas clave	Salidas clave
Chat Input	Captura la entrada de texto del usuario y la almacena en la conversación.	Mensaje de usuario, ID de sesión, ID de conversación.	Mensaje listo para procesar.
Advanced Agent	Actúa como el cerebro del flujo, coordina la generación de texto y la ejecución de herramientas.	Mensaje del usuario, modelo Gemini, herramientas Supabase.	Mensaje de respuesta.
Gemini	Modelo de lenguaje responsable de generar el razonamiento y la respuesta.	Prompt del usuario, sistema prompt de gestión de inventario.	Texto generado, pensamientos opcionales.
Supabase – Insert	Inserta un nuevo registro de mueble en la tabla Muebles cuando la información está completa y validada.	Datos del mueble (nombre, categoría, material, precio, stock, color).	Registro insertado y confirmación.
Supabase – Update	Actualiza un registro existente en Muebles según el filtro proporcionado.	Filtros de búsqueda, nuevos valores de campo.	Registro actualizado y confirmación.
Supabase – Get	Recupera registros de Muebles que coinciden con los filtros especificados.	Filtros de búsqueda, límites de resultados.	Lista de registros encontrados.
Supabase – Delete	Elimina un registro de Muebles que coincide con los filtros.	Filtros de búsqueda, límite.	Registro eliminado y confirmación.
Chat Output	Presenta la respuesta generada por el agente al usuario en la interfaz de chat.	Texto de respuesta, datos formateados.	Mensaje visual en el chat.

Nota: Los componentes de Supabase actúan como herramientas que el agente puede invocar según la necesidad del flujo. No existe una ejecución lineal estricta entre ellos; el agente decide el orden y la combinación de operaciones en tiempo de ejecución.

🧠 Notas

El Agent Description y el System Prompt están configurados para que el modelo comprenda su rol como especialista en gestión de inventario y aplique reglas de formato estrictas.
Las credenciales de Supabase (supabase_url y supabase_service_key) se almacenan de forma segura y no se exponen en la documentación.
Se habilitó el fallback_models y model_retry en el agente para garantizar la disponibilidad y la recuperación ante fallos del modelo principal.
El componente LabelComponent está presente pero no conectado a la cadena de ejecución; puede servir para anotaciones o métricas de trazado.
El flujo está preparado para modo batch, aunque en esta instancia se ejecuta en modo interactivo (mapping_mode = false).
Los valores de configuración de los modelos y herramientas (p.ej. max_iterations, parallel_executions, stream_thinking) están predefinidos y pueden ajustarse según las necesidades operativas.