Recursos de agentes de desenvolvimento development-agentic-capabilities
O Recurso de agente de desenvolvimento do Adobe Experience Manager (AEM) as a Cloud Service colabora com o Chat do Colaborador para ajudar desenvolvedores e administradores tradicionais do AEM Java-stack a criar, depurar, implantar e otimizar o código com mais eficiência.
Casos de uso use-cases
Uma variedade de casos de uso é coberta.
Gerenciar pipelines do Cloud Manager aem-cloud-manager-pipeline-management
A habilidade Gerenciamento de pipeline do AEM Cloud Manager permite gerenciar os pipelines de CI/CD diretamente pela linguagem natural, sem alternar entre telas do Cloud Manager para encontrar as informações ou os controles necessários. Você pode listar e criar pipelines, iniciar ou cancelar execuções e verificar status e histórico — tudo a partir de uma única conversa.
Quando algo dá errado, a habilidade vai além das verificações de status: pode recuperar métricas de etapa, registros, artefatos e falhas de execução para que você possa diagnosticar um problema sem baixar e pesquisar pelos arquivos de log brutos. Ele também lida com a configuração diária do pipeline — gerenciando variáveis de pipeline, invalidando artefatos em cache e ajustando configurações de pipeline — para que as tarefas de manutenção de rotina que costumavam exigir vários cliques na interface do usuário possam ser feitas com uma única solicitação.
Para descobrir por que uma execução falhou, consulte Solução de problemas do pipeline de AEM Cloud Manager.
A IA pode cometer erros, portanto, revise as ações sugeridas antes de aplicá-las, especialmente para operações destrutivas.
“Quais pipelines tenho no Programa Principal?”
“Configurar um pipeline de Qualidade de Código para meu ambiente de desenvolvimento”
“Iniciar execução do pipeline 67890”
“Parar a etapa de Verificação de Código em execução para execução 12345”
“Mostrar as últimas 5 execuções do Pipeline de Desenvolvimento”
“Quanto tempo durou a etapa de Verificação de Código na minha última execução?”
“Obter os logs para a etapa de Verificação de Código que falhou”
“Onde posso baixar o artefato de compilação da minha última execução?”
“Listar todas as execuções com falha do programa 12345 esta semana”
“Atualizar a variável API_ENDPOINT no pipeline 67890”
“Limpar o cache de compilação antes da minha próxima execução”
“Alterar a ramificação do gatilho do pipeline 67890 para lançamento”
Solução de problemas do AEM Cloud Manager Pipeline aem-cloud-manager-pipeline-troubleshooting
A habilidade de solução de problemas do pipeline do AEM Cloud Manager ajuda você a descobrir por que uma execução de pipeline falhou, sem baixar e pesquisar por arquivos de log brutos. Referencie uma execução com falha pelo nome do pipeline ou pela ID de execução e a habilidade confirme a falha no Cloud Manager, identifique a etapa que falhou e explique em linguagem simples o que deu errado, por que e o que fazer em seguida. Se sua solicitação corresponder a mais de um pipeline, a habilidade solicitará que você escolha um antes de continuar.
Observe que esse recurso é implementado como um agente especialista e, portanto, não aparece visualmente como uma habilidade listada na interface de Personalizações do colaborador.
A habilidade investiga falhas nos seguintes pipelines e etapas:
- A etapa Teste de build e unidade e a etapa Verificação de código nos pipelines de Implantação de pilha completa e Qualidade de código.
- Falhas de compilação e qualidade de código em pipelines de configuração no nível da Web, como erros de validação de configuração do Dispatcher.
- Falhas de implantação em pipelines de configuração, como uma configuração de CDN inválida.
Para falhas em outras etapas, como a etapa de implantação de um pipeline de pilha completa, a habilidade relata a etapa com falha sem diagnosticá-la. Nesse caso, inspecione os logs conforme descrito em Logs de Acesso e Download ou entre em contato com o Suporte da Adobe.
Você também pode começar a solução de problemas sem escrever um prompt. Clique em Solucionar problemas com a IA em uma execução de pipeline com falha no Cloud Manager ou no widget Pipelines com falha na página inicial do Experience Manager, para abrir o Colaborador com essa execução já referenciada. Consulte Solução de problemas de um pipeline com falha do Cloud Manager e Solução de problemas do Widget de pipelines com falha.
A IA pode cometer erros, portanto, reveja o diagnóstico antes de agir com base nele.
“Ajude-me a solucionar problemas do último pipeline que falhou no Programa Principal”
“Solução de problemas de execução 1234567 do Pipeline de Desenvolvimento no programa 12345”
“Por que minha implantação de pipeline de configuração falhou no programa 12345?”
Permissões pipeline-troubleshooting-permissions
Para usar a habilidade de solução de problemas do pipeline do AEM Cloud Manager, você deve ter a função de Desenvolvedor ou de Gerente de programas no Cloud Manager. Consulte Permissões baseadas em função.
Solução de problemas de um pipeline com falha do Cloud Manager troubleshoot-from-cloud-manager
Começar a partir da execução do pipeline com falha é a maneira mais rápida de solucionar problemas, pois o Colaborador recebe a execução como contexto e você não precisa gravar um prompt.
-
Entre na Adobe Experience Cloud e abra o Experience Manager.
note tip TIP Para solucionar problemas sem abrir o Cloud Manager, digite um prompt, como Solucionar problemas do pipeline que falhou, na caixa Pergunte qualquer coisa ao Colaborador nesta página. -
No painel à esquerda, clique em Cloud Manager e selecione seu programa.
-
Na página Visão geral do programa, no cartão Pipelines, clique no pipeline que falhou.
-
Na página de execução do pipeline, observe o status Falha ao lado do nome do pipeline e a etapa que falhou.
-
Clique em Solucionar problemas com IA. O botão é exibido próximo ao canto superior direito da página e na caixa Erros de etapa da etapa que falhou.
O colega de trabalho abre em um painel no lado direito da página, com a execução com falha referenciada no prompt. O colaborador identifica a etapa com falha, explica a causa raiz e sugere uma correção que pode ser aplicada manualmente.
-
Revise o diagnóstico. Para fazer perguntas complementares ou solicitar mais detalhes, digite na caixa Perguntar qualquer item ao Colaborador.
Solução de problemas do widget Pipelines com falha troubleshoot-from-experience-home-widget
A página inicial do Experience Manager inclui um widget Pipelines com falha que lista as falhas de pipeline em seus programas para que você possa começar a solução de problemas sem precisar abrir o Cloud Manager. Cada linha mostra o nome do pipeline, a data e a hora da última execução, a duração e a etapa que falhou, juntamente com um botão Solucionar problemas com IA.
-
Entre na Adobe Experience Cloud, abra o Experience Manager e role até o widget Pipelines com falha.
-
Na linha do pipeline que você deseja investigar, clique em Solucionar problemas com a IA.
O colaborador abre com a execução com falha referenciada e inicia sua análise, identificando a causa raiz e sugerindo uma correção.
-
Revise o diagnóstico. Para fazer perguntas complementares ou solicitar mais detalhes, digite na caixa Perguntar qualquer item ao Colaborador.
Gerenciamento de ambiente do AEM Cloud Manager aem-cloud-manager-environment-management
A habilidade de gerenciamento de ambiente do AEM Cloud Manager permite gerenciar os ambientes do Cloud Manager por meio da linguagem natural, sem navegar pelas telas de interface do usuário da Cloud Manager para encontrar o programa, ambiente ou painel de configuração corretos. Você pode listar seus ambientes, obter detalhes de um ambiente específico e criar, clonar ou excluir ambientes conforme as necessidades do projeto mudam.
A manutenção diária do ambiente também é contemplada: gerenciamento de variáveis de ambiente, download de logs para depuração, redefinição de um Ambiente de desenvolvimento rápido (RDE) quando for necessário e configuração de implantações de região — tudo a partir de uma única conversa, em vez de várias viagens pelo Cloud Manager. Quando algo precisa ser revertido, a habilidade também pode restaurar um ambiente de um backup.
A IA pode cometer erros, portanto, revise as ações sugeridas antes de aplicá-las, especialmente para operações destrutivas.
“Mostrar todos os ambientes no Programa Principal”
“Qual é o status do meu ambiente de produção?”
“Configurar um ambiente de preparo para teste”
“Duplicar o ambiente de preparo para o programa 12345”
“Remover o ambiente de teste não utilizado”
“Definir a variável API_BASE_URL no meu ambiente de preparo”
“Baixar os logs do dispatcher para o meu ambiente de preparo”
“Redefinir o ambiente de desenvolvimento rápido para o programa 12345”
“Mostrar as implantações de região para meu ambiente de produção”
“Mostrar os backups disponíveis para o ambiente de preparo”
Gerenciamento do programa AEM Cloud Manager aem-cloud-manager-program-management
A habilidade Gerenciamento de programas da AEM Cloud Manager permite procurar e gerenciar os programas da Cloud Manager em uma linguagem natural, em vez de navegar pelas listagens de programas da Cloud Manager para encontrar aquele que você está procurando. Você pode listar todos os programas aos quais tem acesso, obter os detalhes de um programa específico e excluir um programa quando ele não é mais necessário.
Como os programas são o guarda-chuva sob o qual os pipelines e ambientes vivem, essa habilidade também atua como um ponto de entrada rápido nesses recursos relacionados — você pode pedir que ela mostre os pipelines ou ambientes vinculados a um determinado programa sem primeiro rastrear a ID do programa você mesmo.
A IA pode cometer erros, portanto, revise as ações sugeridas antes de aplicá-las, especialmente para operações destrutivas.
“A quais programas eu tenho acesso?”
“Mostrar informações sobre o Programa Principal”
“Remover o programa de demonstração antigo”
“Listar pipelines para o programa principal”
“Quais ambientes o Programa Principal tem?”
Gerenciamento de versão do AEM Cloud Manager aem-cloud-manager-release-management
A habilidade do Gerenciamento de versão da AEM Cloud Manager permite controlar quando a Adobe aplica atualizações de manutenção automatizadas ao seu programa, sem percorrer as configurações do Cloud Manager para encontrar a tela certa. Você pode verificar sua programação de atualização atual, definir uma janela Horas de silêncio diariamente — um horário recorrente todos os dias quando o Adobe pausa as atualizações — e agendar um Período gratuito de vários dias para eventos como um lançamento de produto ou um congelamento de feriado, quando não quiser que nenhuma alteração chegue a seus ambientes.
Se seus planos forem alterados, você poderá remover um Período Livre de Atualização da mesma maneira que o programou. A habilidade também pode mostrar os próprios períodos de Congelamento de código global da Adobe — as janelas que o Adobe já bloqueou para exclusões de manutenção planejadas — para que você saiba antecipadamente quais datas já estão fora dos limites antes de tentar programar as suas próprias.
A habilidade também ajuda a evitar erros de agendamento. À medida que o orienta por uma solicitação, ele sinaliza os limites aplicáveis, como o máximo de três Períodos Livres de Atualização em uma janela flutuante de 365 dias, o intervalo obrigatório de uma semana entre os períodos e as janelas de exclusão de manutenção planejadas do Adobe. Em vez de descobrir uma restrição depois que uma configuração falha, você atinge um agendamento válido na mesma conversa. Essa abordagem protege as janelas de negócios críticas contra atualizações automáticas de manutenção e reduz a indisponibilidade e erros de configuração. Consulte Período de silêncio e Atualizar períodos livres.
A IA pode cometer erros, portanto, revise as ações sugeridas antes de aplicá-las — isso é especialmente verdadeiro para alterações no cronograma de atualização, já que um Período livre de atualização incorretamente agendado ou removido pode permitir que as atualizações sejam acionadas durante uma janela que você deseja proteger.
“Mostrar a programação de atualização do programa 12345”
“Atualize minha janela do Período de Silêncio para iniciar uma hora antes”
“Bloqueie atualizações para o programa 12345 durante a semana de lançamento, de 3 a 10 de março”
“Cancelar a janela de blecaute agendada para a próxima semana”
“Mostrar os períodos de exclusão de manutenção planejada do Adobe”
Inspeção de fluxo de trabalho do AEM aem-workflow-inspection
A habilidade Inspeção de fluxo de trabalho do AEM permite verificar a atividade do fluxo de trabalho em linguagem simples. Pergunte ao Colaborador quais workflows estão em execução, o que está aguardando em sua caixa de entrada ou por que um workflow falhou, sem abrir a interface do usuário do Workflow.
Você pode pesquisar um fluxo de trabalho específico, procurar modelos de fluxo de trabalho disponíveis e fazer perguntas de acompanhamento ao solucionar problemas. Essa habilidade é somente leitura: ajuda você a ver e entender o que está acontecendo, mas não inicia, altera ou interrompe os workflows.
A IA pode cometer erros, portanto, analise os resultados antes de agir com eles.
“Algum fluxo de trabalho está suspenso?”
“Detalhe rapidamente os fluxos de trabalho por status.”
“Resuma os erros encontrados nos fluxos de trabalho inspecionados.”
“Explique o erro no segundo fluxo de trabalho dessa lista.”
“O status ou a etapa atual foi alterada desde a última vez que verificamos?”
“Quem o iniciou, quando e quais informações de item de trabalho estão disponíveis?”
“Mostrar apenas etapas do fluxo de trabalho, não Tarefas.”
“Há um modelo chamado Revisão Editorial disponível?”
AEM Dispatcher Insights aem-dispatcher-insights
A habilidade AEM Dispatcher Insights ajuda você a entender como a camada da Web do Dispatcher e Apache lidam com solicitações no AEM as a Cloud Service. Peça ao Colaborador para analisar o desempenho do cache, investigar problemas de tráfego e entrega e revisar a configuração de segurança sem pesquisar manualmente os arquivos de log. Quando suportado pelos dados disponíveis, o Co-worker pode apresentar as descobertas como gráficos e visualizações de tempo de solicitação.
Para análise específica do ambiente, identifique o ambiente e o período de tempo (em uma janela de log de sete dias) que deseja investigar. Atualmente, a habilidade não acessa o repositório de origem, portanto, para revisões de configuração e código, cole ou faça upload dos arquivos relevantes. O colega de trabalho também pode inspecionar URLs acessíveis para verificar o status da resposta, cabeçalhos e redirecionamentos.
Nesses tópicos, você pode pedir ao Colaborador para propor alterações, explicar seu impacto potencial e fornecer orientação de validação e reversão. Depois de aplicar e implantar uma alteração, peça ao Colaborador para reavaliar os logs disponíveis ou o comportamento do URL ativo.
Atualmente, a habilidade não modifica seu repositório, não implanta alterações, não publica ou cancela a publicação de conteúdo, nem apaga caches. As remoções de cache do CDN, a criação de regras de filtro de tráfego de borda e as alterações nas configurações de infraestrutura gerenciadas pela Adobe estão fora de seu escopo.
A IA pode cometer erros, portanto, analise os resultados e as alterações propostas antes de agir sobre eles.
Armazenamento em cache e desempenho dispatcher-caching-performance
Entenda a eficácia do cache, investigue respostas lentas ou obsoletas e identifique oportunidades para reduzir as solicitações de publicação.
“Desempenho do cache removido após a implantação mais recente. Compare a evidência de log com as implantações recentes e a diferença de configuração que eu compartilhei.”
“Revise por que essas respostas de consulta persistente do GraphQL não estão sendo armazenadas em cache.”
“Quais parâmetros posso ignorar com segurança sem quebrar a pesquisa ou a paginação?”
“Recomende uma política de armazenamento em cache para nossas bibliotecas de clientes com versão e ativos DAM usando a configuração que compartilhei.”
“Como a alteração de statfileslevel ou gracePeriod afetaria a invalidação e quando devemos atualizar o cache de uma página?”
“Para solicitações de página representativas, mostre o Dispatcher observado e os estágios de processamento de publicação e onde o tempo é gasto.”
“Verifique se esta página está incluída em nosso mapa de site e explique como a cobertura do mapa de site afeta o aquecimento.”
Tráfego e tratamento de solicitações dispatcher-traffic-request-handling
Entenda o tráfego que chega ao Dispatcher e investigue como as solicitações são filtradas, roteadas e atendidas.
“O tráfego automatizado está sendo absorvido pelo cache ou estão aumentando as solicitações de publicação?”
“Quais caminhos respondem pelas respostas 403 e 404 de hoje e quais evidências ajudam a explicá-los?”
“Explique como a ordenação de regras afeta as solicitações para o nosso ponto de extremidade do GraphQL.”
“As solicitações para o nosso novo domínio estão atendendo ao site errado. Verifique os aliases de host e os mapeamentos de farm que eu compartilhei.”
“Esta URL personalizada funciona na publicação, mas retorna 404 por meio do Dispatcher. O que devo verificar?”
“Explique quais cabeçalhos pertencem a clientheaders.any e quais são tratados na configuração do vhost ou do cache.”
“Como posso habilitar o Dispatcher ou regravar o log de depuração no preparo sem alterar o log de produção?”
Segurança dispatcher-security
Peça ao Colaborador uma revisão geral da segurança ou concentre-se em uma preocupação específica na configuração do Dispatcher controlada pelo cliente e no código AEM relacionado.
“A regra de permissão desse ponto de extremidade pode ser restringida ao preservar as solicitações necessárias?”
“Explique os benefícios de segurança e o impacto potencial do aplicativo da alteração de Política-Segurança-Conteúdo que você recomenda.”
“O que devemos verificar para impedir o acesso não autorizado ao armazenar em cache conteúdo autenticado?”
“Revise essas configurações OSGi CSRF e CORS junto com as regras Dispatcher que eu compartilhei.”
“Priorize as descobertas por gravidade e recomende melhorias em nosso controle no AEM as a Cloud Service.”