DocumentaciónAEMGuía del usuario

Guía de solicitud del agente de modernización de Experience prompting-guide

Última actualización: 12 de noviembre de 2026
  • Se aplica a:
  • Experience Manager as a Cloud Service

Creado para:

  • Usuario
  • Administrador
  • Desarrollador

Experience Modernization Agent funciona a partir de solicitudes en lenguaje natural. Para cada tipo de tarea, como migrar una página o aplicar estilo a un bloque, sigue un flujo de trabajo integrado, denominado aptitud. Elige la aptitud de su solicitud, por lo que no necesita ponerle nombre. Algunas habilidades pertenecen a funcionalidades opcionales, que el agente ofrece para activarlas en el proyecto cuando una solicitud las necesite.

En esta guía se proporcionan ejemplos de indicadores en el orden en el que se utilizan: planifique, migre, compruebe, escale y siga desarrollando. Siga Migrar un sitio de producción para el procedimiento de migración completo. Las secciones, el contenido predeterminado, los bloques y las variantes se explican en Forma la estructura de contenido. Reemplace las direcciones URL y rutas de ejemplo de las indicaciones por las suyas.

Dar contexto al agente context

El agente conoce Edge Delivery Services y lee el código del proyecto. No conoce su negocio, sus reglas de marca o los otros sistemas con los que trabaja su sitio hasta que se lo comenta y cada solicitud con el contexto adecuado guarda una ronda de correcciones. Comparta lo que necesita la tarea:

  • El objetivo y cómo comprobarlo: lo que desea, para quién y el aspecto del resultado final.
  • Ámbito y destino: las páginas o diseños de origen, las rutas de destino, dónde se almacena el contenido, el repositorio y la rama, qué no debe cambiar y si el agente puede cargar, insertar o publicar.
  • Requisitos: especificaciones y reglas de accesibilidad y marca.
  • Ejemplos: una página que ya tiene el aspecto correcto, una captura de pantalla, un vínculo de Figma o una respuesta de API de ejemplo.
  • Documentación: es un vínculo a la documentación pública que el agente lee en la web o a los documentos cuando necesitan iniciar sesión. Adjuntar archivos no acepta archivos PDF, así que copia el texto correspondiente de esos archivos. Ver Entrada de mensaje.
  • Las decisiones ya tomadas: mantienen las convenciones acordadas en AGENTS.md y los archivos que enumera, para que no las repita en cada solicitud. Ver Instrucciones y memoria del proyecto.

Comparta lo que necesita la tarea en lugar de todo lo que tiene y siga la política de su organización sobre lo que puede ir en las herramientas de IA.

Haga preguntas también: sobre los conceptos de Edge Delivery Services, el código del proyecto y los intercambios entre enfoques. Cuando no esté seguro de cómo hacer algo, pregunte cómo se hace en Edge Delivery Services antes de pedirle al agente que lo haga o cambie al modo Plan para revisar su enfoque. Pida al agente que enumere sus preguntas y suposiciones: responderlas es más rápido que corregir el resultado.

Mantenga los secretos fuera del chat secrets

CAUTION
Nunca escriba, pegue ni adjunte contraseñas, claves API, tokens de acceso u otros secretos en el chat. Escriba las credenciales que necesita el agente en Configuración de la consola. Si ya ha compartido un secreto, revoque o reemplácelo ahora.

El chat no es un lugar seguro para un secreto. Todo lo que escriba o adjunte se enviará al modelo de IA y se mantendrá en la conversación. El agente lo trata como cualquier otro texto: puede copiar un valor en un archivo de su proyecto, como un script o un archivo de configuración. Una vez insertado el archivo, el valor permanece en el historial del repositorio y todo el contenido del repositorio se envía a los exploradores de los visitantes del sitio. Las credenciales que se especifican en Configuración nunca llegan al agente. Ver credenciales.

