Introducción a Experience Modernization Agent getting-started

Experience Modernization Agent crea y cambia sitios de Edge Delivery Services con usted. Describe lo que desea en la consola de modernización de Experience Cloud y el agente importa páginas, les aplica estilos y escribe el código. Esta guía le lleva desde el acceso a una primera página que puede editar, previsualizar y publicar.

En Edge Delivery Services, el código de un sitio (bloques, estilos y scripts) se almacena en un repositorio Git y su contenido se almacena en una fuente de contenido independiente que editan los autores. La plataforma combina ambas en páginas rápidas. Para obtener más información, consulte la descripción general de la plataforma.

En esta guía, el contenido se almacena en el repositorio de contenido basado en documentos, donde los autores lo editan en Experience Workspace, la interfaz de usuario de creación visual para Edge Delivery Services. Si el contenido debe permanecer en el JCR de una instancia de autor de Adobe Experience Manager, siga la guía de creación de Experience Manager para ver los pasos que difieren. Para elegir entre ambos, consulte Dónde se almacena el contenido y cómo lo editan los autores.

El modo automático tiene su propia suscripción. Para obtener acceso a la consola y los términos que se aplican cuando continúa con su propio sitio, consulte Uso de crédito de acceso e IA.

Comience con sus propias páginas first-outcome

Empiece con el modo automático a continuación para migrar algunas páginas, revise el resultado y reemplácelo por Hazlo tuyo. Si ya tiene un proyecto o desea guiar la importación desde el principio, comience desde un repositorio en su lugar: cree uno a partir de la plantilla o conecte el sitio existente.

Ambas rutas llevan a su sitio conectado en la consola. A partir de ahí, pregunta al agente y guarda, previsualiza y publica el resultado. La consola está alojada, por lo que ninguna de las rutas necesita un entorno de desarrollo local.

Antes de realizar la importación, elija algunas páginas de un sitio que esté autorizado a migrar, incluida una de cada diseño común, y decida si desea mantener el diseño de origen o aplicar uno nuevo.

Iniciar con el modo automático brand-trial

El modo automático migra un sitio web o una lista de sus páginas, sin preguntar paso a paso. En el flujo de trabajo guiado, el agente se detiene después de cada paso para que lo revise. En el modo automático, importa el contenido, migra el diseño, critica el resultado contra la fuente y sigue refinándolo hasta que su crítica encuentra las páginas cerca del origen.

Como comprueba y perfecciona su propio trabajo, el modo automático tarda mucho más que una importación guiada de las mismas páginas, por lo que se adapta a un primer resultado que se recopila más adelante. Una vez que se inicia una ejecución, no se solicita la entrada: la dirige únicamente a través del ámbito y las opciones que elija antes de comenzar. El modo automático comienza desde la dirección URL de un sitio web, no desde un repositorio; si el sitio ya está en Edge Delivery Services, conéctelo. Produce contenido basado en documentos; para el contenido almacenado en JCR, utilice la guía para la creación de Experience Manager.

Límites del modo automático auto-mode-limits

El modo automático limita cada cuenta según el número de páginas por migración, el número de migraciones y el número de migraciones que se pueden ejecutar al mismo tiempo. La página Modo automático muestra los límites aplicables antes de comenzar:

Para detener una ejecución, use Cancelar migración. No se puede reanudar una ejecución cancelada; en su lugar, inicie una nueva migración.

Hazlo tuyo make-it-yours

Una ejecución en modo automático crea su sitio en una ubicación administrada por Adobe. Para seguir trabajando en él en tu propio sitio, selecciona Configúrelo como tuyo en la ejecución finalizada. Esto transfiere el código y el contenido de la ejecución a un sitio de su propiedad. No vuelve a migrar nada.

Prepare primero el destino:

Para transferir la ejecución:

La transferencia copia lo siguiente:

La transferencia no copia hojas de cálculo, como redirecciones, metadatos masivos o marcadores de posición; permisos de acceso; configuración de sitio y organización; o los archivos de flujo de trabajo del historial de Git y GitHub de la ejecución.

Si la transferencia se detiene con un error, no se combina nada en main, pero el código y el contenido se transfieren por separado, así que compruebe la rama y las páginas. Si la nueva rama ya existe, elija otro nombre de rama.

Un sitio transferido aún no está activo. Acuerde quién es el propietario de cada paso restante:

