Capacidades de agentes de desarrollo development-agentic-capabilities
La funcionalidad de agente de desarrollo de Adobe Experience Manager (AEM) as a Cloud Service colabora con Coworker Chat para ayudar a los desarrolladores y administradores tradicionales de AEM Java-stack a crear, depurar, implementar y optimizar código de forma más eficiente.
Casos de uso use-cases
Se tratan una serie de casos de uso.
Administrar canalizaciones de Cloud Manager aem-cloud-manager-pipeline-management
La habilidad Administración de canalizaciones de AEM Cloud Manager le permite administrar sus canalizaciones de CI/CD directamente a través del lenguaje natural, sin cambiar entre pantallas de Cloud Manager para encontrar la información o los controles que necesita. Puede enumerar y crear canalizaciones, iniciar o cancelar ejecuciones y comprobar el estado y el historial, todo desde una sola conversación.
Cuando algo sale mal, la habilidad va más allá de las comprobaciones de estado: puede recuperar métricas de paso, registros, artefactos y errores de ejecución para que pueda diagnosticar un problema sin descargar ni buscar personalmente en los archivos de registro sin procesar. También administra la configuración diaria de la canalización (administración de variables de canalización, invalidación de artefactos en caché y ajuste de la configuración de la canalización), de modo que las tareas de mantenimiento rutinarias que solían requerir varios clics a través de la interfaz de usuario se pueden realizar con una sola solicitud.
Para saber por qué ha fallado una ejecución, consulte Solución de problemas de canalización de AEM Cloud Manager.
La IA puede cometer errores, por lo que debe revisar las acciones sugeridas antes de aplicarlas, especialmente en el caso de operaciones destructivas.
“¿Qué canalizaciones tengo en el programa principal?”
“Configurar una canalización de calidad de código para mi entorno de desarrollo”
“Iniciar la ejecución para la 67890 de la canalización”
“Detener el paso de análisis de código en ejecución para 12345 de ejecución”
“Mostrarme las últimas 5 ejecuciones de la canalización de desarrollo”
“¿Cuánto tiempo duró el paso de análisis de código en mi última ejecución?”
“Extraer los registros para el paso de análisis de código fallido”
“¿Dónde puedo descargar el artefacto de compilación de mi última ejecución?”
“Enumerar todas las ejecuciones fallidas para el programa 12345 esta semana”
“Actualizar la variable API_ENDPOINT en el 67890 de la canalización”
“Borrar la caché de compilación antes de la siguiente ejecución”
“Cambiar la rama de déclencheur para que se libere la 67890 de canalización”
Solución de problemas de canalización AEM Cloud Manager aem-cloud-manager-pipeline-troubleshooting
La habilidad Resolución de problemas de canalización de AEM Cloud Manager le ayuda a descubrir por qué falló la ejecución de una canalización, sin descargar ni buscar a través de archivos de registro sin procesar. Hacer referencia a una ejecución fallida por nombre de canalización o ID de ejecución, y la aptitud confirma el fallo en Cloud Manager, identifica el paso fallido y explica en lenguaje sencillo qué ha fallado, por qué y qué hacer a continuación. Si la solicitud coincide con más de una canalización, la aptitud le pedirá que elija una antes de que continúe.
Tenga en cuenta que esta capacidad se implementa como agente especializado y, por lo tanto, no aparece visualmente como una aptitud enumerada en la interfaz de Personalizaciones de compañeros de trabajo.
La aptitud investiga errores en las siguientes canalizaciones y pasos:
- El paso Generar y prueba de unidad y el paso Escaneo de código en la implementación de pila completa y las canalizaciones de calidad de código.
- Errores de compilación y calidad del código en canalizaciones de configuración de nivel web, como errores de validación de configuración de Dispatcher.
- Errores de implementación en canalizaciones de configuración, como una configuración de CDN no válida.
En el caso de errores en otros pasos, como el paso de implementación de una canalización de pila completa, la aptitud informa del paso fallido sin diagnosticarlo. En ese caso, inspeccione los registros como se describe en Registros de acceso y descarga, o póngase en contacto con el Soporte técnico de Adobe.
También puede iniciar la resolución de problemas sin escribir un mensaje. Haga clic en Solucionar problemas con IA en una ejecución de canalización fallida en Cloud Manager o en el widget de Canalizaciones fallidas de la página de inicio de Experience Manager para abrir Colaborador que ya hace referencia a esa ejecución. Vea Solucionar problemas de una canalización con errores desde Cloud Manager y Solucionar problemas desde el widget de canalizaciones con errores.
La IA puede cometer errores, por lo que debe revisar el diagnóstico antes de actuar en consecuencia.
“Ayudarme a solucionar problemas de la última canalización con errores en el programa principal”
“Solucionar problemas de 1234567 de ejecución de canalización de desarrollo en 12345 de programa”
“¿Por qué falló mi implementación de canalización de configuración en la 12345 del programa?”
Permisos pipeline-troubleshooting-permissions
Para usar la habilidad Resolución de problemas de canalización de AEM Cloud Manager, debes tener la función Desarrollador o Administrador de programas en Cloud Manager. Consulte Permisos basados en roles.
Solución de problemas de una canalización fallida desde Cloud Manager troubleshoot-from-cloud-manager
Comenzar a partir de la ejecución de la canalización con errores es la forma más rápida de solucionar problemas, ya que Coworker recibe la ejecución como contexto y no tiene que escribir un mensaje.
-
Inicia sesión en Adobe Experience Cloud y luego abre Experience Manager.
note tip TIP Para solucionar problemas sin abrir Cloud Manager, escriba un mensaje como Solucionar problemas de mi canalización con errores en el cuadro Preguntar a un compañero de esta página. -
En el carril izquierdo, haga clic en Cloud Manager y, a continuación, seleccione el programa.
-
En la página Resumen del programa, en la tarjeta Canalizaciones, haga clic en la canalización que ha fallado.
-
En la página de ejecución de la canalización, observe el estado Failed junto al nombre de la canalización y el paso que falló.
-
Haga clic en Solucionar problemas con IA. El botón aparece cerca de la esquina superior derecha de la página y en el cuadro Errores de paso del paso con error.
El compañero se abre en un panel en el lado derecho de la página, con la ejecución fallida referenciada en la solicitud. El compañero identifica el paso fallido, explica la causa raíz y sugiere una corrección que puede aplicar manualmente.
-
Revise el diagnóstico. Para hacer preguntas de seguimiento o solicitar más detalles, escriba en el cuadro Preguntar a un compañero.
Solución de problemas desde el widget de canalizaciones con errores troubleshoot-from-experience-home-widget
La página de inicio de Experience Manager incluye un widget de canalizaciones con errores que enumera los errores de canalización en los programas, para que pueda iniciar la solución de problemas sin abrir primero Cloud Manager. Cada fila muestra el nombre de la canalización, la fecha y la hora de la última ejecución, la duración y el paso que falló, junto con un botón Solucionar problemas con IA.
-
Inicie sesión en Adobe Experience Cloud, abra Experience Manager y desplácese hasta el widget de canalizaciones con errores.
-
En la fila de la canalización que desee investigar, haga clic en Solucionar problemas con IA.
El compañero abre con la ejecución fallida a la que se hace referencia e inicia su análisis, identificando la causa raíz y sugiriendo una corrección.
-
Revise el diagnóstico. Para hacer preguntas de seguimiento o solicitar más detalles, escriba en el cuadro Preguntar a un compañero.
AEM Cloud Manager Environment Management aem-cloud-manager-environment-management
La habilidad Administración del entorno de AEM Cloud Manager le permite administrar los entornos de Cloud Manager a través del lenguaje natural, sin navegar por las pantallas de la interfaz de usuario de Cloud Manager para encontrar el programa, el entorno o el panel de configuración adecuado. Puede enumerar los entornos, extraer detalles de uno específico y crear, clonar o eliminar entornos a medida que cambien las necesidades del proyecto.
El mantenimiento diario del entorno también está cubierto: administración de variables de entorno, descarga de registros para depuración, restablecimiento de un entorno de desarrollo rápido (RDE) cuando necesite una pizarra limpia y configuración de implementaciones de región, todo desde una sola conversación en lugar de varios viajes a través de Cloud Manager. Cuando es necesario revertir algo, la aptitud también puede restaurar un entorno desde una copia de seguridad.
La IA puede cometer errores, por lo que debe revisar las acciones sugeridas antes de aplicarlas, especialmente en el caso de operaciones destructivas.
“Mostrar todos los entornos del programa principal”
“¿Cuál es el estado de mi entorno de producción?”
“Configurar un entorno de ensayo para realizar pruebas”
“Duplicar el entorno de ensayo para la 12345 del programa”
“Quitar el entorno de prueba no utilizado”
“Establecer la variable API_BASE_URL en mi entorno de ensayo”
“Descargar los registros de Dispatcher para mi entorno de ensayo”
“Restablecer el entorno de desarrollo rápido para la 12345 del programa”
“Mostrarme las implementaciones de región para mi entorno de producción”
“Mostrar las copias de seguridad disponibles para el entorno de ensayo”
Administración del programa AEM Cloud Manager aem-cloud-manager-program-management
La habilidad Administración de programas de AEM Cloud Manager le permite buscar y administrar sus programas de Cloud Manager a través del lenguaje natural, en lugar de navegar por los listados de programas de Cloud Manager para encontrar el que está buscando. Puede enumerar todos los programas a los que tiene acceso, extraer detalles de uno específico y eliminar un programa cuando ya no lo necesite.
Dado que los programas son el paraguas bajo el que viven las canalizaciones y los entornos, esta aptitud también actúa como punto de entrada rápido a esos recursos relacionados: puede pedirle que muestre las canalizaciones o los entornos vinculados a un programa determinado sin rastrear primero el ID del programa.
La IA puede cometer errores, por lo que debe revisar las acciones sugeridas antes de aplicarlas, especialmente en el caso de operaciones destructivas.
“¿A qué programas tengo acceso?”
“Mostrar información sobre el programa principal”
“Quitar el programa de demostración antiguo”
“Enumerar canalizaciones para el programa principal”
“¿Qué entornos tiene el programa principal?”
AEM Cloud Manager Release Management aem-cloud-manager-release-management
La habilidad Administración de versiones de AEM Cloud Manager le permite controlar cuándo Adobe aplica actualizaciones de mantenimiento automatizadas a su programa, sin necesidad de examinar la configuración de Cloud Manager para encontrar la pantalla correcta. Puede comprobar la programación de actualizaciones actual, establecer una ventana de Horas de inactividad diaria (una hora recurrente cada día en que Adobe pone en pausa las actualizaciones) y programar un período sin actualizaciones de varios días para eventos como el lanzamiento de un producto o la congelación de días festivos, en caso de que no desee que los cambios lleguen a sus entornos.
Si tus planes cambian, puedes eliminar un Periodo sin Actualización tan fácilmente como lo programaste. La aptitud también permite mostrar los periodos de congelación de código globales de Adobe (los periodos de bloqueo de Adobe de Windows ya están desactivados para las exclusiones de mantenimiento planificadas), por lo que sabe de antemano qué fechas ya están prohibidas antes de intentar programar las suyas.
La aptitud también le ayuda a evitar errores de programación. A medida que le guía a través de una solicitud, marca los límites que se aplican, como el máximo de tres periodos sin actualización dentro de un periodo flotante de 365 días, el intervalo obligatorio de una semana entre periodos y las ventanas de exclusión de mantenimiento planificadas de Adobe. En lugar de descubrir una restricción después de que falle una configuración, se llega a una programación válida en la misma conversación. Este enfoque protege los períodos de tiempo críticos para la empresa de las actualizaciones automáticas de mantenimiento y reduce las interferencias y los errores de configuración. Ver Horas de silencio y actualizar períodos libres.
AI puede cometer errores, por lo que debe revisar las acciones sugeridas antes de aplicarlas; esto es especialmente cierto para los cambios en la programación de actualizaciones, ya que un periodo sin actualización programado o eliminado incorrectamente podría permitir que las actualizaciones se pospongan durante una ventana que quería proteger.
“Mostrarme la programación de actualizaciones para la 12345 del programa”
“Actualizar la ventana de horas tranquilas para que comience una hora antes”
“Bloquear actualizaciones para el programa 12345 durante la semana de lanzamiento, del 3 al 10 de marzo”
“Cancelar la ventana de interrupción programada para la semana siguiente”
“Mostrarme los períodos de exclusión de mantenimiento planificados de Adobe”
Inspección del flujo de trabajo AEM aem-workflow-inspection
La aptitud Inspección del flujo de trabajo de AEM permite comprobar la actividad del flujo de trabajo en lenguaje sencillo. Pregunte a su compañero qué flujos de trabajo se están ejecutando, qué está esperando en la bandeja de entrada o por qué ha fallado un flujo de trabajo sin abrir la interfaz de usuario del flujo de trabajo.
Puede buscar un flujo de trabajo específico, examinar los modelos de flujo de trabajo disponibles y hacer preguntas de seguimiento a medida que soluciona problemas. Esta habilidad es de solo lectura: ayuda a ver y comprender lo que está ocurriendo, pero no inicia, cambia ni detiene flujos de trabajo.
La IA puede cometer errores, por lo que debe revisar los hallazgos antes de actuar en consecuencia.
“¿Se ha suspendido algún flujo de trabajo?”
“Proporcióneme un desglose rápido de los flujos de trabajo por estado.”
“Resuma los errores encontrados en los flujos de trabajo que inspeccionó.”
“Explique el error en el segundo flujo de trabajo de esa lista.”
“¿Ha cambiado su estado o paso actual desde la última vez que se comprobó?”
“¿Quién lo inició, cuándo y qué información de elemento de trabajo está disponible?”
“Mostrar solo pasos de flujo de trabajo, no tareas.”
“¿Hay disponible un modelo denominado Revisión editorial?”
AEM Dispatcher Insights aem-dispatcher-insights
La aptitud de AEM Dispatcher Insights le ayuda a comprender cómo gestiona sus niveles web Dispatcher y Apache las solicitudes en AEM as a Cloud Service. Pida a sus compañeros que analicen el rendimiento de la caché, investiguen los problemas de tráfico y envío y revisen la configuración de seguridad sin buscar manualmente los archivos de registro. Cuando sea compatible con los datos disponibles, los colaboradores pueden presentar los resultados como gráficos y visualizaciones de tiempo de solicitud.
Para un análisis específico del entorno, identifique el entorno y el período de tiempo (en una ventana de registro de siete días) que desee investigar. Actualmente, la aptitud no accede al repositorio de origen, por lo que para las revisiones de configuración y código, pegue o cargue los archivos relevantes. Los compañeros también pueden inspeccionar las direcciones URL accesibles para comprobar el estado de respuesta, los encabezados y las redirecciones.
En todos estos temas, puede pedir a sus compañeros que propongan cambios, expliquen su impacto potencial y proporcionen directrices de validación y reversión. Después de aplicar e implementar un cambio, pídale a su compañero que vuelva a evaluar los registros disponibles o el comportamiento de la URL activa.
Actualmente, la aptitud no modifica el repositorio, no implementa cambios, no publica ni cancela la publicación de contenido, ni borra cachés. Las purgas de caché de CDN, la creación de reglas de filtro de tráfico perimetral y los cambios en la configuración de infraestructura administrada por Adobe están fuera de su ámbito.
La IA puede cometer errores, por lo que debe revisar los hallazgos y los cambios propuestos antes de actuar en consecuencia.
Almacenamiento en caché y rendimiento dispatcher-caching-performance
Comprenda la eficacia de la caché, investigue las respuestas lentas o anticuadas e identifique oportunidades para reducir las solicitudes de publicación.
“El rendimiento de la caché se redujo después de nuestra última implementación. Compare la evidencia de registro con las implementaciones recientes y las diferencias de configuración que he compartido”.
“Revise por qué no se almacenan en caché estas respuestas de consultas persistentes de GraphQL.”
“¿Qué parámetros puedo ignorar de forma segura sin interrumpir la búsqueda o la paginación?”
“Recomiende una directiva de almacenamiento en caché para nuestras bibliotecas de cliente con versiones y recursos DAM con la configuración que he compartido.”
“¿Cómo afectaría el cambio de statfileslevel o gracePeriod a la invalidación y cuándo debemos actualizar la caché de una página?”
“Para las solicitudes de páginas representativas, muestre las fases de procesamiento de publicación y Dispatcher observadas y dónde se gasta el tiempo.”
“Compruebe si esta página se incluye en nuestro mapa del sitio y explique cómo afecta la cobertura del mapa del sitio al calentamiento.”
Administración de tráfico y solicitudes dispatcher-traffic-request-handling
Comprenda el tráfico que llega a Dispatcher e investigue cómo se filtran, enrutan y atienden las solicitudes.
“¿El tráfico automatizado está siendo absorbido por la caché o está aumentando las solicitudes de publicación?”
“¿Qué rutas representan las respuestas 403 y 404 de hoy y qué pruebas ayudan a explicarlas?”
“Explique cómo afecta la ordenación de reglas a las solicitudes de nuestro extremo de GraphQL”.
“Las solicitudes para nuestro nuevo dominio sirven al sitio incorrecto. Compruebe los alias de host y las asignaciones de granja que he compartido”.
“Esta dirección URL mnemónica funciona en la publicación, pero devuelve el valor 404 a través de Dispatcher. ¿Qué debería comprobar?”
“Explique qué encabezados pertenecen a clientheaders.any y cuáles se administran en la configuración de vhost o caché.”
“¿Cómo puedo habilitar Dispatcher o reescribir el registro de depuración en el ensayo sin cambiar el registro de producción?”
Seguridad dispatcher-security
Pida a sus compañeros una revisión de seguridad general o céntrese en un problema específico de la configuración de Dispatcher controlada por el cliente y del código de AEM relacionado.
“¿Se puede reducir la regla de permiso de este extremo conservando las solicitudes requeridas?”
“Explique los beneficios de seguridad y el impacto potencial en la aplicación del cambio de la directiva de seguridad de contenido que recomienda.”
“¿Qué debemos comprobar para evitar el acceso no autorizado al almacenar en caché el contenido autenticado?”
“Revise estas configuraciones de CSRF y CORS de OSGi junto con las reglas de Dispatcher que he compartido.”
“Priorice los resultados por gravedad y recomiende mejoras dentro de nuestro control en AEM as a Cloud Service.”