Mantenga esto fuera del chat, de los archivos adjuntos y de los archivos de proyecto:

  • Contraseñas, incluidas las de cuentas de prueba y las de su propia cuenta de Adobe ID o Git
  • Claves de API, tokens de acceso y tokens de acceso personal
  • Claves privadas y certificados
  • Cadenas de conexión, cookies de sesión y vínculos que conceden acceso por su cuenta, como direcciones URL firmadas
  • El contenido de .env archivos y otra configuración que contiene secretos
  • Datos personales de clientes reales o empleados; use datos de muestra inventados en su lugar
  • Cualquier otra cosa que la política de su organización mantenga fuera de las herramientas de IA

Antes de adjuntar una captura de pantalla, un registro, un archivo exportado o un mensaje de error, búsquelos y enmascártelos.

Dónde van las credenciales credential-settings

Lo que necesita el agente
Dónde introducir la credencial
Acceso a su repositorio de Git
Flujo de conexión: Autorizar el conector de código AEM o Iniciar sesión con un token. Ver Conectar Su Sitio.
Permiso para insertar, extraer o leer contenido
Configuración > Permisos de agente. De forma predeterminada, estos utilizan su inicio de sesión de Adobe o Git, por lo que no escribe una credencial. Para que el agente tenga un acceso más limitado, introduzca allí su propio token: un token de acceso personal detallado para Git o un token de cuenta de servicio para Adobe. Ver Página de configuración.
Sus diseños de Figma
Configuración > Credenciales, para el token de acceso personal de Figma. Ver Trabajo a partir de un diseño de Figma.
Un sitio de origen que requiere inicio de sesión
Configuración > Autenticación de sitio protegido o los campos de autenticación del modo automático. Consulte Autenticación de sitio protegido.
Una API u otro servicio al que el agente llama mientras funciona, como una API de prueba o un servicio de notificación
Configuración > Autenticación de sitio protegido, con una entrada para el nombre de host del servicio. Ver credenciales de otros servicios.
Una clave de API que utilice su sitio activo
No la consola. Un servicio del lado del servidor mantiene la clave, como Adobe App Builder o API Mesh, que su equipo implementa y al que el sitio llama. Consulte Servicios y aplicaciones de Connect.

Cuando una tarea necesite una clave, no la pegue para realizar la tarea. Ingréselo donde dice la tabla y proporcione al agente un punto final de zona protegida o de prueba en lugar de uno de producción.

Si compartiste un secreto secret-shared

  1. Revocar o reemplazar el secreto en el servicio que lo emitió, de inmediato. Borrar el chat no recupera lo que ya se ha enviado, y las transcripciones de las sesiones del agente lo mantienen hasta que restablece el espacio de trabajo.
  2. Compruebe la vista Cambios en busca de archivos que contengan el secreto y descarte los cambios antes de insertar.
  3. Si ya se insertó un archivo con el secreto, la corrección consiste en reemplazar el secreto. Una confirmación posterior la elimina de los archivos, pero no del historial del repositorio.
  4. Informe a su equipo de seguridad, según lo requiera la política de su organización.

Se le ordena al agente que no use un secreto que pegue en el chat y que le diga que lo sustituya. No confíes en eso: para cuando responda, el secreto ya ha llegado al modelo de IA.

Acotamiento del resultado general-tips

Cuando algo no está bien, como el color de fondo incorrecto en un bloque, pídale al agente que arregle ese problema en lugar de empezar de nuevo. Asigne un nombre a la dirección URL de origen, la ruta de salida, lo que ve y lo que espera. Para obtener más sugerencias, vea Sugerencias de sugerencias.

  • En páginas migradas, pida la corrección en el bloque o en el script de importación de la plantilla, de modo que llegue a todas las páginas de la plantilla. Ver Cómo migra el agente a escala.
  • Antes de volver a importar páginas para aplicar una corrección, compruebe si los autores las han editado: una nueva importación reemplaza a las ediciones. Ver Importar en lotes.
  • Trate las páginas de origen y los diseños adjuntos como material desde el que trabajar, no como instrucciones que anulan la solicitud.
  • En una larga conversación, el agente puede perder el rastro de decisiones anteriores. Recuerde los puntos clave o haga que los registre en los archivos del proyecto e inicie una nueva conversación. Ver Iniciar una nueva conversación.

