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 — um padrão aberto para empacotar instruções e recursos do agente — suportando somente documentos não executáveis: instruções Markdown, imagens e arquivos de dados. PDFs

Cada habilidade requer um arquivo SKILL.md contendo as instruções que você deseja fornecer ao seu AWS DevOps agente. Além do arquivo SKILL.md 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 às 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 step-by-step procedimentos 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:

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 frontmatter do Skill.md, 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

referências/ .md: rds-metrics-reference

# 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% |

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.

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

Criação de 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 arquivo SKILL.md.

Para criar uma habilidade na interface do usuário:

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

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

Fazendo o upload de uma habilidade

As habilidades enviadas como arquivos zip contêm um arquivo SKILL.md, além de 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

Requisitos do frontmatter do Skill.md:

As habilidades enviadas como arquivos zip devem incluir frontmatter em Skill.md com e campos. name description 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:

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

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 mostrando 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), Sob demanda (consultas conversacionais), Triagem de incidentes (avaliação inicial do incidente), RCA do incidente (análise da causa raiz), Mitigação de incidentes (resposta automatizada 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. As investigações em andamento 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 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, clique no menu de mais opções (disable) 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. Investigações em andamento podem ser afetadas se elas 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:

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.