Consola de modernización de Experience console-reference

La consola de modernización de Experience, en aemcoder.adobe.io, es la interfaz web de Experience Modernization Agent: un entorno de desarrollo alojado para Edge Delivery Services, donde puede describir los cambios en el chat y comprobar, guardar y publicar los resultados. No necesita configuración local. La consola funciona en una copia alojada del proyecto, que estos documentos denominan espacio de trabajo de la consola. No está relacionado con Experience Workspace, la interfaz de usuario para la creación de contenido basado en documentos. Consulte Dónde se almacena el contenido y cómo lo editan los autores. Experience Workspace reemplaza a la creación de documentos y algunas etiquetas de consola siguen usando ese nombre.

En esta página se describen las vistas, los controles y la configuración de la consola. Para obtener acceso, consulte Uso de crédito de acceso e IA. Para obtener los procedimientos completos, elija una forma de iniciar, migración de producción, rediseño o desarrollo de bloques. Si eres nuevo en la consola, pídele al agente en el chat que te lleve a un tour.

Barra de menús menu-bar

La barra de menús de la parte superior de cada página proporciona lo siguiente:

La consola también muestra avisos en la parte superior de la página, como el estado del servicio y Novedades de la última versión. Chat, Hogar y Configuración se adaptan a las pantallas de teléfono y tableta. En un teléfono, la página de chat solo muestra el chat. En una tableta, se muestra un panel a la vez; cambie entre el gráfico y el espacio de trabajo en el encabezado. En pantallas más anchas, ambos paneles se muestran uno al lado del otro.

Página principal home-page

La página Home es donde comienzas a trabajar.

Indicar entrada prompt-input

La entrada del mensaje proporciona controles para interactuar con la IA.

Página de chat chat-page

La página Chat es la interfaz principal para interactuar con el agente. Esta página está dividida en un panel de chat y panel de área de trabajo que pueden cambiar de tamaño.

Panel de chat chat-panel

El panel de chat le permite ver y continuar su conversación con el agente. El panel de chat incluye el historial de mensajes de chat y una entrada de solicitud para realizar solicitudes adicionales de la consola.

El encabezado del panel de chat incluye vínculos para navegar a las vistas Inicio y Configuración y las acciones de chat.

La conversación se guarda con el espacio de trabajo de la consola. Cuando vuelve a cargar la página o regresa más tarde, el historial de chat se vuelve a cargar. Solicita que se recupere con las teclas de dirección sólo mientras dure la ficha del explorador.

Funciones opcionales optional-capabilities

La referencia de capacidad enumera los flujos de trabajo integrados y los complementos opcionales. Cada complemento está desactivado de forma predeterminada y se activa por proyecto, lo que mantiene al agente más ligero y rápido en los proyectos que no lo necesitan.

Activar los complementos para todo el proyecto persist-add-ons

El agente guarda los complementos que activa en el archivo .agents/settings.json en la raíz del repositorio. El archivo enumera cada complemento por su ID:

{
  "enabledPlugins": {
    "excat-figma@excat-extended": true,
    "forms-excat@excat-extended": true
  }
}

Inserte este archivo con su código. Todos los espacios de trabajo que extraen el repositorio, incluidos los espacios de trabajo de los integrantes del equipo y las nuevas conversaciones, comienzan con los mismos complementos, sin volver a solicitarlos. También puede pedir al agente que cambie el archivo o editarlo en su repositorio Git y extraer el cambio en la consola. Para desactivar un complemento, establezca su valor en false o quite su línea. El cambio surtirá efecto a partir del siguiente mensaje.

Panel Workspace workspace-panel

El panel del espacio de trabajo muestra el contenido y el código de trabajo del proyecto conectado, no necesariamente de todas las páginas remotas del sitio. Su selector de vistas determina las acciones disponibles.

Saber Qué Resultado Está Viendo preview-states

Funcionamiento de la vista previa how-preview-works

La vista previa de la consola no es un entorno de Experience Manager. Ejecuta la CLI de AEM (aem up) en su área de trabajo: el mismo servidor de desarrollo local que los desarrolladores ejecutan en sus propios equipos. Proporciona el código del espacio de trabajo con las páginas de contenido del espacio de trabajo. Cualquier otra cosa que solicite una página, como un fragmento o una hoja de cálculo que no esté en el área de trabajo, proviene del sitio de vista previa de la rama actual del área de trabajo, https://{branch}--{site}--{organization}.aem.page.