Indicadores de creación y migración de sitios site-migration

Una migración sigue este orden: catalogar el sitio, migrar una página de muestra de cada plantilla, migrar el diseño, comprobar el resultado con una crítica y después importar las otras páginas de la plantilla. El encabezado, navegación y pie de página están configurados una vez para todo el sitio. Para ver el procedimiento completo, consulte Migrar un sitio de producción.

Planificar con el catálogo del sitio site-catalog

Utilice estos indicadores para ver la escala, las plantillas y los bloques de un sitio antes de migrarlo. Para iniciar un catálogo, consulte Planificar una migración con el catálogo del sitio.

  • “Buscar plantillas en https://www.example.com”
  • “¿Cuántos tipos de página hay en https://www.example.com?”

Capturar una página de Source scraping-webpages

La migración de páginas comienza capturando la página de origen. Pídale que analice la página por su cuenta antes de migrarla.

  • “Capturar https://www.example.com/products para su análisis”.
  • “Extraiga el contenido y los metadatos de https://www.example.com/product en anchos móviles y de escritorio”.

Cosas que hay que saber:

  • El agente carga la página en un explorador y la desplaza para que se carguen las imágenes cargadas de forma diferida. Para ver lo que captura, incluido el contenido que los scripts insertan o ocultan en CSS, y lo que no puede, consulte Limitaciones.
  • Extrae el título de la página, la descripción, las etiquetas de Open Graph, los datos estructurados JSON-LD y la URL canónica.
  • Guarda una captura de pantalla y copias de las imágenes, y normaliza los vínculos y las referencias de imagen. Compruebe las imágenes con el origen, incluidas las imágenes adaptables, los fondos y las imágenes de SVG, y compruebe que cada vínculo sigue apuntando a donde debería.
  • Solicite un ancho de pantalla específico, como móvil o escritorio. Cada anchura adicional tarda más.

Migrar páginas migrate-a-site

Utilice estas indicaciones para importar páginas de un sitio web existente. Para importar una primera página paso a paso, consulte Importar una página paso a paso o, para el contenido almacenado en la creación de Experience Manager, Conectar el sitio e importar una página.

  • “Migrar estas páginas: https://www.example.com/products/hiking, https://www.example.com/products/climbing. Reutilice los bloques existentes. No cargue, inserte ni publique”.

Cosas que hay que saber:

  • El agente decide las secciones de cada página, el contenido predeterminado, los bloques y las variantes, y vuelve a utilizar los bloques del proyecto antes de crear nuevos bloques. Compruebe esta estructura en las primeras páginas: los autores la editan y la importación masiva la repite. Ver Dar forma a la estructura de contenido.
  • El contenido y el diseño son pasos independientes. Después de la importación de contenido, el agente sugiere Iniciar migración de diseño: selecciónela o pida el estilo de origen. Para ver un nuevo diseño, vea Rediseñar durante la migración.
  • La importación de página excluye el encabezado, la navegación y el pie de página. Ver Configurar el encabezado, la navegación y el pie de página.
  • Cada migración escribe un script de importación para la plantilla de la página, que importación masiva ejecuta en las demás páginas de la plantilla.
  • Para ver adónde van las imágenes, incluidas las imágenes proporcionadas desde Dynamic Media, consulte Imágenes y documentos.

Migración del diseño design-migration

Utilice estos indicadores para volver a crear el diseño del sitio de origen en el contenido importado.

  • “Migrar el diseño de https://www.example.com”
  • “Extraer los tokens de diseño”
  • “Estilo del bloque de héroe”
  • “Estilo de todos los bloques”

Cosas que hay que saber:

  • El agente diseña todo el sitio primero. Escribe los tokens de diseño, como fuentes, colores, espaciado y tamaños de encabezado, como propiedades personalizadas de CSS en styles/brand.css. styles/styles.css importa ese archivo y aplica estilos al contenido predeterminado: encabezados, párrafos, botones, vínculos y fondos de sección.
  • A continuación, aplica estilos a los bloques en paralelo, cada uno en blocks/{name}/{name}.css, a partir de los tokens. Por lo tanto, el estilo de bloque necesita primero los estilos de todo el sitio.
  • Si el proyecto ya tiene brand.css u otros archivos de símbolos, pídale al agente que los use en lugar de extraer un segundo conjunto del origen.
  • Diga si la solicitud es global o para un bloque, y si debe permanecer fiel al origen o seguir un nuevo diseño. Compruebe el resultado en páginas reales con anchos de escritorio y móviles.