En la consola, continúe con indicaciones para comenzar con, luego guarde, visualice una vista previa y publique sus cambios.

Comenzar desde un repositorio repo-start

Para trabajar en la consola, un repositorio de GitHub necesita dos aplicaciones de GitHub con nombres similares y trabajos diferentes:

Creación de un nuevo sitio a partir de la plantilla prepare-repo

Utilice esta ruta para un sitio nuevo, incluido uno que rellene con páginas importadas de un sitio web existente.

Traer el sitio existente existing-site

Si el sitio ya se ejecuta en Edge Delivery Services, no es necesario volver a crearlo o migrarlo de nuevo. Conéctelo y el agente trabajará con su código y contenido tal cual.

Los proyectos creados a partir de la plantilla actual incluyen AGENTS.md, donde se conservan las instrucciones del proyecto para el agente, y un CLAUDE.md de una línea que hace que el agente cargue AGENTS.md en cada conversación. Es posible que los proyectos más antiguos no los tengan; pida al agente que los añada desde la plantilla actual. Ver Instrucciones del proyecto.

Para cambiar el estilo del sitio o de los bloques de compilación, vea Restaurar un sitio existente y Desarrollo de bloques. No se requiere una migración.

Usar otro host Git other-git

Edge Delivery Services también es compatible con GitHub Enterprise (autoalojado), repositorios alojados en Adobe, GitLab, Bitbucket y Azure DevOps. Incorpore el repositorio en Adobe Cloud Manager, la herramienta Experience Manager as a Cloud Service para administrar programas, entornos y repositorios de código. A continuación, configure el sitio para que lo utilice. Ver Traer tu propio Git.

Abra la consola de modernización de Experience open-console

La consola conserva una copia de trabajo alojada del proyecto, denominada espacio de trabajo de la consola en estos documentos; no está relacionada con Experience Workspace, la interfaz de usuario de creación. El agente importa contenido y cambia el código hasta que lo carga o lo inserta. La consola configura el espacio de trabajo la primera vez que inicia sesión, lo que puede tardar hasta 10 minutos. Cada organización de Adobe con la que inicia sesión tiene su propio espacio de trabajo, con sus propios proyectos y chats; para cambiar, cerrar sesión e iniciar sesión con el perfil de la otra organización. Tras un periodo de inactividad, el espacio de trabajo se detiene. Cuando regreses, la consola mostrará Tu espacio de trabajo está en pausa; selecciona Despertar y espera unos minutos mientras se restaura.

Modo de demostración demo-mode

Si la consola se abre en modo de demostración, aparecerá el botón Sitio de demostración en el encabezado. Puede explorar el proyecto de ejemplo e intentar importar páginas, pero el trabajo en el sitio de demostración no se ha guardado y el sitio de demostración no puede insertar código en GitHub ni cargar contenido en Experience Workspace.

Conectar el sitio connect-repo

Conecte el sitio que creó a partir de la plantilla, que transfirió con Hazlo tuyo o que ya tenía.

El sitio y su repositorio de GitHub ahora están conectados a la consola.

Confirme el repositorio, la rama y el destino de contenido conectados antes de solicitar los cambios. La conexión necesita acceso de escritura al repositorio. Si su organización o repositorio no aparece en la lista, o si la consola no puede verificar la URL de vista previa, consulte Problemas de conexión de Git.

Inicio de consola console-home

Hasta que inicie una conversación, la consola se abrirá en su página Inicio. Escriba una solicitud o seleccione una de las solicitudes sugeridas, que se agrupan por tarea. Una solicitud que escriba se ejecutará a la vez. La mayoría de las peticiones de datos sugeridas se ejecutan en modo de planificación: el agente propone sus pasos sin cambiar ningún archivo y usted selecciona Ejecutar plan para llevarlos a cabo.

Iniciar petición de datos start-prompting

Una vez que el sitio esté conectado, describa lo que desee en lenguaje sencillo. Diga qué resultado espera y en qué página, en lugar de cómo escribir el código. El agente conoce Edge Delivery Services, por lo que también puede preguntarle cómo funciona una parte del sitio o qué significa un término de plataforma. Para saber cómo se crea una página a partir de secciones, bloques y contenido predeterminado, consulte Marcado, secciones, bloques y bloqueo automático.

En un sitio nuevo, comience por importar una página paso a paso. En un sitio que ya tiene páginas, como el sitio actual o uno transferido con Hazlo tuyo, pídele al agente que le explique el proyecto y haz un cambio visual con el modo de inspección o importa más páginas. Vea Indicadores para comenzar con.