El resultado puede diferir del sitio de vista previa después de la carga, ya que Edge Delivery Services procesa el contenido que la vista previa de la consola muestra tal cual. Cuando obtiene una vista previa de una página, ingiere el contenido y mantiene solamente la estructura de secciones, bloques y contenido predeterminado. Se eliminan elementos adicionales como etiquetas span, atributos de datos y estilos en línea. Consulte Traer su propio marcado. La vista previa de la consola reproduce algunos de estos pasos, como ajustar una imagen o un vínculo independiente en un párrafo y agregar ID de encabezado, para que se aproxime, pero no elimine nada.

Observe estas diferencias:

Para comprobar la página enviada, cárguela, obtenga una vista previa de la misma y ábrala en la dirección URL aem.page de la rama. Ver diferencia en la vista previa de la consola con respecto al sitio.

Vistas de contenido content-view

Las vistas de contenido muestran la página seleccionada en diferentes formularios, para que pueda comprobar cada aspecto del resultado. Un explorador de archivos contraíble enumera las páginas del sitio:

Las siguientes acciones están disponibles en las vistas de contenido:

Después de una carga en Experience Workspace, el cuadro de diálogo de resultados muestra qué archivos se cargaron y le permite previsualizar, o previsualizar y publicar, las páginas cargadas en la vista previa y en los sitios activos. Esto se ejecuta como un trabajo rastreado: continúa si sale del cuadro de diálogo y Ver detalles en la notificación vuelve a abrir sus resultados. Vuelva a intentar las páginas con errores desde los resultados. Si ninguna vista previa de página se realiza correctamente, no se publica nada.

Los cambios de contenido realizados por el agente permanecerán en el espacio de trabajo de la consola hasta que los cargue o hasta que pida al agente que los escriba en Experience Workspace con sus permisos de agente.

Menú Sincronizar sync-menu

La sincronización conecta tu espacio de trabajo de la consola independiente con el repositorio Git de tu proyecto y el destino de contenido. La inserción de código y de contenido son operaciones independientes y se elige qué archivos o páginas modificados se van a enviar. Los cambios que deje en el área de trabajo de la consola no afectan al proyecto.

El botón Sincronizar del encabezado del espacio de trabajo muestra un distintivo con el número de cambios pendientes. Ábralo para mover contenido y código entre el espacio de trabajo de la consola y sus ubicaciones remotas: Experience Workspace o la instancia de autor para el contenido y el repositorio Git para el código.

La sincronización está deshabilitada en el sitio de demostración. Las funciones push y pull le avisan cuando su sesión de Experience Workspace ha caducado.

Vistas de código code-view

Las vistas de código proporcionan herramientas para examinar los archivos de proyecto y administrar los cambios de código. La vista incluye un explorador de archivos para obtener una descripción general de los archivos de código o los cambios realizados como diferencias, así como un área de vista previa para ver el archivo o los cambios seleccionados.

Acciones de archivo file-actions

Cambios en acciones changes-actions

Para insertar código, usa Sync > Push > Code en el menú Sync. El cuadro de diálogo Cambios de fase le permite elegir los archivos, y el cuadro de diálogo Cambios de inserción le pide un mensaje de confirmación y si debe crear una nueva solicitud de extracción o insertarla en la rama actual; consulte Cambios de código de inserción para saber qué hace cada opción. Para extraer el código más reciente, usa Sync > Pull > Code. Las acciones de código no están disponibles en el sitio de demostración, cuando GitHub no está conectado o hasta que se instale el conector de código de AEM; la consola le indicará qué se aplica. Para ver cuándo el código insertado alcanza la vista previa y los sitios activos, consulte Cómo se activan los cambios.

La inserción de código no carga contenido y el descarte de código local no deshace el contenido que ya se ha cargado.

Para conectar, volver a conectar o cambiar el repositorio de GitHub, use la página de configuración.

Vistas de proyecto project-view

Las vistas de proyecto le ayudan a planificar la migración de un sitio existente.

Para obtener más información, consulte La vista de Planning.

Página Configuración settings-page

La página Configuración le permite administrar la configuración básica de la consola y se divide en las siguientes secciones. Introduzca las credenciales aquí, nunca en el chat. Ver Mantener los secretos fuera del chat.