Qué tan cerca está el diseño design-fidelity

El agente vuelve a crear el diseño de origen: extrae los tokens de diseño, aplica estilos a cada bloque y, a continuación, compara cada bloque con el origen y corrige las diferencias que encuentra. Ver Crítica del sitio. El resultado se acerca al original en la primera pasada y se corrige lo que queda preguntando.

No se puede garantizar una copia idéntica. Las fuentes, la compresión de imágenes y la renderización del explorador pueden diferir ligeramente del origen y “idéntico” significa cosas diferentes para proyectos diferentes: un equipo mide el espaciado hasta el píxel y otro comprueba que la marca lee lo mismo. El origen también tiene sus propios errores, como el espaciado que difiere entre dos páginas de la misma plantilla y volver a crearlos rara vez ayuda al nuevo sitio.

Apunte al diseño previsto:

  1. Describa cada diferencia restante con la página, el ancho de la pantalla y lo que debe cambiar, y compruebe el resultado en la vista previa. Un diseño complejo puede dar varias vueltas.
  2. Corrija una diferencia que se repite en los estilos globales o en el CSS del bloque, de modo que la corrección se aplique a todas las páginas.
  3. Antes de escalar, acuerde con las personas que cierran el sitio lo que cuenta como lo suficientemente cerca y compruébelo en las páginas de muestra.

Crear un bloque de Figma figma-block-migration

Utilice estas indicaciones para crear un bloque a partir de un componente Figma. El trabajo de un diseño Figma cubre el token de acceso, el asiento que necesita y por qué trabajar en un componente a la vez.

  • “Crear un bloque a partir de este componente Figma: {Figma link}. Reutilice nuestros tokens de diseño”.
  • “Migrar el componente pricing-card desde el archivo Figma {fileKey}.”

Cosas que hay que saber:

  • En Figma, seleccione el componente y copie su vínculo, de modo que el vínculo incluya el node-id que lo identifica: https://www.figma.com/design/{fileKey}?node-id={nodeId}. O bien, proporcione la clave del archivo y el nombre del componente.
  • El agente lee primero la estructura del componente, que mantiene los archivos Figma grandes manejables, y luego sus detalles de diseño. Agrega los colores, la tipografía y el espaciado como tokens de diseño a styles/styles.css, con tokens específicos del bloque, antes de escribir cualquier CSS. Asigna el componente al bloque más cercano del proyecto y crea una variante, escribe el CSS de la variante desde los tokens, guarda las imágenes y los iconos en el espacio de trabajo de la consola y crea contenido de muestra. A continuación, previsualiza el bloque y lo compara con el diseño Figma.

Rediseño con bloques de Figma figma-redesign-migration

Utilice estas indicaciones cuando un sitio obtenga un nuevo diseño durante la migración: Figma proporciona el diseño y los bloques, y el sitio en vivo proporciona el contenido. Para ver el procedimiento y qué comparar, vea Rediseñar durante la migración.

  1. “Crear la colección de bloques a partir de estos componentes de Figma: {Figma link}”
  2. “Migrar estas páginas y asignar su contenido a los bloques creados a partir de Figma: https://www.example.com/adventures, https://www.example.com/magazine”

Pida una nueva variante solo cuando los bloques de Figma no puedan representar el contenido de origen.

Crear una nueva página desde Figma figma-new-page-from-figma

Utilice este mensaje cuando una página no exista en un sitio de origen y un marco o página Figma deba convertirse en una nueva página.

  • “Migrar esta página de Figma a una nueva página en /events: {Figma link}”

