Entrada de Pedidos

graph TD %%{init: {'theme': 'mc','layout': 'elk'}}%% ChatInput-idt53[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Input] style ChatInput-idt53 stroke:#a170ff AdvancedAgent-slwuk[Agent] style AdvancedAgent-slwuk stroke:#a170ff GoogleGenerativeAIModel-t5o3f[Gemini] style GoogleGenerativeAIModel-t5o3f stroke:#a170ff Airtable-f9c4x[read] style Airtable-f9c4x stroke:#a170ff Airtable-pfewz[update] style Airtable-pfewz stroke:#a170ff ChatOutput-rxxgc[<div><img alt="logo" src="/_astro/messages-square.BaSDmT6g.svg" style="height: 20px !important;width: 20px !important"/></div>Chat Output] style ChatOutput-rxxgc stroke:#a170ff Airtable-m6dwr[create] style Airtable-m6dwr stroke:#a170ff ChatInput-idt53 -.- AdvancedAgent-slwuk linkStyle 0 stroke:#a170ff GoogleGenerativeAIModel-t5o3f -.- AdvancedAgent-slwuk linkStyle 1 stroke:#a170ff Airtable-f9c4x -.- AdvancedAgent-slwuk linkStyle 2 stroke:#a170ff Airtable-pfewz -.- AdvancedAgent-slwuk linkStyle 3 stroke:#a170ff AdvancedAgent-slwuk -.- ChatOutput-rxxgc linkStyle 4 stroke:#a170ff Airtable-m6dwr -.- AdvancedAgent-slwuk linkStyle 5 stroke:#a170ff

🧩 Descripción general

El flujo automatiza la interacción entre un cliente y un asistente virtual de ventas. El agente analiza las consultas del usuario, consulta el inventario en tiempo real, guía al cliente en la selección de productos, confirma el pedido y actualiza la base de datos de Airtable con los detalles de la compra, devolviendo una respuesta final de manera fluida y profesional.

⚙️ Funcionalidades principales

Captura y entrega al agente la entrada del usuario y los metadatos de la conversación.
Utiliza un modelo de lenguaje Gemini para generar respuestas coherentes y contextuales.
Se conecta a Airtable para leer el inventario, actualizar el stock y registrar los pedidos.
Coordina la interacción entre el agente y las herramientas de base de datos.
Presenta la respuesta generada al usuario a través del módulo de salida de chat.

🔄 Pasos del flujo de trabajo

Nombre del componente	Rol en el flujo	Entradas clave	Salidas clave
Entrada de chat	Recibir la consulta del usuario y preparar los metadatos de conversación	Mensaje del usuario, identificador de conversación y sesión	Mensaje que alimenta al agente
Agente avanzado	Coordinar la lógica de negocio y decidir qué herramientas utilizar	Mensaje del usuario, modelo Gemini y lista de herramientas (leer, actualizar, crear)	Respuesta generada (mensaje)
Modelo de Gemini	Generar texto a partir del prompt del agente y las instrucciones del sistema	Prompt del agente, instrucciones de sistema	Texto generado
Leer de Airtable	Consultar el inventario en tiempo real	Operación Read, tabla Productos, campos a leer, fórmula de filtro por producto	Registro de productos (nombre, stock, precios, etc.)
Actualizar en Airtable	Reducir el stock de los productos confirmados	Operación Update, ID del producto, valor actualizado del stock	Confirmación de la actualización
Crear en Airtable	Registrar el pedido en la tabla Pedidos	Operación Create, campos del pedido (ID, producto, cantidad, dirección, contacto, comprador)	Registro creado
Salida de chat	Entregar la respuesta al usuario	Mensaje generado por el agente	Mensaje visible al usuario

🧠 Notas

El flujo depende de credenciales válidas para la API de Google Gemini y la base de datos de Airtable.
Las actualizaciones de stock y el registro de pedidos solo se realizan después de la confirmación explícita del cliente.
El agente mantiene la coherencia de la conversación gracias a la memoria habilitada (use_checkpointer).
No se modifican datos de inventario ni se crean registros si la operación de la base de datos no recibe los parámetros necesarios.
El modelo Gemini está configurado con un system_prompt que define el tono y la política de respuesta del asistente.
Todos los componentes que interactúan con Airtable están encapsulados como herramientas (read_productos, update_records_productos, write_records_pedidos), lo que simplifica su reutilización en flujos futuros.