Trabajo con el asistente de AI
El asistente de AI está instalado y vinculado a la tienda, lo que significa que es hora de empezar a trabajar. En esta sección: cómo iniciar la conversación, cómo plantearle tareas, qué esperar de él y qué no, qué puede hacer por sí mismo y cómo abrir parte de sus capacidades a sus empleados.
Primer contacto
Entonces, la tienda está instalada, el asistente de AI está configurado. ¿Por dónde empezar? Escriba el primer mensaje de la forma más simple posible, para comprobar la conexión y ver errores si los hubiera. Por ejemplo:
El asistente de AI no responderá simplemente «todo bien»: irá probando cada herramienta una por una y le dirá exactamente cuál respondió. Algo así:
Hay conexión. Carpeta de trabajo D:\Melbis\MyFirstShop (no es un repositorio git), Windows 10, están disponibles tanto PowerShell como Bash.
Voy a comprobar que las herramientas realmente responden y no solo figuran como disponibles.
Bash funciona. Esta es la carpeta local de la tienda Melbis Shop. De paso también comprobaré el servidor MCP melbis: aquí la conexión es precisamente a través de él.
Comprobación de conexión: todo está en orden.
Sesión Melbis MCP:
- Tienda: MyFirstShop
- Carpeta: D:\Melbis\MyFirstShop
- Usuario: admin (en https://melbis.net)
El servidor está vinculado a esta tienda mediante su propia configuración; en esta sesión no se abrirá ninguna otra. El programa Melbis Shop funciona sobre la misma tienda, compilación 6.5.1.526. Se han proporcionado 27 herramientas de AI: catálogo, productos, pedidos, precios, usuarios, configuración, importación y archivos.
Lado local: tanto Bash como PowerShell responden, la carpeta de trabajo es D:\Melbis\MyFirstShop, Windows 10.
Hay dos puntos que conviene mencionar antes de empezar a trabajar:
- Mi memoria sobre esta tienda está vacía: esta es la primera sesión, aquí aún no se ha registrado ninguna de mis sesiones. Antes de la primera tarea tengo que leer la documentación de la plataforma y orientarme en la tienda. Esto llevará tiempo y desde fuera parecerá silencio; avisaré cuando empiece para no desaparecer sin decir nada.
- ¿Con quién estoy trabajando? La tienda pide registrarlo: ¿usted es el propietario, el desarrollador o un empleado con acceso ampliado? Estoy escribiendo con el usuario admin, y todo lo que cambie la tienda lo firmará con ese nombre; conviene decidirlo antes de que toque algo.
Cómo se presentará usted
Como ve, el asistente de AI le pedirá por sí mismo que aclare su papel en la tienda para elegir el estilo de comunicación adecuado. Pero el hecho de que usted se presente de cierta manera no le otorga a él los permisos de esa persona: actúa estrictamente bajo el usuario indicado en Melbis Shop.
Qué puede hacer exactamente ese usuario a través del asistente de AI se ve en la sección "System" > "Users", pestaña "Operations and Access Rights", rama "AI Assistant". A la izquierda está el árbol de operaciones, a la derecha quién las tiene abiertas: grupos y usuarios individuales.
Aquí no hay tantas operaciones, y no es casualidad. La mayor parte de ellas es «acceso directo»: Memory son las notas del asistente de AI, Tools sus herramientas, Direct access los archivos de la vitrina y el trabajo directo con la base de datos. Es evidente que ese tipo de acceso solo estará disponible para el propietario de la tienda o para un desarrollador de confianza. Más abajo explicaremos cómo trabajan con el asistente de AI los empleados normales sin estos superpermisos.
Por qué la tienda inicial es tan simple
Supongamos que usted se presentó como propietario de una tienda que acaba de instalar y quizá la ha rellenado un poco con datos básicos. Este es el momento ideal para responder a una pregunta que seguramente ya se le ocurrió en el primer arranque: por qué la tienda inicial es tan simple. Ahora ya podemos responderlo claramente.
Nuestra experiencia desarrollando software para crear tiendas se acerca a los 25 años. Como muchos, empezamos ofreciendo una tienda con una vitrina típica como ejemplo; muchos desarrolladores de plataformas siguen haciéndolo hoy. Pero Melbis Shop 6 ya ha superado esa etapa: en seis generaciones, sus capacidades han crecido demasiado.
Entiéndalo: al intentar construir una tienda típica de ejemplo, le estaríamos haciendo un flaco favor. Junto con el ejemplo, usted recibiría también las limitaciones incorporadas desde el principio, y lo comprendería solo tras años de trabajo, cuando resultara que precisamente para su modelo de negocio la tienda debería haberse diseñado de otra forma, y rehacerla ya sería muy caro. En esencia, si necesita un proyecto típico, entonces en realidad ni siquiera necesita su propia tienda: basta con una plataforma en un marketplace, donde las capacidades unificadas ya vienen dadas.
Por eso, hasta hace poco, los clientes de Melbis Shop 6 eran tiendas sectoriales bastante grandes que contrataban desarrolladores para su proyecto único. La barrera de entrada era alta, y vendimos notablemente menos licencias que de Melbis Shop 5, que desde el inicio venía con funcionalidad y diseño típicos.
Sin que usted lo note, dentro de Melbis Shop 6 hay un núcleo con una enorme experiencia, documentación y práctica de implementaciones reales. Precisamente por eso seguimos sin ofrecerle un ejemplo típico de tienda: lo consideramos un insulto a su intuición empresarial, unas cadenas que frenan el impulso creativo y lo llevan por un camino ya trillado. En lugar de eso, le abrimos la puerta al trabajo conjunto con el asistente de AI, que le permitirá ocuparse de las ideas y no de la rutina.
Cómo empezar su negocio
Nuestro consejo: lo mejor es empezar por describir su modelo de negocio. Además, el asistente de AI no necesita un plan de negocio perfectamente redactado y pensado hasta el último detalle. Escriba simplemente tal como es, tal como se lo contaría a un amigo: qué proyecto quiere hacer y qué hará falta para ello. Las ideas irán llegando a medida que el proyecto evolucione, y eso es completamente normal. Y hay cosas que el propio asistente de AI aclarará y sugerirá por sí mismo.
Aquí tiene un ejemplo de ese primer mensaje: un relato normal sobre el negocio, sin términos ni estructura:
Lo primero que hará el asistente de AI será descomponer esto en puntos claros y mostrar el plan antes de cambiar nada:
Este es mi plan, ahora lo ejecutaré:
| # | Qué | Con qué |
|---|---|---|
| 1 | Monedas: grivna (principal), dólar, euro | herramienta «Monedas» |
| 2 | 3 proveedores, 4 marcas | herramientas «Proveedores» y «Marcas» |
| 3 | Catálogo: 4 secciones, 12 subsecciones | herramienta «Catálogo» |
| 4 | Características de productos (material, color, tamaño…) | herramienta «Características» |
| 5 | Campos de registro del comprador, opciones de pedido (entrega, pago, estado), grupos de compradores | directamente con consultas: no hay una herramienta lista para esto |
| 6 | 12 productos de demostración con imágenes gratuitas | cargadores de productos y archivos |
| 7 | 2 grupos y 2 usuarios con permisos exactos | herramienta «Usuarios» — después de que cierre la ventana |
Fíjese en el séptimo punto: el asistente de AI advirtió que la tabla de usuarios estaba ocupada por una ventana abierta del programa, y pospuso esa parte por sí mismo para más tarde. Después sigue el plan y va explicando lo que hace y por qué. Primero lee la documentación de la plataforma y echa un vistazo a la tienda:
Me pongo con ello. Antes de tocar nada, necesito leer la documentación de la plataforma y examinar la tienda; no tengo memoria de ella, esta es la primera sesión. Esta etapa es silenciosa y no rápida, así que iré comentando el proceso para que no parezca que se ha quedado bloqueado.
Leído el índice de documentación MCP
Índice leído. Ahora las páginas principales: sesión, memoria, herramientas y recetas de tareas típicas.
Ejecutados 4 comandos
La documentación sobre sesión, memoria y herramientas ya está asimilada. Ahora la página de recetas y una mirada a lo que ya hay en la tienda.
Leído el documento con recetas
He terminado con la documentación. Ahora voy a mirar el estado actual de la tienda: usuarios, catálogo, monedas, ajustes básicos.
Ejecutados 2 comandos, utilizadas 3 herramientas (2 con error)
La tienda está casi vacía: un usuario (admin), un grupo (Administradores). Voy a estudiar la estructura de las tablas en las que escribiré.
Ejecutado un comando, utilizada una herramienta
La tienda está completamente vacía: solo la sección raíz; no hay productos, monedas, grupos de clientes, campos de registro ni opciones de pedido. Voy a leer los valores del registro de configuración a los que me referiré más adelante.
melbis: engine db select
Ahora el árbol de permisos, para los dos nuevos usuarios, y la configuración de idioma de la vitrina.
Luego viene el trabajo en sí. Aquí se ve bien cómo el asistente de AI no solo ejecuta, sino que busca el camino corto: en lugar de 79 llamadas separadas para asignar permisos, comprueba cómo están organizados los identificadores y lo hace todo con una sola consulta.
He terminado con el catálogo. Voy a comprobar si las tablas de usuarios ya están libres.
melbis: engine db locks
Todo está libre. Creo dos grupos y dos usuarios.
Se han utilizado 4 herramientas
Ambos usuarios están creados. Ahora sus permisos, y aquí hay un obstáculo que conviene decir en voz alta: CmdRightAdd asigna una operación por llamada, y estas dos funciones necesitan unas 75 operaciones entre las dos. Voy a comprobar si la tabla de permisos genera por sí sola los identificadores: en ese caso, haré todo con un solo lote en vez de 75 accesos.
melbis: engine db select
El identificador viene del generador de Melbis, no de AUTO_INCREMENT; por tanto, un solo lote con pasos generate lo resolverá en una sola llamada. Primero veré qué filas de permisos ya existen.
Ejecutados 2 comandos, utilizada una herramienta
Se han comprobado los 79 identificadores de operaciones. Los escribo en un solo lote: bloqueo, 79 identificadores generados, una inserción de múltiples filas.
melbis: engine db execute
Se insertaron 79 filas de permisos en un solo lote. Ahora, los permisos sobre secciones: en Melbis el acceso al catálogo se concede por secciones, además de los permisos sobre operaciones.
Se han utilizado 2 herramientas
Ahora, las características de productos. Voy a ver qué acepta la herramienta «Características».
Matices del asistente de AI
¿Puede equivocarse? Sí, puede. A veces no le entiende a la primera o no ha leído del todo la documentación de Melbis Shop 6, que, hay que decirlo, es bastante extensa. Por eso, dele al asistente de AI tiempo para aprender y cometer errores. Es una etapa inevitable, pero le aseguramos que la supera mucho más rápido que una persona y luego ejecuta las operaciones rutinarias de forma más precisa y mejor, dejándole a usted el trabajo creativo.
Otro punto al que conviene prestar atención. En la esquina inferior derecha hay un círculo: púlselo y se abrirá una ventana con las estadísticas actuales.
Lo primero es la ventana de contexto: cuánta información es capaz de mantener el asistente de AI en memoria a la vez. Se comprimirá automáticamente (o manualmente, con el comando /compact), y al hacerlo olvidará parte de los detalles. Pero no es una amnesia completa: internamente dispone de mecanismos para registrar datos intermedios, y además Melbis Shop 6 le permite guardar sus notas directamente en la base de datos de la tienda. Así que incluso si cambia de ordenador, lo importante no se perderá.
Lo segundo son los límites de su plan tarifario: cuánto se ha consumido en cinco horas y en una semana. Su consumo también se ve aquí, así que siempre sabrá cuánto margen le queda.
Primer resultado
Así pues, el asistente de AI ha terminado su primer trabajo. Al final, comprueba lo realizado con ojos de comprador, guarda las conclusiones en la memoria de la tienda —para que la siguiente sesión no empiece desde cero— y se pone con el proceso de negocio:
Los 12 iconos ya están listos. Voy a comprobar que la vitrina ya no muestra marcadores de posición.
Ya no quedan marcadores de posición (en la página principal se ven 8 de 12: ese es el tamaño del bloque en la plantilla). Comprobación final de todo:
Todo comprobado. Voy a guardar en la memoria de la tienda lo que he aprendido, para que la siguiente sesión no empiece desde cero.
Ahora, el proceso de negocio. Tendrán que seguirlo tanto su amiga como su hija, así que lo prepararé como una página independiente y no lo dejaré en la conversación.
24 min 45 s · 21,2 mil tokens
No solo el asistente de AI llenó la tienda: además redactó un componente importante de cualquier negocio, una hoja de ruta de procesos de negocio, que guardó en la sección Artifacts. Es una página independiente que puede compartir con sus empleados mediante un enlace. En ella se detalla quién hace qué y en qué ventana del programa:
Handicraft Shop Operations — «Cómo está organizado el trabajo de la tienda de manualidades». Quién hace qué, en qué ventana del programa y en qué momento pasa el trabajo al siguiente: está escrito para tres personas.
Who does what — «Quién hace qué». Los permisos se asignan a grupos, no a personas. Para añadir una cuarta persona, créale un usuario y colóquelo en el grupo adecuado: los permisos vendrán con él.
Owner (admin) — «Propietario»: proveedores, precios, ventas y toda la configuración de la tienda. Friend — product descriptions (content) — «Amiga — descripciones de productos»: textos, características, fotografías; no ve datos comerciales. Daughter — orders & shipping (orders) — «Hija — pedidos y envíos»: gestiona el pedido desde el primer contacto hasta la entrega y controla las existencias.
Y cómo recorre un producto el camino desde la lista de precios del proveedor hasta la ficha en la vitrina, paso a paso, indicando quién es responsable de cada uno:
How a product reaches the shop window — «Cómo llega un producto a la vitrina». Cinco pasos desde la lista de precios del proveedor hasta una ficha de producto activa. El orden es importante: mientras la descripción no esté lista, el producto no se muestra a los compradores.
01. The product is entered — «El producto se da de alta». Propietario · Productos › Listas de precios o Productos › Precios. Cargar la lista de precios del proveedor o añadir el producto manualmente, indicando de inmediato proveedor, precio de compra y venta, cantidad y sección del catálogo. Estado: «Redactar descripción», el producto permanece oculto.
02. The description is written — «La descripción está escrita». Amiga · Productos › Descripciones. Filtro por el estado «Redactar descripción»: esa es precisamente la cola de trabajo: nombre, texto corto, descripción completa, características, fotografía. Ficha lista: estado «Listo». Si falta algo, no inventarlo, sino dejar la tarea al propietario (paso 5).
03. It goes live — «El producto sale a la vitrina». Propietario · Productos › Precios. Una vez al día, revisar los productos en estado «Listo»: comprobar precio y margen y activar la visibilidad. Desde ese momento, el producto está en la vitrina.
Visual, cómodo y rápido.
Ahora ya puede abrir el sitio y ver qué ha salido. El catálogo con secciones por temas y fichas de producto:
La página de producto, con precio, disponibilidad, descripción y características:
Y un sencillo formulario de pedido con los campos de registro del comprador que el asistente de AI creó a partir de su descripción:
Esta es la primera iteración funcional de la tienda. A partir de aquí, todo es simple: paso a paso vamos afinando, describiendo tareas y avanzando hacia el ideal deseado.
Paso a paso
Por ejemplo, las imágenes del catálogo se ven mal: tienen distintas proporciones y la cuadrícula parece irregular:
La tarea puede plantearse exactamente con las mismas palabras con las que usted la ve; no es obligatorio saber nada sobre perfiles de imagen:
Buena observación: es mi trabajo. En el perfil está smart: true, es decir, «encajar en el marco, manteniendo las proporciones», y no rellenarlo. Por eso cada icono quedó con la forma que tenía la foto original: hilo 400×225, tijeras 303×400, libro para colorear 400×400. En la cuadrícula eso se percibe como irregular.
Voy a comprobar qué da la configuración opuesta antes de aplicarla a las doce imágenes.
Exactamente 400×400. Ahora voy a mirar el resultado visualmente: «rellenar» puede significar márgenes en los bordes, estiramiento o recorte, y son cosas muy distintas.
smart: false coloca la imagen sobre un lienzo blanco de 400×400: no se recorta nada, no se estira nada. Eso es precisamente lo que necesita la cuadrícula. Reconstruyo las otras once.
Las doce ahora son 400×400. Elimino los iconos irregulares antiguos para que a cada producto le quede exactamente uno.
La vitrina ya sirve los nuevos iconos cuadrados. Los descargaré y veré la cuadrícula tal como la verá el comprador.
Y voilà, listo: la cuadrícula se alineó:
Pero el asistente de AI no se detuvo ahí. Él mismo vio que los márgenes blancos en los bordes eran solo la mitad de la solución, recortó las imágenes a formato cuadrado y explicó honestamente dónde está el límite de sus capacidades:
Listo: ahora el catálogo toma un cuadrado del centro de cada fotografía, y cada imagen llena por completo su mosaico. Ya no hay franjas blancas a los lados ni arriba. La tienda ya las muestra así.
Hay dos cosas que conviene saber, en palabras sencillas:
La tienda sabe cambiar el tamaño de las imágenes por sí sola, pero no puede decidir qué parte de la fotografía conservar. Eso es una cuestión de gusto —qué ángulo es importante, dónde está situado el producto en el encuadre—, y la tienda se lo deja a la persona. Cuando usted o su amiga añaden una fotografía en el programa, la imagen tiene una herramienta de recorte; una vez ajustada como a usted le guste, puede pedir al programa que lo recuerde y lo aplique de inmediato a todo el lote de fotografías. Ese botón es justo el que le resultará útil cuando cargue un paquete de fotos de un proveedor.
Los fondos siguen siendo diferentes, y el recorte no lo arreglará. Mire la vitrina: tijeras sobre tela rosa, hilos sobre azul, pinturas sobre blanco. Son doce fotografías de stock que no tienen relación entre sí. Todo se corregirá cuando aparezcan sus propios productos: el recurso habitual es fotografiar todo sobre el mismo fondo liso, y entonces el catálogo se ve como una sola tienda y no como doce distintas.
Y una concesión que hice por usted: como se toma un cuadrado, los bordes de la foto original desaparecen en la imagen pequeña. La foto completa sigue intacta en la página del producto; solo se recorta la imagen pequeña del catálogo. Si alguna le parece poco acertada, dígame cuál, y la reencuadraré más arriba, más abajo o hacia un lado.
Y aquí está el resultado: las imágenes cuadradas llenan por completo las celdas:
Por supuesto, también se puede entrar en la tienda a través del programa. En la sección "Descripciones" se ven todos los productos introducidos por el asistente de AI con imágenes, características y textos; se pueden corregir manualmente:
Y en la sección "Precios" está toda la parte comercial: proveedor, precio de compra y de venta, moneda, cantidad y estado del producto:
Desarrollo recursivo
Como ve, en apenas media hora hemos recorrido el camino desde una idea simple hasta un primer resultado. Seguro que ya tiene preguntas: ¿hasta dónde puede ampliar el asistente de AI las capacidades de la tienda? Y si usted puede trabajar así de rápido, sería bueno que los empleados también trabajaran igual, pero entonces, ¿hay que darles acceso total?
Tranquilidad. Usted ha invertido en Melbis Shop 6, y aquí hay una estructura escalable.
Ante todo: el asistente de AI en modo de acceso directo, es decir, como administrador, tiene unos permisos enormes, tanto en recursos como en capacidad de autosuperación. No solo puede introducir productos y establecer configuraciones: es capaz de desarrollar y perfeccionar la arquitectura de la base de datos, construir la vitrina y los módulos internos, mirar la vitrina con ojos de comprador, analizarla, obtener informes internos sobre el rendimiento del sistema y aplicar correcciones. Pero lo más importante es que puede perfeccionar herramientas. Tanto las suyas como las ajenas.
¿Recuerda la rama de permisos de la captura de pantalla de arriba: AI Assistant > Tools > Get list y Execute? Esos son comandos especiales que puede abrir a sus empleados, y entonces tendrán acceso a las herramientas del asistente de AI desarrolladas específicamente por usted o incluso por ellos mismos.
En la tienda inicial de Melbis Shop 6 ya hemos creado y añadido varias de estas herramientas. Le serán útiles por sí mismas y servirán como ejemplo de aprendizaje para su asistente de AI. Para verlas, abra la sección "Development" > "AI tools".
A la izquierda está el catálogo de herramientas, distribuido por secciones del programa: productos, pedidos, proveedores, estructura. A la derecha están los comandos de la herramienta seleccionada con sus descripciones, y debajo los parámetros de cada comando: qué es obligatorio, qué valor va por defecto, qué significa cada campo. Precisamente a partir de estas descripciones el asistente de AI entiende cómo utilizar la herramienta.
Pero lo más interesante es la pestaña "Command Rights": aquí indica a qué empleado se le permite qué. Es decir, un empleado puede invocar al asistente de AI y utilizar los comandos de la herramienta que usted le haya abierto, y nada más allá de eso.
Y en secciones como "Catalog", además puede establecer el nivel de acceso a una sección concreta del catálogo: quién puede ver la vitrina de la sección, quién puede editar descripciones y quién precios.
Si lo desea, las herramientas pueden guardarse y transferirse —o actualizarse— de una tienda a otra. También puede pedir al asistente de AI que traduzca sus descripciones a su idioma para que sea más fácil trabajar. Incluso puede encargarle que distribuya los permisos. Aquí ya la cuestión es qué resulta más rápido: escribir la tarea al asistente de AI o recorrer usted mismo las opciones.
Cómo organizar el trabajo
Recomendamos dividir las tareas por temas separados. En la ventana de Claude Code, a la izquierda, en la lista de temas, pulse + e inicie un nuevo diálogo. Así cada tema tendrá su propia memoria y su propia historia, y no se interferirán entre sí. Aquí, por ejemplo, un diálogo separado en el que cambiamos la apariencia de la tienda de demostración:
Fíjese: la plantilla está hecha con una tecnología completamente distinta, y el asistente de AI no intentó arrastrarla al proyecto, sino que trasladó el lenguaje visual —colores, redondeos, sombras, tipografía— al marcado que la tienda ya tiene. Este es su informe:
Qué hice
Aquí no se puede instalar BloomShop: es Next.js 16 + React 19 + Tailwind 4 + Radix, mientras que su vitrina es un sistema de plantillas de Melbis en PHP que sirve Bootstrap 4. Por eso reproduje su lenguaje visual con CSS normal sobre el Bootstrap que usted ya tiene conectado, sin nuevas dependencias y sin recompilar bundles.
Tomé los valores reales del diseño de las variables CSS de la demo en vivo, no los ajusté a ojo: ámbar #f59e0b como principal, #fffbeb / #92400e como acento, #262626 para texto, #6b7280 atenuado, radio 1.225rem, botones tipo píldora, sombras suaves, tipografía Inter. Todos ellos están en propiedades --bloom-* al principio de templates/default/statics/melbis/main.css; desde ahí se puede recolorear toda la tienda.
Reescrito: hoja de estilos y 13 plantillas — cabecera (barra fija, escritura bicolor MELBISSHOP, carrito, menú en línea aparte), pie de página (tres columnas, redes sociales, barra inferior), página principal (primer pantallazo, banda de ventajas, cuadrícula de destacados; se ha quitado el jumbotron «Melbis Shop 6 Working!»), páginas de secciones, ficha de producto y el resto.
Otra media hora, y aquí está el resultado final. La página principal con primer pantallazo, banda de ventajas y cuadrícula de productos destacados:
Y la página de producto en el mismo estilo. Sin comentarios.