Cosas que hay que saber:

  • Seleccione un marco o una página, no un archivo completo, y organícelo en secciones de páginas no definidas.
  • El agente asigna cada sección a un bloque existente, a contenido predeterminado o a una nueva variante. El texto y las imágenes provienen de Figma.
  • Un marco Figma muestra el aspecto de una función, no la procedencia de sus datos ni su comportamiento. Para la búsqueda, las calculadoras, la personalización o los localizadores de tiendas, la migración Figma crea el diseño. Luego pídale al agente que genere el comportamiento como un bloque dinámico y asígnele la API o la fuente de datos.

Configurar el encabezado, la navegación y el pie de página navigation-setup

Utilice estas indicaciones para el encabezado, navegación y pie de página, incluidas las imágenes de pie de página. La importación de páginas los excluye, ya que cada página comparte un encabezado y un pie de página.

  • “Configurar la navegación desde https://www.example.com”
  • “Migrar el pie de página de https://www.example.com”
  • “Corregir el menú de navegación”

Aspectos que hay que tener en cuenta para los proyectos que utilizan el encabezado y el pie de página de AEM ​:

  • El encabezado carga la página nav desde la raíz de contenido y el pie de página carga la página footer, a menos que los metadatos nav o footer de una página asignen un nombre a otra página. En los proyectos basados en documentos, el agente escribe la navegación como nav.md en el área de trabajo de la consola.
  • La página de navegación tiene tres secciones, separadas por ---: la marca, con el logotipo y el vínculo a la página de inicio; el menú principal; y herramientas, como vínculos para iniciar sesión o suscribirse.
  • Un elemento de menú que contiene una lista anidada se convierte en una lista desplegable.
  • Un vínculo en negrita o en cursiva solo en su párrafo se convierte en un botón, como en otras páginas, excepto en el vínculo de marca: el encabezado elimina el estilo de botón. Ver Ejemplo: Un Teaser Flexible Sin Bloques Atómicos.
  • Si el proyecto cambió header.js o footer.js, pídale al agente que los compruebe primero.
  • Para la creación de Experience Manager, confirme dónde se almacena la página de navegación y qué modelo utiliza.

Crítica del sitio site-critique

Utilice estas indicaciones después de la migración de diseño para comparar cada plantilla migrada con el origen y corregir las diferencias en una pasada.

  • “Sitio de crítica”
  • “Validar todos los bloques del sitio migrado”

Cosas que hay que saber:

  • Las diferencias estructurales, como la falta de un encabezado o vínculo, o un número incorrecto de filas, se corrigen en la secuencia de comandos de importación y las páginas se importan de nuevo. Las diferencias de estilo, como los colores, el espaciado y la tipografía, se corrigen en CSS.
  • El agente funciona capa por capa: estilos globales, secciones, contenido de bloque y CSS de bloque. Vuelve a comprobar el resultado después de cada capa.
  • Cuando el mismo problema aparece en varias páginas que utilizan el mismo bloque, el agente corrige el bloque una vez para todas ellas.
  • Sin brand.css, el agente solo corrige la estructura.
  • La crítica compara el aspecto de las páginas. Compruebe por separado que los autores pueden editarlos, que las interacciones funcionan y que son accesibles; consulte Limitaciones. Revise la cobertura y los problemas no resueltos de los que informa la crítica.

Crítica de una página page-critique

Utilice estas indicaciones para comprobar una página migrada, por ejemplo, después de una crítica del sitio.

  • “Crítica de la página Acerca de”
  • “Validar la página migrada /about con https://www.example.com/about”

El agente necesita la dirección URL de origen y la ruta migrada, y funciona con las mismas capas que la crítica del sitio. Compruebe las diferencias restantes en la vista previa.

Crítica de un bloque block-critique

Utilice estas indicaciones para comprobar un bloque después de la migración del diseño.

  • “Crítica al bloque héroe”
  • “Validar el bloque de tarjetas personalizadas”

El bloque debe proceder de una migración de páginas. El agente lo corrige como en la crítica del sitio.

Importar páginas por lotes bulk-import

