View a markdown version of this page

Habilidades aprendidas - AWS DevOps Agente

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Habilidades aprendidas

O que são habilidades aprendidas?

As habilidades aprendidas são arquivos de conhecimento estruturados que o DevOps Agente gera a partir dos dados do seu Espaço do Agente. Cada habilidade aprendida codifica um tipo específico de conhecimento que o AWS DevOps agente usa ao realizar tarefas. No lançamento, quatro habilidades aprendidas estão disponíveis: compreensão do espaço do agente, compreensão das dependências de código, compreensão da topologia do pipeline e melhores práticas de uso de ferramentas.

Compreensão do Agent Space

A habilidade Agent Space Understanding (understanding-agent-space) analisa suas contas de nuvem conectadas, repositórios de código e integrações de telemetria para criar um mapa dos recursos e relacionamentos em um Agent Space.

A habilidade produz um SKILL.md arquivo principal e um conjunto de arquivos de referência. O arquivo principal contém uma visão geral do sistema em linguagem simples com os principais conceitos de domínio, os ambientes de implantação (pares de AWS contas e regiões, assinaturas e regiões do Azure etc.), um diagrama de arquitetura em nível de contêiner que mostra como os serviços lógicos se conectam, os caminhos de solicitação que são centrais para seu aplicativo com os componentes que eles atravessam e um mapeamento de repositórios de código para contêineres.

Cada contêiner lógico recebe um arquivo de referência dedicado descrevendo seus componentes internos (computação, dados, mensagens, rede e outros) com tipos de recursos e identificadores físicos, como ARNs, nomes de tabelas e URLs de filas. O arquivo de referência também captura a cobertura de observabilidade, incluindo os alarmes, painéis e monitores vinculados a cada componente. Ele também mapeia cada componente para seus repositórios de código, pacotes e definições de infraestrutura como código associados, fornecendo uma cadeia de rastreabilidade completa, do código-fonte aos recursos implantados.

Cada caminho crítico de solicitação recebe um arquivo de referência dedicado que descreve o fluxo completo de solicitações de ponta a ponta na granularidade do componente, desde o ponto de entrada até cada serviço intermediário, armazenamento de dados e dependência externa. O arquivo inclui um diagrama de fluxo sequenciado mostrando a ordem das operações e os mecanismos de interação entre os componentes, junto com a responsabilidade de cada participante. Ele também cataloga os sinais de observabilidade relevantes para o caminho: padrões de grupos de registros para cada salto, métricas principais (latência, taxas de erro, limitação, cotas de tokens) com seus nomes e dimensões de alarme e extensões de rastreamento distribuídas que podem ser correlacionadas entre serviços e contas.

Entendendo as dependências de código

A habilidade Understanding Code Dependencies (understanding-code-dependencies) produz um mapa completo de dependências entre serviços e pacotes. Use essa habilidade para entender como os repositórios se conectam: quais serviços chamam quais, quais eventos fluem entre eles, quais pacotes são compartilhados e onde estão os limites da infraestrutura. Essa habilidade é essencial para avaliar o raio de explosão das mudanças, identificar upstream/downstream impactos e entender a ordem de implantação.

Entendendo a topologia do pipeline

A habilidade Understanding Pipeline Topology (understanding-pipeline-topology) mapeia os pipelines do projeto do início ao fim, incluindo etapas, promoções ambientais e implantações ao longo do caminho até o lançamento. Isso ajuda o agente a distinguir entre ambientes de produção e pré-produção e a entender o status de uma mudança no processo de lançamento.

Melhores práticas de uso de ferramentas

A habilidade Tool Use Best Practices analisa os usos anteriores de ferramentas de investigação para extrair padrões de uso efetivos, modos de falha comuns e orientação de parâmetros. Isso ajuda o DevOps agente a evitar armadilhas conhecidas e a realizar investigações com menos etapas desperdiçadas. A habilidade produz um arquivo principal e um conjunto de arquivos de referência por ferramenta. O arquivo principal serve como um índice de roteamento que lista cada ferramenta com os cenários de investigação que ela suporta e vincula ao arquivo de referência correspondente.