Si realiza un cambio en cualquier valor de cualquier sección, seleccione Guardar para guardar los cambios en la sección individual. Para los permisos de agente, la autenticación de sitio y las credenciales, el botón muestra Aplicando… hasta que el cambio surta efecto. Seleccione el icono Atrás para volver a la vista anterior.

Autenticación de sitio protegido protected-site-authentication

Muchos sitios muestran algunas páginas solo a visitantes que han iniciado sesión, mantienen una copia de ensayo detrás de una contraseña o tienen una CDN que solo permite el acceso a solicitudes con un encabezado secreto. Use Autenticación de sitio protegido para permitir que el agente lea un sitio de origen de este tipo cuando acepte un encabezado de solicitud personalizado, autenticación HTTP Basic o autenticación de portador. A continuación, puede migrar esas páginas del mismo modo que las páginas públicas.

Se debe poder acceder al sitio de origen desde el entorno alojado del agente en Internet y configurarlo para aceptar el método de autenticación que proporcione. Esta función no se conecta a través de una VPN y no completa los flujos de inicio de sesión interactivos, como los formularios de inicio de sesión único (SSO) o la autenticación de varios factores. Un firewall permite que el agente pase cuando su administrador lista de permitidos las direcciones del agente. Si el origen solo está accesible en una red privada, pida a su administrador un host de origen o de ensayo accesible en Internet que acepte uno de los métodos admitidos.

Para configurar el acceso:

Una vez guardadas, las credenciales se añaden a las solicitudes salientes solo al nombre de host coincidente y no se comparten con el modelo de IA.

Utilice credenciales con ámbito y menos privilegios, preferiblemente una cuenta dedicada con acceso de solo lectura al contenido de origen. Cada nombre de host solo se puede configurar una vez. Configure nombres de host adicionales por separado si el sitio web de origen carga contenido protegido de otros hosts, como un dominio de recursos.

Compruebe una página protegida antes de iniciar un catálogo o una ejecución por lotes: su captura debe mostrar el contenido de la página, no una página de inicio de sesión.

Para quitar el acceso, selecciona Quitar sitio para la entrada y, a continuación, Guardar. Elimine la entrada cuando se complete la migración.

Credenciales para otros servicios other-services

La misma configuración funciona para cualquier servicio al que el agente llama mientras funciona, no solo para los sitios de origen. Agregue una entrada para el nombre de host del servicio, como api.example.com, con el encabezado o token que espera el servicio. Puede agregar tantas entradas como necesite, una para cada nombre de host. La consola agrega la credencial a cada solicitud que el agente realiza a ese nombre de host, incluidas las solicitudes de los scripts y comandos que ejecuta. El modelo de IA no recibe la credencial, pero el agente ve las respuestas del servicio.

Estas credenciales sirven al trabajo del agente en la consola. El sitio publicado no puede utilizarlos: una clave que el sitio activo necesita pertenece a un servicio del lado del servidor. Consulte Servicios y aplicaciones de Connect. Para ver un ejemplo que conecta el agente con una herramienta de chat, vea Ejemplo: Actualizaciones en Slack.

Solicitar asistencia request-support

Cuando algo no funcione como espera, o si tiene una pregunta que estas páginas no responden, informe al equipo que crea el agente. Su solicitud va directamente a ese equipo, que la analiza y la sigue por correo electrónico. Para conocer a expertos en la materia o al equipo de productos, consulta El equipo detrás del agente.

La solicitud comparte sus datos de contacto y los detalles de la sesión que el equipo necesita para encontrar la conversación y los registros de su sesión. Consulte Solicitudes de asistencia para obtener la lista completa. Puede enviar una solicitud por minuto.

Cuando la conversación sugiere que estás atascado o frustrado, el entrenador rápido puede ofrecer ayuda en ¿Necesitas una mano? Seleccione Póngase en contacto con el servicio de asistencia para abrir la misma solicitud o No gracias para continuar.

En las páginas de modo automático, el botón es Obtener ayuda. Utilícelo para solicitar más páginas o más migraciones simultáneas, o para preguntar algo sobre el modo automático. Describa lo que necesita en ¿Cómo podemos ayudarle? y seleccione Enviar. El equipo responde por correo electrónico.

Novedades y notas de la versión whats-new

Cuando se lanza una nueva versión de la consola, un aviso de Novedades en la parte superior de la página muestra los elementos destacados. Amplíela para ver la lista o descártela. Vuelve a aparecer en la siguiente versión.

Para obtener más información sobre cada versión, consulte las notas de la versión de Experience Modernization Agent.