Utilice estos indicadores para importar las demás páginas de una plantilla una vez que se haya migrado y marcado su página de muestra.

  • “Ejecute la importación masiva en estas páginas: https://www.example.com/blog/first-post, https://www.example.com/blog/second-post”.
  • “Importación masiva de todas las páginas de productos”.

Cosas que hay que saber:

  • La importación masiva ejecuta el script de importación que el agente escribió al migrar la página de muestra de la plantilla, de modo que primero migre esa página. Ver Cómo migra el agente a escala.
  • Cada ejecución cubre las páginas de una plantilla, ya que la secuencia de comandos de importación se escribe para la estructura de dicha plantilla.
  • Importe primero algunas páginas, compruébelas y corrija la secuencia de comandos de importación antes de importar la lista completa. Ver Importación en lotes y Flujo de trabajo de importación en lotes.

Bloquear indicadores de desarrollo block-development-capabilities

Estas indicaciones crean y cambian bloques durante una migración o en cualquier proyecto. Para ver los procedimientos y comprobaciones, consulte Crear, actualizar y refactorizar bloques.

Diseño de un modelo de contenido content-modeling

Utilice estas indicaciones para diseñar la tabla que los autores rellenan para un bloque. El desarrollo impulsado por contenido ejecuta este paso cuando crea un bloque; pídale que lo haga por su cuenta para comparar opciones.

  • “Diseño de un modelo de contenido para un bloque de testimonios”
  • “¿Cuál es el mejor modelo de contenido para este carrusel?”

Cosas que hay que saber:

  • Cuatro patrones cubren la mayoría de los bloques:

    • Independiente: un elemento distinto, como una imagen a pantalla completa o una comilla, en una sola tabla.
    • Colección: elementos repetitivos, como tarjetas o diapositivas de carrusel, con una fila por elemento.
    • Configuración: un bloque cuyo contenido proviene de una API o fuente de datos, como una lista de blogs o resultados de búsqueda, con filas de clave-valor que controlan lo que muestra. Ver Generar un bloque dinámico.
    • Bloqueo automático: contenido que los autores escriben como secciones o contenido predeterminado y que el código se convierte en un bloque, como fichas o incrustaciones de YouTube.

  • Mantenga cada tabla en unas pocas celdas y agrupe los elementos relacionados de forma natural para que los autores puedan rellenarla. Esto es para autores: el código de bloque puede leer cualquier estructura de tabla.

  • Para diferencias de estilo, prefiera las variantes de bloque sobre las celdas de configuración.

  • Acepte entradas flexibles, siguiendo la ley de Postel: un bloque a pantalla completa debería funcionar tanto si su contenido está en una celda, en dos celdas o en filas separadas.

  • Para la creación de Experience Manager, el bloque también necesita un modelo para el editor universal. Ver Crear un bloque.

Buscar bloques de referencia reference-blocks

Utilice estas indicaciones para buscar implementaciones existentes desde las que comenzar.

  • “Buscar bloques similares a una tabla de precios”
  • “¿Qué bloques están disponibles para los testimonios?”
  • “Buscar grupo de bloques para una implementación de pestañas”

Cosas que hay que saber:

  • Comience con Colección de bloques. Adobe lo mantiene y comprueba cada bloque para ver si hay modelado de contenido, rendimiento y accesibilidad. Cubre los bloques que más se necesitan.
  • Si no tiene lo que necesitas, busca en Block Party. La comunidad lo mantiene, con una gama más amplia que incluye enfoques experimentales, complementos para AEM Sidekick, herramientas de compilación e integraciones. Devuelve solo las entradas aprobadas. AEM Sidekick es la extensión del explorador que previsualiza y publica páginas.
  • Buscar con otros nombres también: acordeón para preguntas frecuentes, carrusel o presentación de diapositivas para galería, menú o encabezado para la navegación.

Desarrollar un bloque block-development

Utilice estas indicaciones para crear un bloque o cambiar uno existente.

  • “Crear un bloque de testimonios”
  • “Añadir una variante de fondo de vídeo al bloque a pantalla completa”

