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 Agent Skills são conjuntos de instruções modulares que ampliam as capacidades do agente com conhecimento de domínio especializado 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 Markdown que fornecem recursos especializados ao Agente. AWS DevOps AWS DevOps O Agent suporta um subconjunto da especificação Agent Skills — um padrão aberto para instruções e recursos de agentes de embalagem — suportando somente documentos não executáveis: instruções Markdown, PDFs, imagens e arquivos de dados.

Cada habilidade exige 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:

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 para as tarefas executadas pelo agente. AWS DevOps

Principais benefícios:

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

SKILL.mdÉ o único arquivo obrigatório. Ele contém as instruções principais escritas no formato Markdown. Esse arquivo deve:

Frontmatter

O 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 inexistente 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 erro ou sintomas específicos que devem acionar a habilidade. Por exemplo, “Use essa habilidade ao investigar latência de banco de dados, erros de conexão ou tempos limite de consulta para instâncias do Amazon RDS” é mais eficaz do que “habilidade de 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 assunto principal, os procedimentos de investigação acionáveis e um arquivo de referências suplementares.

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.

Criação de habilidades

Antes de criar habilidades, você deve ter um Agent Space. Para obter mais informações, consulte Criação de um espaço de agente.

Você pode criar habilidades de duas maneiras, dependendo das preferências de fluxo de trabalho e da complexidade das habilidades:

Para gerenciar habilidades de forma programática por meio da AWS CLI ou dos AWS SDKs, consulte. Gerenciar ativos

Criando uma habilidade na interface do usuário

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:

O sistema gera automaticamente um SKILL.md arquivo com a estrutura de frontmatter adequada.

Para editar uma habilidade criada na interface do usuário:

Enviando 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 do frontmatter:

As habilidades enviadas como arquivos zip devem incluir o frontmatter nos campos SKILL.md com name edescription. 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 anterior 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 por meio de upload zip:

Restrições importantes para habilidades enviadas como arquivos zip:

Práticas recomendadas para nomear habilidades:

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.

Importar uma habilidade de um repositório

Você pode importar habilidades diretamente de um diretório de GitHub repositório. AWS DevOps O agente busca o conteúdo da habilidade no repositório, extrai o nome e a descrição do SKILL.md frontmatter e cria a habilidade no seu Espaço do Agente. Isso permite gerenciar habilidades em controle de versão e importá-las com uma única ação.

Pré-requisitos:

Estrutura do repositório:

O diretório do repositório que você importa deve seguir a estrutura de habilidades padrão:

my-skill/
├── SKILL.md              # Required: must include name and description in frontmatter
├── references/           # Optional: reference documentation
│   └── runbook.md
└── assets/               # Optional: images, diagrams, data files
    └── architecture.png

Para importar uma habilidade de um repositório:

AWS DevOps O agente busca o conteúdo do diretório, lê o SKILL.md frontmatter para extrair o nome e a descrição da habilidade e importa todos os arquivos para o seu Agent Space.

Visualizando habilidades importadas:

As habilidades importadas aparecem na lista de habilidades personalizadas com um link para o repositório de origem. Na visualização detalhada da habilidade:

Sincronizando habilidades importadas:

Ao atualizar os arquivos de habilidade em seu repositório, você pode sincronizar a habilidade importada para obter as alterações mais recentes:

Você também pode sincronizar a partir da visualização da lista de habilidades escolhendo Sincronizar na linha de habilidades importada.

Restrições:

Ferramentas comunitárias

O repositório AWS DevOps Agent Tools no GitHub site contém habilidades contribuídas pela comunidade, agentes personalizados e servidores MCP que você pode usar no estado em que se encontram ou como ponto de partida para escrever seus próprios. O repositório é mantido pela equipe de atendimento do AWS DevOps agente. Todas as contribuições passam pela mesma barra de análise de segurança antes de serem adicionadas, para que você obtenha a entrega rápida de novos recursos com a garantia de que cada ferramenta atenda aos padrões AWS de qualidade. Para ver o que está disponível, consulte a galeria de habilidades da comunidade no GitHub site.

As habilidades disponíveis incluem:

Para usar uma habilidade comunitária:

Cada habilidade inclui um README com pré-requisitos e instruções de uso.

O repositório também inclui agentes personalizados da comunidade e servidores MCP implantáveis. Para obter detalhes, consulte Agentes personalizados da comunidade e servidores MCP da comunidade.

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 no seu Espaço do Agente. A guia Habilidades da página de conhecimento exibe o nome da habilidade, status ativo ou inativo, data de criação, data da última atualização e ações disponíveis.

Habilidades de visualização — Escolha qualquer habilidade para ver sua visualização detalhada. As habilidades criadas na interface exibem conteúdo editável, no qual você pode modificar o nome, a descrição ou as instruções diretamente na interface e escolher “Salvar” para atualizar. As habilidades carregadas como arquivos zip exibem uma árvore de arquivos SKILL.md e quaisquer diretórios adicionais, como references/ e assets/. Escolha arquivos na árvore para visualizar seu conteúdo no modo somente leitura.

Selecionar 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 — se aplica 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). A opção Genérica é selecionada 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 detalhada 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. Para ativar ou desativar habilidades programaticamente, consulte Ativando e desativando habilidades na página Gerenciando ativos.

Atualizando habilidades — Modifique as habilidades existentes com base em como elas foram criadas. Para habilidades criadas na interface do usuário, escolha “Editar” na visualização de detalhes da habilidade, modifique o nome, a descrição ou as instruções e escolha “Salvar” para atualizar. Para habilidades enviadas como arquivos zip, modifique os arquivos localmente, crie um novo arquivo zip e faça o 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, escolha o menu de mais opções () e selecione “Excluir”, revise o aviso sobre exclusão permanente, digite o nome da habilidade para confirmar e escolha “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 nenhuma 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 usuário de Skills. Após a migração, você pode:

Entre em contato com o AWS Suporte se você encontrar algum problema com as habilidades migradas automaticamente ou precisar de ajuda com as atualizações pós-migração.