Importar una página paso a paso guided-import

La forma más común de comenzar es importar páginas de un sitio web existente. En el flujo de trabajo guiado, el agente se detiene después de cada paso para que pueda comprobarlo: primero el contenido de la página y, a continuación, su diseño. Guarde cada resultado en cuanto lo haya comprobado: cargue el contenido después del paso de contenido e inserte el código después del paso de diseño.

La importación de página no genera la navegación y el pie de página compartidos; pídale que los incluya por separado. A continuación, previsualice y publique la página. Para ver más páginas, repita estos pasos y pídale al agente que vuelva a utilizar los bloques que ha creado. Una vez que las primeras páginas tengan el aspecto correcto, pídale que documente sus bloques y estilos para conversaciones posteriores; vea Permitir que el agente mantenga los archivos.

Realizar un cambio visual con el modo de inspección inspect-mode

En un sitio que ya tiene páginas, como el sitio existente o un sitio que transfirió con Hazlo tuyo, un cambio visual es la forma más rápida de ver un resultado. Elija lo que desee cambiar en lugar de describir dónde se encuentra: active Inspeccionar modo en el panel de vista previa, seleccione el elemento y describa el cambio, por ejemplo, “Hacer que este botón utilice el estilo del botón principal”. Realizar el primer cambio proporciona los pasos, incluido cómo comprobar el ancho de cada pantalla y deshacer un cambio. Luego inserta el código para conservarlo.

Indicadores para comenzar con first-prompts

Reemplace las direcciones URL y rutas de ejemplo por las suyas.

Un sitio nuevo de la plantilla:

Después de hacerlo tuyo:

Su sitio actual:

Sugerencias de solicitud prompting-tips

El agente sólo sabe lo que hay en la conversación actual y en los archivos del proyecto. Asigne el contexto que no puede conocer, como requisitos, reglas de marca, capturas de pantalla y vínculos a la documentación de otros sistemas; consulte Proporcionar contexto al agente. Para que siga las convenciones del proyecto en cada conversación, pídale que las escriba en AGENTS.md y en los archivos que AGENTS.md enumera; consulte Instrucciones y memoria del proyecto. Para ver las peticiones de datos de cada tarea, consulte la Guía de peticiones de datos.

Guardar, previsualizar y publicar save-work

El trabajo del agente permanece en el espacio de trabajo de la consola hasta que lo guarde en otra parte. Cada uno de los siguientes pasos mueve el trabajo a un lugar diferente:

Cargar e insertar por separado. Edge Delivery Services almacena el contenido aparte del código, por lo que insertarlo no guarda sus páginas y cargarlo no guarda su código. El primer resultado se completa cuando puede volver a abrir la página en Experience Workspace, editarla y ver el cambio solicitado en el sitio de vista previa, no solo cuando existe un vínculo de vista previa.

Cargar contenido upload-content

Cargue las páginas al repositorio de contenido basado en documentos, donde los autores las editan en Experience Workspace. Algunas etiquetas de consola y pantallas siguen indicando Creación de documentos. Antes de cargar, confirme el destino y que puede reemplazar las páginas existentes allí. La carga usa sus propios permisos de contenido; consulte Permisos de inserción de contenido. Para la creación de Experience Manager, siga Cargar contenido en la guía de esa configuración en su lugar.

Para encontrar el contenido cargado, seleccione Ver en AEM en la notificación cuando finalice la carga, lo que abre el contenido del sitio en Experience Workspace, o vaya a https://da.live/#/{organization}/{repository}.

Abra una página cargada, realice una edición, guárdela y vuelva a abrirla para comprobar que los autores pueden editarla y que el cambio persiste. Cuando Experience Workspace está activado para el sitio, Editar en Experience Workspace en la consola abre la página seleccionada en su editor visual.

Cambios en el código push push-code-changes

Revise la diferencia de código y ejecute las comprobaciones del proyecto antes de insertarlo. Usar una solicitud de extracción para el trabajo que requiere revisión; para lo que exige revisión, vea Control sobre cambios.

Si se creó una solicitud de extracción, seleccione Ver PR en la notificación de finalización. De lo contrario, como para un repositorio de conectado a través de Cloud Manager, compruebe la confirmación en la rama de destino. Si la rama está protegida contra inserciones directas, inserte con Crear nueva PR.