Cosas que hay que saber:

  • El agente crea contenido de prueba junto con el modelo de contenido; consulte Solicitar un bloque. El contenido de prueba permite comprobar el bloque, proporciona a la solicitud de extracción una página para probarla con PageSpeed Insights y muestra a los autores cómo utilizar el bloque.
  • Para un cambio solo en CSS, el agente omite el modelo de contenido, pero sigue utilizando el contenido de prueba para comprobar el resultado.
  • Antes de crear un bloque, busca uno que reutilizar. Ver Reutilizar bloques existentes.

Buscar en la documentación searching-documentation

Utilice estas indicaciones para encontrar instrucciones sobre las funciones y la implementación de Edge Delivery Services.

  • “¿Cómo se cargan de forma diferida las imágenes en Edge Delivery Services?”
  • “Buscar metadatos de sección en los documentos”

El agente busca en la documentación y en las publicaciones de blog de aem.live. Utilice palabras clave específicas, como “decoración de bloques”, “complemento de barra de tareas” o “metadatos”, en lugar de palabras clave generales, como “sitio web” o “cómo crear”. Para que el código comience desde, pida bloques de referencia en su lugar. Compruebe lo que encuentra con el código del proyecto y dónde se almacena su contenido.

Probar cambios testing

Utilice estos indicadores para probar un cambio antes de abrir una solicitud de extracción.

  • “Probar el nuevo bloque de tarjetas”
  • “Ejecute las pruebas antes de abrir una solicitud de extracción”

El agente escribe una prueba cuando su valor supera el coste de mantenerla. Mantiene pruebas unitarias para código con gran carga lógica, como utilidades, procesamiento de datos e integraciones de API, porque son rápidas y detectan regresiones en el código reutilizado. Las comprobaciones del explorador cubren cómo un bloque cambia la página, sus interacciones y su aspecto. Para saber qué comprobar antes de una solicitud de extracción, consulte Validar y entregar.

Depuración de un problema debugging

Utilice estas indicaciones cuando un bloque, una imagen, un estilo o la vista previa no funcionen según lo esperado. Para realizar comprobaciones más detalladas, el agente puede activar la solución de problemas de Edge Delivery Services capacidad opcional.

  • “Depurar por qué las imágenes se muestran como :error”
  • “Corregir el bloque hero, que no se procesa”
  • “¿Por qué no se muestran mis cambios en la vista previa?”

Cosas que hay que saber:

  • El agente comprueba los archivos de origen, la página representada, el código de bloque y la consola del explorador en ese orden. Utiliza la vista previa de la consola, por lo que no es necesario ejecutar un servidor local.

  • Causas frecuentes:

    • Las imágenes muestran about:error: el JavaScript del bloque no llama a createOptimizedPicture o lo llama antes de reorganizar el marcado del bloque.
    • Un bloque no se representa: el nombre del bloque en el contenido no coincide con su carpeta en blocks/, o la carpeta carece del archivo .js o .css.
    • CSS no se carga: una ruta de archivo es incorrecta. Consulte la pestaña Red (Network) de las herramientas para desarrolladores del navegador.
    • No aparece un cambio: vea Falta un cambio y La vista previa de la consola difiere del sitio.

  • Mantenga la dirección URL con errores y los detalles del error, y vuelva a intentar el ámbito afectado más pequeño después de corregir la causa. Antes de sobrescribir o restablecer el trabajo, consulte Liberar, recuperar y entregar.

Trabajar más allá de Edge Delivery Services beyond-eds

Las habilidades e instrucciones del agente se centran en Edge Delivery Services: migración de páginas, creación y estilo de bloques, y seguimiento de las convenciones del proyecto. El agente en sí es un agente de codificación de uso general, por lo que no se limita a ellos. Puede conectar el sitio a una plataforma de comercio, a una plataforma de automatización de marketing, a un servicio de búsqueda o mapas o a sus propias API, adaptar una aplicación que su equipo creó con React o escribir el código de un servicio del lado del servidor que implementa su equipo. Lo que funciona bien para las integraciones con otros agentes de codificación también funciona aquí: documentación primero, un plan antes del código, pequeños pasos probados y decisiones anotadas.