Cada arquivo de referência por ferramenta pode incluir até três seções:

  • Práticas recomendadas — Investigation-driven técnicas extraídas do uso bem-sucedido da ferramenta, como modelos de consulta do CloudWatch Logs Insights, namespaces e dimensões de métricas específicas do ambiente e filtros de origem de eventos. CloudTrail Cada entrada é organizada em torno de um cenário de investigação e inclui valores de parâmetros concretos e exemplos observados em investigações anteriores.

  • Erros comuns — Modos de falha recorrentes e suas correções. Cada entrada descreve uma condição de erro específica, como consultar uma conta inacessível ou criar uma consulta de agregação malformada, e fornece uma ação corretiva para que o agente possa evitar ou se recuperar do erro sem desperdiçar as etapas de investigação.

  • Gerenciamento de resultados — Orientação para chamadas de ferramentas que tendem a retornar respostas grandes. Cada entrada descreve uma mudança de parâmetro ou estratégia de processamento que reduz o tamanho da saída e preserva o valor do diagnóstico.

Quando o acesso ativo à infraestrutura está disponível, a habilidade valida os padrões em relação ao seu ambiente antes de incluí-los. Os padrões confirmados são declarados com confiança, os padrões não confirmados usam uma linguagem cautelosa e os padrões refutados são excluídos. Isso mantém a habilidade alinhada com o estado atual da sua infraestrutura.

Gerenciando habilidades aprendidas

O DevOps Agente gera e atualiza automaticamente as habilidades aprendidas com base na atividade em seu Espaço do Agente. A seguir, descrevemos quando cada habilidade é atualizada.

O DevOps agente gera uma habilidade atualizada de melhores práticas de uso de ferramentas a cada 30 investigações.

A habilidade de Compreensão do Espaço do Agente é gerada pelo agente de aprendizado, que é executada sempre que você adiciona, atualiza ou remove um recurso ou integração do Espaço do Agente. Também é atualizado periodicamente a cada 3 dias para Agent Spaces ativos. Um Espaço do Agente é considerado ativo se tiver tido pelo menos uma investigação nos últimos 30 dias. Se o seu Espaço do Agente não tiver investigações por 30 dias, a atualização de habilidades será pausada automaticamente. Ela é retomada quando uma nova investigação é iniciada.

Para regenerar as habilidades aprendidas manualmente, escolha o botão Regenerar na página Topologia no aplicativo do operador ou converse com o agente e peça que ele atualize as habilidades aprendidas.

Desativação — As habilidades aprendidas estão ativas por padrão. Quando ativos, o DevOps Agente os carrega no início de cada tarefa do DevOps Agente. Para impedir que uma habilidade aprendida seja aplicada, desative-a na guia Habilidades da página de conhecimento no aplicativo do operador. Desativar uma habilidade não a exclui. A habilidade é mantida e pode ser reativada a qualquer momento. Quando uma habilidade é desativada, o DevOps Agente opera sem o conhecimento dessa habilidade. Você também pode desativar o armazenamento de memória gerenciada correspondente na guia Memórias de forma independente.

Visualização de topologia — A página de topologia no aplicativo web do seu Agent Space usa a habilidade de compreensão do Agent Space para exibir visualmente seu ambiente do Agent Space como contêineres e componentes lógicos. Escolha qualquer contêiner para ver seus componentes, identificadores de recursos e telemetria.

Relatório resumido — O relatório resumido é uma visão versionada e somente para leitura do que o DevOps agente sabe sobre seu ambiente, derivada da habilidade Agent Space Understanding. Você pode encontrá-lo em dois lugares: na guia Relatório resumido na página de detalhes do Espaço do AWS DevOps agente no console de administração do agente e na seção Artefatos do aplicativo web do DevOps agente.

Dependendo do que você configurou para o seu Espaço do Agente, o relatório pode incluir os ambientes de implantação, a arquitetura do contêiner, os caminhos de solicitação críticos e o mapeamento do repositório de código. Cada relatório é versionado, para que você possa navegar pelas versões anteriores para ver como seu ambiente mudou ao longo do tempo. No aplicativo web, escolha Conversar sobre o relatório para discutir qualquer seção com o DevOps Agente ou compará-la com uma versão anterior.