Su código se encuentra ahora en GitHub. Se muestra en la vista previa de esa rama y en las direcciones URL activas inmediatamente.

Confirmar identidad commit-identity

La consola se confirma con la identidad de Git, user.name y user.email, configurada en el área de trabajo de la consola, y usa un valor predeterminado para cualquiera de los dos que faltan. Ni conectar su cuenta de Git ni la configuración de Git en su propio equipo establecen esta identidad.

Si alguien más ha cambiado la rama push-conflicts

Una rama es una secuencia de cambios guardados, llamados confirmaciones. El espacio de trabajo de la consola mantiene la rama tal y como estaba cuando se extrajo por última vez, por lo que si alguien más la ha insertado desde entonces, el repositorio tiene confirmaciones de que el espacio de trabajo no las tiene. Insertar en la rama actual luego agrega su confirmación después de la de ellos y vuelve a insertar. Si ha cambiado diferentes archivos o líneas, esto tiene éxito sin nada más de usted.

Si los dos han cambiado las mismas líneas, Git no puede decidir qué versión conservar. Esto es un conflicto. La consola muestra Error de inserción: remoto tiene cambios conflictivos que no se pueden combinar automáticamente, mantiene sus cambios y cambia el cuadro de diálogo a Crear nueva PR.

La consola no combina ramas ni resuelve conflictos por sí misma. Sincronizar > Extraer > Código funciona de la misma manera: si las confirmaciones entran en conflicto con los cambios remotos, cancela la extracción, deja el trabajo tal como estaba y sugiere que se inserte en una nueva rama o que se pida ayuda al agente. Para evitar conflictos, tire de antes de iniciar una tarea, inserte pequeños cambios con frecuencia y póngase de acuerdo con el equipo para que cambie los archivos. Ver Trabajar como un equipo.

Previsualizar sitio preview-site

El panel de vista previa de la consola muestra únicamente la copia de trabajo en el espacio de trabajo de la consola. Para comprobar las páginas cargadas en el sitio de vista previa con su código:

Compruebe que la vista previa incluye el contenido guardado y la versión de código deseada.

Si el código se encuentra en una rama distinta a la de la URL de vista previa, cambie la URL de vista previa a esa rama. Para la creación de Experience Manager, siga Validar creación y vista previa en su lugar.

Publicación publish

Cuando la vista previa sea correcta, publique la página para que esté activa en *.aem.live:

La publicación hace que la página sea pública. El rol de publicación del sitio establece quién puede publicar; siga el proceso de revisión de su equipo. El código no necesita este paso: se activa en cuanto llega a main. Ver Control sobre los cambios.

Creación de una demostración de cliente customer-demo

Una demostración muestra algunas páginas completas con marcas de un sitio que está autorizado a utilizar, a lo largo de un recorrido que guiará a la audiencia. No necesita una migración total de la producción y no debe presentarse como listo para la producción.

Acceso y uso de crédito de IA access

Solicite acceso a Experience Modernization Console a través del administrador de cuentas de Adobe e inicie sesión con un Adobe ID que pertenezca a la organización de Adobe de su empresa. El modo automático no necesita ninguna solicitud a través de su administrador de cuentas; regístrese en su página, como en Iniciar con el modo automático.

Planifique la migración como parte de su paso a Edge Delivery Services. El equipo de su cuenta de Adobe puede revisar el ámbito y los acuerdos comerciales de su proyecto, incluidas las migraciones de sitios grandes y dirigidas por socios. El acuerdo de su organización determina la asignación de crédito de IA y los términos de migración aplicables; el inicio de sesión por sí solo no establece sus derechos.

Con el modelo de crédito actual, las páginas de migración pueden consumir créditos de IA:

Para obtener una introducción a los créditos de IA en las capacidades agénticas de Adobe, consulte Consumo de crédito de IA. Los ejemplos o las tasas de otras capacidades no establecen los términos de la migración. Pida al equipo de su cuenta de Adobe que revise el uso de su organización y confirme qué informes de uso están disponibles para usted.

Resolución de problemas troubleshooting

Para problemas con importaciones, acceso al origen, cargas, vistas previas, conexiones Git o el espacio de trabajo de la consola, consulte Solucionar problemas del agente de modernización de experiencias. Si con esto no se soluciona el problema, solicite asistencia al equipo que ha creado el agente.

Recursos adicionales additional-resources