Para saber con qué se integra un sitio de origen, pídale al agente que enumere los servicios de terceros que carga una página de muestra, como análisis, administración de etiquetas, consentimiento, mapas, vídeo, chat, búsqueda y formularios. A continuación, decida con su equipo cómo funciona cada uno en el nuevo sitio.

Para otros sistemas, el agente no tiene habilidades, solo conocimientos generales, que pueden estar desfasados. La propia documentación del sistema hace que el trabajo sea fiable, por lo que trabajamos juntos:

  1. Haga que lea primero la documentación. Asigne al agente el vínculo a la documentación para desarrolladores del sistema o adjúntelo. Antes de escribir cualquier código, pídale que explique cómo funcionaría la integración, qué debe ejecutarse en un servidor y qué secretos están implicados. Corrija su comprensión en esta fase.
  2. Pregunta por Edge Delivery Services. Pregunte si la integración pertenece a un bloque, a un widget o a los scripts del proyecto, y cómo mantiene las páginas rápidamente. El agente propone un enfoque y pregunta lo que necesita saber.
  3. Proporciónele lo que el sistema necesita: extremos, nombres de campo, solicitudes y respuestas de ejemplo y una zona protegida o cuenta de prueba. Para obtener la clave que necesita el agente mientras funciona, consulte Dónde se colocan las credenciales.
  4. Compilar en pequeños pasos. Pruebe cada paso de la vista previa con un punto final que no sea de producción.
  5. Registrar el resultado. Pida al agente que escriba el método elegido y el vínculo de documentación en los archivos de instrucciones del proyecto, de modo que la siguiente conversación comience desde él.

Por ejemplo:

Lea la documentación para desarrolladores de nuestro servicio de localización de tiendas en https://developer.example.com/store-locator, especialmente su API de búsqueda. Explique cómo nuestro sitio podría mostrar las tiendas más cercanas en /stores siguiendo la práctica de Edge Delivery Services: qué se ejecuta en el explorador, qué necesita un servidor y qué secretos están involucrados. Enumere sus preguntas. No cambie ningún archivo aún.

Reemplace el servicio, la URL y la ruta de ejemplo por el suyo propio.

La configuración del otro sistema, la implementación de un servicio del lado del servidor y el almacenamiento de sus secretos permanecen en su equipo y en los administradores de ese sistema. Para ver los patrones de integración, vea Servicios y aplicaciones de Connect.

Ejemplo: Actualizaciones en Slack (avanzadas) slack-updates

Una credencial en Configuración, una aptitud de proyecto y una línea en AGENTS.md pueden conectar al agente con las herramientas que ya usa su equipo. Un desarrollador del equipo que crea el agente lo configuró para publicar un resumen en Slack cada vez que terminaba un turno, con lo que había cambiado, y para leer sus respuestas allí como instrucciones adicionales. Podía seguir y dirigir una larga tarea sin mantener la consola abierta.

  1. Cree una aplicación de Slack cuyo token de bot solo tenga ámbitos para publicar y leer mensajes. Añada el bot a un canal privado o utilice un mensaje directo con usted.
  2. En Configuración > Autenticación de sitio protegido, agregue una entrada para el nombre de host slack.com con autenticación de portador y el token de bot. Ver credenciales de otros servicios.
  3. Pida al agente que escriba una aptitud de proyecto que le explique cómo publicar y leer mensajes con la API web de Slack y que la inserte.
  4. En AGENTS.md, informe al agente de que se ha configurado una credencial para slack.com, qué canal utilizar y cuándo publicar, por ejemplo, al final de cada turno.

El agente trata lo que lee en el canal como instrucciones, lo mismo que el chat. Mantenga el canal privado, solo con usted y el bot en él, de modo que solo usted pueda instruir al agente. Los resúmenes que publica dejan la consola para Slack, por lo que debe seguir la política de su organización sobre lo que puede ir allí. Quita la entrada en Configuración cuando ya no la uses. El mismo patrón funciona para otras herramientas con una API HTTP que acepta un encabezado fijo.

recommendation-more-help
experience-manager-cloud-service-help-main-toc