Información general de Experience Modernization Agent experience-modernization-agent
El agente de modernización de experiencias es el agente de desarrollo de IA de Adobe para Edge Delivery Services y forma parte de Brand Experience Agent. Le proporciona un entorno de desarrollo listo para usar en su explorador, sin nada que instalar.
Puede empezar migrando el contenido y el diseño de un sitio y luego seguir trabajando con el agente para integrar sistemas de terceros, rediseñar el sitio, refactorizar sus bloques o ampliar su funcionamiento. Los desarrolladores pueden crear integraciones y comportamientos complejos, mientras que los diseñadores y los especialistas en marketing refinan la apariencia del sitio al solicitar ayuda en lugar de escribir CSS o JavaScript. Los conocimientos que necesita dependen del trabajo.
Para ver el primer resultado en tus propias páginas, prueba el modo automático. Es la mejor manera de evaluar Adobe Experience Manager con el contenido y el diseño de su propio sitio web. Asigne la dirección URL del sitio; migrará un conjunto de páginas y le enviará un correo electrónico cuando termine.
Mover el sitio a Edge Delivery Services benefits
Utilice el agente para mover propiedades web a Edge Delivery Services desde otros CMS, desde sitios de Experience Manager creados con componentes de Java o desde sitios estáticos.
El diagrama anterior rastrea la migración desde el sitio de origen a un sitio en el que su equipo puede seguir evolucionando en Edge Delivery Services. El panel izquierdo muestra el diseño, el contenido y las funciones dinámicas del sitio de origen a medida que los visitantes las ven, además de sus etiquetas y análisis. De forma predeterminada, el agente usa las páginas procesadas del sitio actual como origen de la migración, a menos que indique al agente que realice un rediseño y proporcione archivos de diseño como diseños de Figma.
El panel derecho muestra el resultado deseado: el sitio completo arrastrado, con sus funciones dinámicas reconstruidas y su configuración de análisis, administrador de etiquetas y consentimiento nuevamente en su lugar. El objetivo de la migración es ayudar a su equipo a aprovechar al máximo lo que ofrece Edge Delivery Services:
- Desarrollo rápido: Una configuración de desarrollo web estándar y ligera que resulta familiar a los desarrolladores y a sus agentes, por lo que resulta más eficiente.
- Creación visual automática: los autores ensamblan páginas de bloques con marca en Experience Workspace o el Editor universal, y también pueden solicitar cambios de contenido.
- Páginas rápidas y rastreables: La plataforma sirve HTML semántico y rápido para ayudar a mejorar la visibilidad de la búsqueda y la IA. Ver Mantenerlo 100.
- Espacio para crecer: La plataforma ejecuta algunos de los sitios más grandes de múltiples mercados y múltiples idiomas, con integraciones complejas.
Para alcanzar ese objetivo, el agente automatiza gran parte de los siguientes pasos:
- Leer cada página. La importación de páginas funciona a partir de lo que procesa el explorador. Si un origen requiere inicio de sesión, configure Autenticación de sitio protegido. Para la protección de bots, organice el acceso autorizado con el administrador del sitio: pueden almacenar en lista de permitidos las direcciones back-end del agente o puede utilizar un host de origen o de ensayo accesible con el mismo contenido. Si solo está bloqueado el descubrimiento de páginas, proporcione las direcciones URL directamente. Ver Sitios Source con protección para bots.
- Analizar la estructura. El catálogo del sitio crea inventarios de páginas y las agrupa en plantillas, secciones y bloques, con capturas de pantalla. Revise las agrupaciones, establezca el ámbito, elija el diseño de destino y el modelo de contenido, y decida qué migrar primero.
- Importar el contenido. Para cada plantilla, el agente analiza una página de muestra y la asigna a contenido predeterminado y bloques reutilizables. Importa el ejemplo como una página editable y genera scripts de importación que aplican la asignación a otras páginas de esa plantilla.
- Reconstruir el diseño. El agente extrae tokens de diseño CSS para colores, fuentes y espaciado y, a continuación, escribe los estilos globales y bloquea los CSS que los utilizan. Reconstruye el marcado en lugar de clonar el código fuente y su deuda técnica.
- Comparar, perfeccionar y validar. El agente compara la página reconstruida con su origen e itera cuando se le solicita. Refine la asignación y el diseño y, a continuación, valide cada ejemplo antes de escalarlo con los scripts generados. Las correcciones a un bloque reutilizable o a un script de importación se aplican a todas las páginas de esa plantilla. La guía de migración de producción abarca lotes, comprobaciones, versiones y traspasos.
- Expandir, rediseñar, optimizar e integrar. Después de la migración, pídale al agente que reconstruya las funciones dinámicas o que añada integraciones. El modo automático puede transmitir los análisis compatibles, el administrador de etiquetas y la configuración de consentimiento; consulte Qué puede leer y qué puede arrastrar la importación de página. Si desea que algunas páginas muestren a las partes interesadas, siga Crear una demostración para el cliente. Si desea que los ingenieros de Adobe operen el agente con su equipo, consulte Envío por ingenieros de resultados del agente.
Qué puede leer y arrastrarse la importación de página limitations
Utilice únicamente sitios web y diseños que tenga autorización para migrar. El flujo de trabajo seleccionado debe poder alcanzar y leer el origen. Si el sitio utiliza la protección contra bots, organice el acceso con su administrador. Ver sitios de origen con protección para bots.
- El agente lee cada origen a través de Internet desde su entorno alojado. Las páginas que requieren inicio de sesión o un encabezado secreto se pueden migrar cuando el origen acepta uno de los métodos de Autenticación de sitio protegido. Esa sección también indica qué preguntar al administrador del sitio cuando no se puede acceder a un origen de esta manera.
- El agente carga cada página de origen en un explorador y la lee una vez procesada. Esto incluye el contenido que insertan los scripts y el contenido que contiene la página, pero que CSS oculta, como un panel de acordeón cerrado. El contenido que aparece únicamente después de que un visitante hace clic o escribe no está en la página en ese momento, por lo que no se captura. Compruebe estas páginas en las capturas de pantalla y añada el contenido que falta después de la importación o pida una forma de capturarlo.
- El agente se dirige a Edge Delivery Services, incluidos los sitios que utilizan Experience Manager authoring. No convierte un proyecto en una publicación basada en HTL o en una pila de envíos solo de API/SPA.
- La importación de página copia lo que muestra la página de origen: su contenido y su diseño. No puede ver cómo los servidores de origen produjeron esa página. Herencia de contenido, reutilización mediante fragmentos de contenido, reglas de personalización, búsqueda, procesamiento de formularios y otras lógicas empresariales que se ejecutan allí, por lo que la importación copia su resultado en esa página, no la lógica. El agente también reconstruye el marcado en lugar de copiarlo, por lo que los scripts del origen, como las etiquetas de análisis y experimentación, no se incluyen. La opción Incluir integraciones del modo automático transfiere las configuraciones de análisis, administrador de etiquetas y consentimiento admitidas. Decida cómo funcionan los demás en el nuevo sitio; a continuación, el agente puede crear los bloques y el código para él. Ver Lo que queda del trabajo del proyecto y, para los formularios, Envíos de formularios.
- La crítica visual del agente compara el aspecto del resultado con la fuente. Con el mismo aspecto, no se ve que los autores puedan editar la página, que las interacciones funcionen o que sea accesible y rápido en dispositivos reales, así que compruébalos antes de cerrar sesión.
Cómo se crea y actualiza su sitio project-foundations
El resultado es un proyecto estándar de su propiedad: HTML, CSS y JavaScript en su repositorio Git, siguiendo las convenciones de la plantilla de AEM y la Colección de bloques, con contenido almacenado por separado para que los autores lo editen. Los desarrolladores pueden continuar en la consola, en su propio editor o con otras herramientas de IA.
El sitio web de origen proporciona el contenido y el diseño. Puede añadir un diseño Figma como un nuevo destino para todo el sitio o parte de él. El agente lee estas fuentes sin cambiarlas y genera el resultado en su espacio de trabajo de la consola.
Git almacena los estilos, scripts y bloques del sitio. Su rama contiene código para revisar; main contiene código de producción. El entorno de creación almacena el contenido. Edge Delivery Services combina ese contenido con el código de la rama que muestra cada vista previa o dirección URL activa.
Las páginas están formadas por secciones, contenido predeterminado y bloques, y el contenido no lleva ningún estilo, por lo que el agente puede darle un nuevo diseño cambiando únicamente el código. Para ver cómo funciona la plataforma, consulta la descripción general de Edge Delivery Services y Marcado, secciones, bloques y bloqueo automático. Para obtener información sobre cómo el agente estructura el contenido importado y cómo lo dirige, consulte Dar forma a la estructura de contenido.
Los nuevos sitios comienzan desde AEM. Para una tienda de comercio, empieza desde la plantilla de comercio, ya que sus bloques de comercio son difíciles de agregar a un proyecto más adelante; consulta Comenzar desde un repositorio.
Trabajar de forma segura en un Workspace independiente independent-workspace
El agente no cambia su repositorio de Git ni su destino de contenido directamente. Funciona en un espacio de trabajo de la consola: su propia copia de trabajo del proyecto, alojada en Adobe y no compartida con otros usuarios. El espacio de trabajo contiene una extracción de una rama del repositorio de Git y copias de las páginas de contenido que ha importado, abierto o extraído.
Todo lo que hace el agente sucede allí primero. Puede solicitar un rediseño radical, comprobarlo en la vista previa de la consola y descartar lo que no desee, mientras que el repositorio, las páginas de los autores y el sitio activo permanecen sin cambios. Work deja el espacio de trabajo solo cuando se envía, en dos operaciones independientes:
- Código push envía los archivos modificados que ha seleccionado a su repositorio Git, como una confirmación en la rama actual o como una nueva solicitud de extracción.
- Cargar contenido envía las páginas seleccionadas a Experience Workspace o a la instancia de autor, donde reemplazarán las versiones guardadas de esas páginas.
Permisos de agente permiten que el agente haga lo mismo por usted. Ver Control sobre los cambios.
La independencia funciona en ambas direcciones: los cambios que otros insertan o cargan no llegan al espacio de trabajo hasta que se extraen. Ver Sincronizar menú y Trabajar como un equipo.
Dónde se almacena el contenido y cómo lo editan los autores content-storage
El agente pregunta dónde se debe almacenar el contenido migrado. Qué repositorio contiene el contenido y qué editor utilizan los autores son preguntas relacionadas pero independientes. El CMS de origen no decide el destino. Con cualquiera de las opciones, los autores obtienen un editor visual y Edge Delivery Services entrega las páginas.
Almacenamiento basado en documentos con Experience Workspace document-based
El contenido se almacena como documentos en el repositorio de contenido basado en documentos. “Basado en documentos” describe solo el almacenamiento, no la experiencia de creación. Los autores editan las páginas visualmente en Experience Workspace, la interfaz de usuario para la creación visual de Edge Delivery Services, que también ofrece un asistente de IA, colaboración e integración con Experience Manager Assets. Experience Workspace está desactivado de forma predeterminada y se activa por sitio u organización en la configuración del proyecto. Cuando transfiere un sitio en modo automático a un destino basado en documentos con Configúrelo como suyo, la transferencia lo activa para ese sitio.
Creación de Experience Manager con el editor universal jcr-persistence
El contenido se almacena en el repositorio de contenido Java (JCR) de una instancia de autor de Experience Manager as a Cloud Service, una configuración anteriormente denominada Crosswalk. Los autores editan páginas con Universal Editor, el editor visual de Adobe para el contenido en la instancia de autor y Edge Delivery Services sigue entregando las páginas. HTL y Java no los procesan, como sucede en los sitios de Experience Manager creados con componentes. Los repositorios de plantillas para esta configuración, como aem-block-collection-xwalk, aún llevan xwalk en sus nombres.
Estos documentos usan Experience Manager authoring para esta opción de almacenamiento, y instancia de autor para el entorno de Experience Manager as a Cloud Service donde se almacena y edita ese contenido.
Recomendación de Adobe recommendation
Para cualquier nueva implementación, Adobe recomienda encarecidamente el almacenamiento basado en documentos con Experience Workspace sobre la creación de Experience Manager con el editor universal. Esto incluye sitios web grandes con miles de páginas.
La creación basada en documentos solía significar escribir páginas en Microsoft Word o Google Docs, almacenadas en SharePoint o Google Drive, que siguen siendo fuentes de contenido compatibles, o en Document Authoring, un editor de estilo de documento. Ninguno de ellos ofrecía edición visual de páginas, por lo que los equipos que la necesitaban a menudo elegían la creación de Experience Manager. Experience Workspace sustituye a la creación de documentos y proporciona al contenido basado en documentos un editor visual. Un sitio que utiliza la creación de documentos puede activar Experience Workspace y su contenido existente funciona allí sin una migración. Esto no deja ninguna razón para que una marca evite el almacenamiento basado en documentos. Cuando lea un artículo sobre la creación basada en documentos, compruebe cuándo se escribió.
La creación de Experience Manager sigue siendo totalmente compatible. Selecciónelo cuando un requisito específico dependa de que el contenido permanezca en el JCR. Para el contenido sin encabezado, entregado a través de API en lugar de como páginas web, el editor universal sigue siendo el editor recomendado.
Cómo se activan los cambios code-content-lifecycle
En el diagrama, las columnas azules muestran ramas de código y las filas moradas muestran estados de contenido. El código push nunca guarda el contenido, y la carga de contenido nunca cambia el código.
- Código: Edge Delivery Services recupera su código de GitHub a través de la aplicación AEM Code Sync, o de otro host de Git a través de Cloud Manager (Traer su propio Git). Cada rama obtiene sus propias direcciones URL, y un cambio insertado en una rama se muestra en la vista previa de esa rama y en las direcciones URL activas al mismo tiempo. El código no tiene paso de publicación independiente: después de la revisión, al combinarlo en
mainse actualiza inmediatamente el código del sitio de producción, por lo que debe comprobar una rama en sus propias direcciones URL antes de combinarla. - Contenido: Los autores obtienen la vista previa de una página, que copia el contenido guardado en el sitio de vista previa de
*.aem.page. Luego lo publican, para que esté activo en*.aem.live. Los autores lo hacen tanto desde la interfaz de usuario de creación como desde la extensión del explorador AEM Sidekick.
Las direcciones URL de vista previa siguen el patrón https://{branch}--{repo}--{owner}.aem.page y muestran el contenido de vista previa. Las direcciones URL activas siguen el mismo patrón en aem.live y muestran el contenido publicado. {owner} es la organización o el usuario de GitHub propietario del repositorio y {repo} es el nombre del repositorio. El contenido no se ramifica: cada rama muestra las mismas páginas, cada una con su propio código. La dirección URL activa de main es el sitio de producción, al que sirve su propio dominio después de la migración.
Seguir desarrollando el sitio creation-migration
La migración no es el final del trabajo del agente. Su equipo puede aplicar un nuevo diseño de marca de Figma, crear nuevas páginas a partir de bloques existentes o rastrear un error. También puede auditar el rendimiento, la accesibilidad y la SEO y, a continuación, corregir lo que la auditoría encuentre. Ver Sitios de restyle, rediseño guiado y Crear, actualizar y refactorizar bloques. Si su sitio ya se ejecuta en Edge Delivery Services, conéctelo y comience aquí sin una migración.
Los bloques de pueden llamar a las API de para buscar, comercializar, personalizar, mapas, vídeo o sus propios servicios, como en cualquier otro sitio web. Las hojas de cálculo se publican como JSON y un índice de consulta enumera las páginas del sitio, por lo que los bloques también pueden crear listas y filtros a partir de su propio contenido. La lógica empresarial permanece en los servicios que la poseen. Especifique y pruebe cada integración, y el agente podrá escribir su código de bloque una vez que haya decidido cómo debería funcionar. Ver Crear un bloque dinámico y Conectar servicios y aplicaciones.
Los flujos de trabajo integrados del agente se centran en Edge Delivery Services, pero su trabajo no se limita a ellos. Apúntela a la documentación de otro sistema y soluciona la integración con él, tal como se describe en Trabajar más allá de Edge Delivery Services. La referencia de capacidad agrupa los flujos de trabajo integrados y los complementos opcionales en un solo lugar; se describe la tarea y el agente elige el flujo de trabajo.
Las convenciones que mantiene en AGENTS.md y los archivos relacionados permanecen en el repositorio, por lo que las conversaciones posteriores comienzan con lo que el equipo ha acordado. Ver Instrucciones y memoria del proyecto. Para preparar la documentación para autores, desarrolladores y administradores, use Generar documentación del proyecto.
Quién puede usar el agente who-can-use-ema
Trabaja con el agente en un lenguaje sencillo: describa lo que desea y compruebe el resultado en la vista previa. El modo automático no necesita mensajes paso a paso. Para explorar la consola en un proyecto de ejemplo, use modo de demostración.
Trabajar en el sitio mismo lleva un poco más. Los cambios del agente son código en un repositorio Git: se comprueban en la vista previa, se insertan en una rama y se abre una solicitud de extracción que revisa un desarrollador. Algunos conocimientos de HTML y la voluntad de aprender estos conceptos básicos de Git y GitHub son suficientes para participar. El agente es una herramienta para personas expertas en tecnología en cualquier rol, tanto en marketing y diseño como en desarrollo.
Un diseñador o experto en marketing que conozca la marca puede refinar el diseño, la tipografía y el espaciado de un bloque directamente, en lugar de describir el cambio a un desarrollador y esperar a que lo haga. Pueden decidir qué bloques obtienen los autores y qué aspecto tienen cada uno, y comprobar el resultado en cada tamaño de pantalla; consulte Realizar cambios visuales. Los especialistas en contenido comprueban que la estructura de contenido es fácil de editar para los autores; consulte Dar forma a la estructura de contenido. Los desarrolladores crean integraciones y comportamientos complejos, depuran y revisan los cambios antes de la producción. Los posibles clientes técnicos amplían el ámbito de la migración, eligen el destino del contenido y deciden cuándo el sitio está listo para su lanzamiento.
El agente no limita las solicitudes por función. Sus permisos en Git y en el destino de contenido deciden lo que puede cambiar fuera del espacio de trabajo.
Contribución más amplia, mismo control de producción production-control
El agente de modernización de experiencias amplía quién puede contribuir a un sitio y no quién aprueba lo que se pone en marcha. Los desarrolladores controlan cada línea de código que llega a la producción.
Ese control se encuentra en el proveedor de Git, no en la consola, por lo que se mantiene aunque se realice un cambio. Proteja main con protección de ramas que requiera una solicitud de extracción aprobada por un desarrollador, y no permita que otros colaboradores la omitan. Los colaboradores insertan su trabajo con Crear nuevo PR, y un desarrollador comprueba el resultado en las URL de vista previa que la solicitud de extracción enumera antes de combinarlo. Si un colaborador activa Permitir que LLM use mis credenciales de Git, el agente inserta el acceso de ese colaborador, por lo que se le aplica la misma protección. La publicación de contenido se controla de forma independiente mediante la función de publicación del sitio. Para ver la configuración, consulte Control sobre los cambios.
Seguridad y gestión de datos security
El agente funciona sin recibir las credenciales que configure, cada usuario trabaja en un entorno independiente y usted decide cuándo los cambios llegan a su repositorio de Git y a su destino de contenido. Para obtener acceso y aislamiento, credenciales, qué procesa el modelo de IA, el control sobre cada paso y dónde se almacena el trabajo, consulte Seguridad y administración de datos.
Para la revisión de procesos, seguridad y arquitectura de su organización, use Evaluar y aprobar el agente de modernización de experiencias. Esa guía también presenta a el equipo detrás del agente. Las solicitudes de asistencia de la consola llegan a las personas que la crean y que le siguen.
Próximos pasos next-steps
Para obtener respuestas cortas a preguntas comunes, como acceso, modo automático, transferencias, sitios de origen protegidos y recuperación, consulte Preguntas frecuentes sobre Experience Modernization Agent. Si algo no funciona como esperas, consulta Solución de problemas o Solicita ayuda.
Para saber qué ha cambiado en las versiones recientes de la consola, consulte las notas de la versión de Experience Modernization Agent.