Scripts personalizados y Agente de tienda
Añade JavaScript de tienda y elige qué Habilidades están disponibles en un proyecto de tienda.
Los Scripts personalizados cambian el comportamiento de la tienda, mientras que el Agente de tienda cambia qué Habilidades puede usar Runner para el proyecto actual. Ambas son configuraciones específicas de la tienda y deben revisarse con cuidado extra.
Qué cubre esta guía
Podrás añadir y guardar un script, pausarlo sin eliminarlo, y añadir o deshabilitar una Habilidad solo para el proyecto actual.
Disponibilidad y requisitos previos
- Abre Configuración desde dentro del proyecto previsto.
- JavaScript personalizado puede cambiar el comportamiento de la tienda. Añade solo código que entiendas y en el que confíes.
- Las acciones de Habilidad dependen de las Habilidades de espacio de trabajo disponibles y de si una Habilidad del Sistema es configurable.
- La página completa del Agente y la puerta del plan aún controlan la disponibilidad más amplia de Habilidades.
Rutas de entrada
- Scripts: avatar → Configuración → Tienda → Scripts personalizados
- Habilidades del proyecto: avatar → Configuración → Tienda → Agente
Controles de Scripts personalizados
| Entrada o botón | Por qué es útil | Qué sucede después |
|---|---|---|
| Añadir script | Crea una entrada de script de tienda. | Se abre una nueva fila de Script habilitada con Código JavaScript vacío. |
| Fila de script | Expande o contrae su editor. | Nombre del script y Código JavaScript se hacen visibles. |
| Icono de ojo / ojo oculto | Habilita o deshabilita un script. | La fila local cambia de estado; selecciona Guardar cambios para aplicarlo. |
| Icono de eliminar | Elimina un script de la lista pendiente. | La fila desaparece sin un segundo diálogo; Guardar cambios aplica la eliminación. |
| Guardar cambios | Aplica cada edición de script pendiente. | Runner guarda la lista completa de scripts y muestra un mensaje de éxito o error. |
Runner permite hasta diez entradas de script. El botón Guardar cambios permanece deshabilitado cuando nada ha cambiado.
Añadir o cambiar un script
- Abre Tienda → Scripts personalizados.
- Selecciona Añadir script.
- Ingresa un Nombre del script claro y Código JavaScript de confianza.
- Deja el script habilitado solo si debe ejecutarse en la tienda.
- Revisa todas las otras filas porque Guardar cambios aplica la lista completa.
- Selecciona Guardar cambios y espera Guardado.
- Verifica la tienda de forma segura después de guardar.
Runner intenta evitar que un error de script bloquee la página, pero eso no hace que el código desconocido sea seguro. Un script aún puede afectar la privacidad, el rendimiento, el seguimiento y la experiencia del cliente.
Controles del Agente de tienda
| Entrada o botón | Por qué es útil | Qué sucede después |
|---|---|---|
| Fila de Habilidad activa | Ve qué Habilidad está disponible en este proyecto. | La fila muestra nombre, descripción y tipo Sistema o Personalizado. |
| Deshabilitar | Elimina una Habilidad configurable de este proyecto solo. | La Habilidad sale de la lista activa de este proyecto; no se elimina globalmente. |
| Añadir Habilidad | Añade una Habilidad de espacio de trabajo disponible a este proyecto. | Seleccionar una Habilidad listada la habilita para el proyecto actual. |
| Crear habilidad personalizada… | Crea una nueva capacidad personalizada. | Se abre el editor de Habilidades, luego la lista del proyecto se actualiza después del éxito. |
Configurar Habilidades del proyecto
- Abre Tienda → Agente.
- Revisa las Habilidades actualmente activas.
- Selecciona Añadir Habilidad, luego elige una Habilidad disponible o Crear habilidad personalizada….
- Espera el mensaje de éxito y confirma que la Habilidad aparece.
- Usa Deshabilitar cuando una Habilidad configurable deba dejar de aplicarse a este proyecto.
- Abre Centro de control → Agente para detalles completos de Habilidades, acciones de pausa, edición, importación o eliminación.
Estados y límites
- Los cambios de script permanecen locales hasta que Guardar cambios tenga éxito.
- Eliminar una fila de script no tiene confirmación separada antes de Guardar cambios.
- Alcanzar diez scripts deshabilita Añadir script.
- El Agente de tienda puede mostrar carga, un error, Sin habilidades habilitadas o la lista activa.
- Las Habilidades del Sistema fijas no muestran Deshabilitar.
- Deshabilitar en Agente de tienda cambia el alcance de este proyecto; no elimina ni pausa globalmente la Habilidad.
Solución de problemas
- Si un script aún se ejecuta, confirma que su estado deshabilitado fue seguido por Guardar cambios.
- Si Guardar falla, la lista guardada anteriormente permanece sin cambios; corrige el código o intenta de nuevo después del error.
- Si Añadir Habilidad no tiene la entrada esperada, verifica la página completa del Agente y el plan actual.
- Si Deshabilitar está ausente, la Habilidad del Sistema no es configurable para este proyecto.
- Si una nueva Habilidad aparece globalmente pero no aquí, añádela al proyecto desde Agente de tienda.