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á. # DevOps Habilidades do agente AWS DevOps As habilidades do agente são conjuntos de instruções modulares que ampliam as capacidades do agente com conhecimento especializado do domínio e metodologias de investigação adaptadas à sua infraestrutura e fluxos de trabalho operacionais. ## O que são habilidades As habilidades são diretórios independentes contendo instruções do Markdown que fornecem recursos especializados ao Agente. AWS DevOps AWS DevOps O Agent suporta um subconjunto da [especificação Agent Skills](https://agentskills.io/) — um padrão aberto para empacotar instruções e recursos do agente — suportando somente documentos não executáveis: instruções Markdown, PDFs, imagens e arquivos de dados. Cada habilidade requer um SKILL.md arquivo contendo as instruções que você deseja fornecer ao seu AWS DevOps agente. Além do SKILL.md arquivo necessário, as habilidades podem incluir: + **Fluxos de trabalho de investigação** para cenários ou tipos de infraestrutura específicos. + **Materiais de referência**, incluindo padrões de arquitetura e procedimentos operacionais. + **Segmentação por tipo de agente** — As habilidades podem ser direcionadas a tipos específicos de agentes (genéricos, triagem de incidentes On-demand, RCA de incidentes, mitigação de incidentes, avaliação) para reduzir o consumo de contexto e melhorar o foco do agente. ## Por que usar Skills As habilidades transformam o AWS DevOps agente de um assistente de uso geral em um especialista para sua infraestrutura e fluxos de trabalho operacionais. Diferentemente das instruções únicas fornecidas em uma mensagem de bate-papo, as habilidades são recursos reutilizáveis que são carregados automaticamente quando relevantes às tarefas executadas pelo Agente. AWS DevOps **Principais benefícios:** + **Especialize seu agente** — Personalize o AWS DevOps agente com procedimentos de investigação, melhores práticas e conhecimento organizacional específicos para sua infraestrutura e padrões operacionais. + **Reduza a repetição** — Crie fluxos de trabalho de investigação uma vez e o AWS DevOps agente os usará automaticamente em todas as investigações relevantes, eliminando a necessidade de fornecer a mesma orientação repetidamente. + **Recursos do Compose** — Combine várias habilidades para criar fluxos de trabalho de investigação de ponta a ponta. AWS DevOps O agente lê várias habilidades durante a execução, como uma habilidade para recuperar implantações do seu CI/CD pipeline personalizado e uma habilidade para pesquisar seus repositórios de código. + **Amplifique as ferramentas personalizadas** — Crie habilidades que orientem o AWS DevOps Agente a usar suas ferramentas personalizadas de servidor MCP de forma eficaz. As habilidades podem documentar quando invocar ferramentas específicas, quais parâmetros usar em diferentes cenários e como interpretar os resultados para realizar fluxos de trabalho específicos para sua infraestrutura. ## Como as habilidades funcionam Quando o AWS DevOps agente encontra uma tarefa relevante, ele carrega as habilidades apropriadas e segue as instruções para orientar sua investigação. Por exemplo, uma habilidade de “Investigação de desempenho de banco de dados” pode incluir procedimentos passo a passo para analisar problemas de limitação do RDS, permitindo que o agente verifique sistematicamente o status do alarme, analise métricas de conexão e identifique consultas lentas. ## Estrutura de habilidades Uma habilidade é organizada como um diretório contendo: ``` my-skill/ ├── SKILL.md # Main skill instructions ├── references/ # Optional: additional reference documentation └── assets/ # Optional: images, diagrams, data files ``` ### SKILL.md Esse `SKILL.md` é o único arquivo obrigatório. Ele contém as principais instruções escritas no formato Markdown. Esse arquivo deve: + Descreva quando e como usar a habilidade. + Forneça procedimentos de investigação passo a passo. + Inclua árvores de decisão para diferentes cenários. + Documente os resultados esperados e os critérios de sucesso. ### Matéria frontal Frontmatter é o bloco de metadados na parte superior de um `SKILL.md` arquivo, entre delimitadores. `---` Ele contém os `description` campos `name` e que o AWS DevOps Agente usa para determinar quando ativar a habilidade durante uma investigação ou tarefa. ``` --- name: rds-performance-investigation description: Investigation procedures for RDS performance issues including connection exhaustion, slow queries, replication lag, and storage capacity. Use this skill when investigating database latency, connection errors, or read/write performance degradation. --- ``` **nome** — Um identificador exclusivo para a habilidade. Use somente letras minúsculas, números e hífens (máximo de 64 caracteres). Não deve começar nem terminar com um hífen. **descrição** — Uma explicação detalhada de quando e por que o AWS DevOps agente deve usar essa habilidade. AWS DevOps O agente avalia esse campo para decidir se a habilidade é relevante para a tarefa atual. Uma descrição vaga ou ausente pode fazer com que o agente ignore completamente a habilidade, mesmo que as instruções estejam bem escritas. **Importante** — Escreva a descrição do ponto de vista do agente. Inclua os cenários, serviços, tipos de erros ou sintomas específicos que devem acionar a habilidade. Por exemplo, “Use essa habilidade ao investigar a latência do banco de dados, erros de conexão ou tempos limite de consulta para instâncias do Amazon RDS” é mais eficaz do que “habilidade RDS”. Quando você cria uma habilidade na interface do usuário, o sistema gera o frontmatter automaticamente a partir do nome e da descrição que você fornece. As habilidades enviadas como arquivos zip devem incluir o frontmatter no `SKILL.md` arquivo. ## Exemplo: habilidade completa O exemplo a seguir mostra uma habilidade completa e bem formada para investigar problemas de desempenho do RDS. Ele demonstra a estrutura do diretório, o SKILL.md front-matter, os procedimentos de investigação acionáveis e um arquivo de referências suplementar. **Estrutura de diretórios:** ``` rds-performance-investigation/ ├── SKILL.md ├── references/ │ └── rds-metrics-reference.md └── assets/ └── rds-investigation-flowchart.png ``` **SKILL.md:** ``` --- name: rds-performance-investigation description: Investigation procedures for RDS performance issues including connection exhaustion, slow queries, replication lag, and storage capacity. Use this skill when investigating database latency, connection errors, or read/write performance degradation. --- # RDS Performance Investigation Use this skill when customers report database latency, connection errors, query timeouts, or read/write performance degradation. ## Step 1: Check alarm status Query CloudWatch for active alarms on the affected RDS instance. Look for: - `DatabaseConnections` exceeding 80% of max_connections - `ReadLatency` or `WriteLatency` above 20ms - `FreeStorageSpace` below 20% of total storage - `ReplicaLag` above 30 seconds (read replicas only) ## Step 2: Analyze connection metrics Retrieve `DatabaseConnections` over the past hour. If connections are near the max_connections limit, check for connection pool misconfiguration or long-running idle connections. ## Step 3: Identify slow queries Use Performance Insights (`pi:GetResourceMetrics`) to retrieve the top SQL statements by average active sessions. Focus on queries with high `db.load` contribution or frequent I/O waits. ## Step 4: Summarize findings Provide a summary with: 1. Current performance status (healthy / degraded / critical) 2. Root cause hypothesis with supporting metrics 3. Recommended remediation steps ranked by priority ``` **references/rds-metrics-reference.md:** ``` # RDS CloudWatch Metrics Reference | Metric | Normal Range | Investigation Threshold | |---|---|---| | DatabaseConnections | < 70% max_connections | > 80% max_connections | | ReadLatency | < 5ms | > 20ms | | WriteLatency | < 5ms | > 20ms | | FreeStorageSpace | > 30% total storage | < 20% total storage | | ReplicaLag | < 5 seconds | > 30 seconds | | CPUUtilization | < 70% | > 85% | ``` ## Exemplo: habilidade de filtragem de incidentes As habilidades direcionadas ao tipo de agente de **triagem de incidentes** podem definir critérios para ignorar incidentes automaticamente. Use isso para filtrar incidentes que não exigem investigação. Quando um novo incidente corresponde aos critérios de ignorar, o AWS DevOps agente o marca como **Ignorado**. O sistema fornece um motivo que explica por que ele foi filtrado. O exemplo a seguir mostra uma habilidade que ignora incidentes de baixa prioridade durante a manutenção programada: **SKILL.md:** ``` --- name: skip-scheduled-maintenance description: Skip low-priority incidents during a scheduled maintenance window. Use this skill to automatically filter MEDIUM and LOW severity alarms that fire during planned maintenance, avoiding unnecessary investigations for expected disruptions. --- # Skip Scheduled Maintenance Skip all incidents that meet BOTH of the following criteria: 1. The incident arrived between **2025-03-15 02:00 UTC** and **2025-03-15 06:00 UTC** 2. Severity is MEDIUM or LOW Do NOT skip HIGH or CRITICAL severity incidents, even during the maintenance window. ``` Ao criar essa habilidade, selecione **Triagem de incidentes** como o tipo de agente. Isso garante que a habilidade seja avaliada somente durante a fase de triagem. ## Criando habilidades Antes de criar habilidades, você deve ter um Espaço do Agente. Para obter mais informações, consulte [Criação de um espaço de agente](getting-started-with-aws-devops-agent-creating-an-agent-space.md). Você pode criar habilidades de duas maneiras, dependendo das preferências do fluxo de trabalho e da complexidade das habilidades: ### Criando uma habilidade na interface As habilidades criadas no AWS DevOps Agent Operator Web App contêm nome, descrição e instruções em um único SKILL.md arquivo. **Para criar uma habilidade na interface do usuário:** + Navegue até a página de habilidades em seu aplicativo web Agent Space Operator. + Clique em “Adicionar habilidade”. + Selecione “Criar habilidade” no modal. + Preencha o formulário de habilidades: + **Nome** — Somente letras minúsculas, números e hífens (máximo de 64 caracteres). Não deve começar nem terminar com um hífen. Exemplo: `rds-throttling-investigation` + **Descrição** — Breve explicação de quando usar essa habilidade (mínimo de 100 caracteres recomendados, máximo de 1.024 caracteres). Isso ajuda o agente a determinar quando ativar a habilidade. + **Status** — Defina como Ativo (padrão) ou Inativo. Habilidades inativas não são usadas pelo agente. + **Tipo de agente** — Selecione um ou mais tipos de agentes que podem usar essa habilidade. **Genérico** é selecionado por padrão e disponibiliza a habilidade para todos os tipos de agentes. Para atingir agentes específicos, desmarque Genérico e escolha entre: Triagem de incidentes On-demand, RCA de incidentes, Mitigação de incidentes ou Avaliação. + **Instruções** — Step-by-step procedimentos no formato Markdown. Seja específico e acionável. + Clique em “Criar” para salvar a habilidade. O sistema gera automaticamente um SKILL.md arquivo com a estrutura de frontmatter adequada. **Para editar uma habilidade criada na interface do usuário:** + Navegue até a habilidade na lista de habilidades e clique na habilidade para abri-la. + Clique em **Edit**. + Modifique o nome, a descrição ou as instruções. + Clique em **Salvar** para atualizar a habilidade. ### Fazendo o upload de uma habilidade As habilidades enviadas como arquivos zip contêm um SKILL.md arquivo e recursos adicionais, como materiais de referência ou ativos. **Estrutura de habilidades:** ``` my-skill.zip ├── SKILL.md # Required: main skill instructions ├── references/ # Optional: reference documentation │ ├── architecture.md │ └── troubleshooting.md └── assets/ # Optional: images, diagrams, data files ├── topology.png └── metrics.csv ``` **SKILL.md requisitos de frontmatter:** As habilidades enviadas como arquivos zip devem incluir o frontmatter em SKILL.md with `name` e `description` os campos. AWS DevOps O agente usa esses campos para determinar quando ativar a habilidade. Para obter detalhes sobre como escrever um frontmatter eficaz, consulte a seção Frontmatter anteriormente neste tópico. ``` --- name: rds-performance-analysis description: Comprehensive RDS performance investigation procedures for connection exhaustion, slow queries, and storage capacity issues. Use when investigating database latency or read/write degradation. --- # RDS Performance Analysis [Your skill instructions here...] ``` **Para criar uma habilidade via upload zip:** + Crie um diretório com seus arquivos de habilidades seguindo a estrutura acima. + Certifique-se de SKILL.md incluir o conteúdo inicial adequado (nome e descrição). + Comprima o diretório em um arquivo.zip. + Navegue até a página de habilidades em seu aplicativo web Agent Space Operator. + Clique em “Adicionar habilidade”. + Selecione “Habilidade de upload” no modal. + Arraste e solte seu arquivo.zip ou clique para navegar (somente arquivos ZIP, máximo de 6 MB). + Selecione um ou mais tipos de agentes que possam usar essa habilidade (Genérico é selecionado por padrão e se aplica a todos os tipos de agentes; desmarque especificamente para alvo On-demand, triagem de incidentes, RCA de incidentes, mitigação de incidentes ou avaliação). + Analise os requisitos do arquivo zip e os resultados da validação. + Clique em “Carregar” para adicionar a habilidade ao seu Espaço do Agente. **Restrições importantes para habilidades enviadas como arquivos zip:** + **Atualmente, não há suporte para scripts** — as habilidades que contêm scripts no `scripts/` diretório serão rejeitadas durante o upload. A execução de scripts será habilitada em uma versão futura quando os agentes tiverem acesso a um ambiente de codificação seguro. + **Limite de tamanho** — O tamanho total do arquivo zip não deve exceder 6 MB (incluindo todos os arquivos). + **SKILL.md obrigatório** — O arquivo zip deve conter um SKILL.md arquivo com frontmatter válido. **Melhores práticas para habilidades de nomenclatura:** Use nomes claros e descritivos, como “rds-throttling-investigation”, em vez de nomes genéricos. Um bom nome de habilidade reflete o cenário ou serviço específico abordado, facilitando a identificação rápida da habilidade certa. ## Gerenciar habilidades AWS DevOps O Agent fornece recursos abrangentes de gerenciamento de habilidades por meio do Operator Web App: **Listando habilidades** — Veja todas as habilidades em seu Espaço do Agente. A página Habilidades exibe o nome da habilidade, o status ativo ou inativo, a data de criação, a data da última atualização e as ações disponíveis. **Habilidades de visualização** — Clique em qualquer habilidade para ver sua visualização detalhada. As habilidades criadas na interface exibem conteúdo editável em que você pode modificar o nome, a descrição ou as instruções diretamente na interface do usuário e clicar em “Salvar” para atualizar. As habilidades enviadas como arquivos zip exibem uma árvore de arquivos SKILL.md e quaisquer diretórios adicionais, como references/ e assets/. Clique nos arquivos na árvore para ver seu conteúdo no modo somente leitura. **Seleção de agentes para uma habilidade** — Configure quais tipos de agentes podem usar cada habilidade ao criá-la ou editá-la. **No menu suspenso Tipo de agente, selecione um ou mais tipos de agentes usando as caixas de seleção: **Genérico** (padrão — aplica-se a todos os tipos de agentes), **On-demand**(consultas conversacionais), **Triagem de incidentes (avaliação inicial do incidente**), **RCA do incidente (análise da causa raiz), Mitigação de incidentes** **(resposta automática a incidentes**) ou Avaliação (recomendações proativas).** Genérico é selecionado por padrão e disponibiliza a habilidade para todos os tipos de agentes. As habilidades direcionadas a agentes específicos reduzem o consumo de contexto e melhoram o foco do agente. **Ativando e desativando habilidades — Desative temporariamente as habilidades** sem excluí-las usando o botão de alternância. Active/Inactive Abra a visualização de detalhes da habilidade e alterne a opção para “Inativa” para evitar que o agente a carregue para novas investigações, preservando todo o conteúdo e as configurações. In-progress as investigações continuam usando a habilidade. Volte para “Ativo” para tornar a habilidade imediatamente disponível novamente. **Atualização de habilidades** — modifique as habilidades existentes com base em como elas foram criadas. Para habilidades criadas na interface do usuário, clique em “Editar” na visualização de detalhes da habilidade, modifique o nome, a descrição ou as instruções e clique em “Salvar” para atualizar. Para habilidades enviadas como arquivos zip, modifique os arquivos localmente, crie um novo arquivo zip e faça upload de uma nova versão. **Excluindo habilidades** — Remova permanentemente as habilidades do seu Espaço do Agente. Abra a visualização da lista de habilidades, clique no menu de mais opções (✔) e selecione “Excluir”, revise o aviso sobre exclusão permanente, digite o nome da habilidade para confirmar e clique em “Excluir habilidade”. A exclusão não pode ser desfeita. In-progress as investigações podem ser afetadas se tentarem carregar a habilidade excluída. Para habilidades enviadas como arquivos zip, baixe o arquivo zip antes de excluí-lo como backup. Considere desativar a habilidade em vez de excluí-la se precisar dela novamente. ## Migrando dos Runbooks Os Runbooks existentes são migrados automaticamente para o Skills sem a necessidade de ação do cliente. Quando seu Agent Space faz a transição para o modelo Skills, todos os Runbooks são convertidos em Skills e aparecem na sua interface de Skills. Após a migração, você pode: + **Analise as habilidades migradas** — Verifique se a migração automática converteu corretamente seus Runbooks. + **Atualize conforme necessário** — edite as habilidades diretamente na interface do usuário para refinar as instruções, atualizar as descrições ou configurar a segmentação por tipo de agente. + **Expanda com referências** — Para habilidades que se beneficiariam de materiais de referência adicionais ou diagramas de arquitetura, recrie-as como habilidades de upload de zip com um diretório references/ ou assets/. + **Crie novas habilidades** — Adicione novas habilidades para fluxos de trabalho de investigação não cobertos anteriormente pelos Runbooks. Entre em contato com o AWS Support se você encontrar algum problema com as habilidades migradas automaticamente ou precisar de ajuda com atualizações pós-migração.