Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DevOps Compétences des agents

AWS DevOps Les compétences des agents sont des ensembles d'instructions modulaires qui étendent les capacités de l'agent grâce à des connaissances spécialisées dans le domaine et à des méthodologies d'investigation adaptées à votre infrastructure et à vos flux de travail opérationnels.

Que sont les compétences

Les compétences sont des répertoires autonomes contenant des instructions Markdown qui fournissent des fonctionnalités spécialisées à l' AWS DevOps Agent. AWS DevOps Agent prend en charge un sous-ensemble de la spécification Agent Skills, une norme ouverte pour les instructions et les ressources relatives aux agents d'emballage, qui ne prend en charge que les documents non exécutables : instructions Markdown, PDFs images et fichiers de données.

Chaque compétence nécessite un fichier Skill.md contenant les instructions que vous souhaitez fournir à votre AWS DevOps agent. Outre le fichier Skill.md requis, les compétences peuvent inclure :

Pourquoi utiliser Skills

Grâce à ses compétences, AWS DevOps l'agent passe du statut d'assistant généraliste à celui de spécialiste de votre infrastructure et de vos flux de travail opérationnels. Contrairement aux instructions ponctuelles fournies dans un message de chat, les compétences sont des fonctionnalités réutilisables qui se chargent automatiquement lorsqu'elles sont pertinentes pour les tâches effectuées par AWS DevOps l'Agent.

Principaux avantages :

Comment fonctionnent les compétences

Lorsque AWS DevOps l'agent est confronté à une tâche pertinente, il charge les compétences appropriées et suit les instructions pour guider son enquête. Par exemple, une compétence « Investigation des performances des bases de données » peut inclure des step-by-step procédures d'analyse des problèmes de régulation RDS, permettant à l'agent de vérifier systématiquement l'état des alarmes, d'analyser les métriques de connexion et d'identifier les requêtes lentes.

Structure des compétences

Une compétence est organisée sous la forme d'un répertoire contenant :

my-skill/
├── SKILL.md              # Main skill instructions
├── references/           # Optional: additional reference documentation
└── assets/               # Optional: images, diagrams, data files

Skill.MD

SKILL.mdIl s'agit du seul fichier obligatoire. Il contient les instructions de base écrites au format Markdown. Ce fichier doit :

Matière première

Le Frontmatter est le bloc de métadonnées situé en haut d'un SKILL.md fichier, entre des --- délimiteurs. Il contient les description champs name et que AWS DevOps l'agent utilise pour déterminer quand activer la compétence lors d'une enquête ou d'une tâche.

---
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.
---

name — Identifiant unique de la compétence. Utilisez uniquement des lettres minuscules, des chiffres et des traits d'union (64 caractères maximum). Ne doit pas commencer ou se terminer par un trait d'union.

description — Une explication détaillée du moment et des raisons pour lesquelles AWS DevOps l'agent doit utiliser cette compétence. AWS DevOps L'agent évalue ce champ pour déterminer si la compétence est pertinente pour la tâche en cours. Une description vague ou manquante peut amener l'agent à ignorer complètement la compétence, même si les instructions sont bien rédigées.

Important — Rédigez la description du point de vue de l'agent. Incluez les scénarios, les services, les types d'erreur ou les symptômes spécifiques qui devraient déclencher la compétence. Par exemple, « Utiliser cette compétence pour étudier la latence de la base de données, les erreurs de connexion ou les délais de requête pour les instances Amazon RDS » est plus efficace que la « compétence RDS ».

Lorsque vous créez une compétence dans l'interface utilisateur, le système génère automatiquement des informations préliminaires à partir du nom et de la description que vous fournissez. Les compétences téléchargées sous forme de fichiers zip doivent inclure des éléments de base dans le SKILL.md fichier.

Exemple : compétence complète

L'exemple suivant montre une compétence complète et bien formée pour étudier les problèmes de performances RDS. Il présente la structure du répertoire, le dossier de Skill.md, les procédures d'enquête exploitables et un fichier de références supplémentaire.

Structure du répertoire :

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

références/ .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% |

Création de compétences

Avant de créer des compétences, vous devez disposer d'un espace agent. Pour de plus amples informations, veuillez consulter Création d'un espace d'agents.

Vous pouvez créer des compétences de deux manières en fonction de vos préférences en matière de flux de travail et de la complexité des compétences :

Création d'une compétence dans l'interface utilisateur

Les compétences créées dans l'application Web AWS DevOps Agent Operator contiennent un nom, une description et des instructions dans un seul fichier Skill.md.

Pour créer une compétence dans l'interface utilisateur :

Le système génère automatiquement un fichier Skill.md avec la structure de fond appropriée.

Pour modifier une compétence créée dans l'interface utilisateur :

Téléchargement d'une compétence

Les compétences téléchargées sous forme de fichiers zip contiennent un fichier Skill.md ainsi que des ressources supplémentaires telles que des documents de référence ou des actifs.

Structure des compétences :

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

Exigences relatives à la face avant Skill.md :

Les compétences téléchargées sous forme de fichiers zip doivent inclure le frontmatter dans Skill.md avec name les champs et. description AWS DevOps L'agent utilise ces champs pour déterminer quand activer la compétence. Pour plus de détails sur la rédaction d'un texte de base efficace, consultez la section du sujet principal plus haut dans cette rubrique.

---
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...]

Pour créer une compétence par téléchargement zip :

Restrictions importantes concernant les compétences téléchargées sous forme de fichiers zip :

Bonnes pratiques en matière de compétences en matière de dénomination :

Utilisez des noms clairs et descriptifs tels que « rds-throttling-investigation » plutôt que des noms génériques. Un bon nom de compétence reflète le scénario ou le service spécifique auquel il répond, ce qui permet d'identifier plus facilement la bonne compétence en un coup d'œil.

Gestion des skills

AWS DevOps L'agent fournit des fonctionnalités complètes de gestion des compétences via l'application Web Operator :

Répertorier les compétences — Afficher toutes les compétences de votre espace d'agent. La page Compétences affiche le nom de la compétence, son statut actif ou inactif, sa date de création, la date de dernière mise à jour et les actions disponibles.

Visualisation des compétences : cliquez sur n'importe quelle compétence pour voir sa vue détaillée. Les compétences créées dans l'interface utilisateur affichent un contenu modifiable dont vous pouvez modifier le nom, la description ou les instructions directement dans l'interface utilisateur et cliquer sur « Enregistrer » pour les mettre à jour. Les compétences téléchargées sous forme de fichiers zip affichent une arborescence de fichiers contenant Skill.md et tous les répertoires supplémentaires tels que references/ et assets/. Cliquez sur les fichiers dans l'arborescence pour afficher leur contenu en mode lecture seule.

Sélection d'agents pour une compétence : configurez les types d'agents autorisés à utiliser chaque compétence lors de sa création ou de sa modification. Dans le menu déroulant Type d'agent, sélectionnez un ou plusieurs types d'agents à l'aide des cases à cocher : générique (par défaut, s'applique à tous les types d'agents), à la demande (requêtes conversationnelles), triage des incidents (évaluation initiale des incidents), RCA des incidents (analyse des causes profondes), atténuation des incidents (réponse automatique aux incidents) ou évaluation (recommandations proactives). L'option Générique est sélectionnée par défaut et met la compétence à la disposition de tous les types d'agents. Les compétences destinées à des agents spécifiques réduisent la consommation de contexte et améliorent la concentration des agents.

Activation et désactivation des compétences : désactivez temporairement les compétences sans les supprimer à l'aide du bouton Active/Inactive . Ouvrez la vue détaillée des compétences et basculez sur « Inactif » pour empêcher l'agent de la charger pour de nouvelles enquêtes, tout en préservant l'ensemble du contenu et des configurations. Les enquêtes en cours continuent d'utiliser cette compétence. Revenez à « Active » pour que la compétence soit à nouveau immédiatement disponible.

Mise à jour des compétences : modifiez les compétences existantes en fonction de la façon dont elles ont été créées. Pour les compétences créées dans l'interface utilisateur, cliquez sur « Modifier » dans la vue détaillée des compétences, modifiez le nom, la description ou les instructions, puis cliquez sur « Enregistrer » pour les mettre à jour. Pour les compétences téléchargées sous forme de fichiers zip, modifiez les fichiers localement, créez un nouveau fichier zip et importez une nouvelle version.

Supprimer des compétences : supprimez définitivement des compétences de votre espace agent. Ouvrez l'affichage de la liste des compétences, cliquez sur le menu Autres options () et sélectionnez « Supprimer », consultez l'avertissement concernant la suppression définitive, saisissez le nom de la compétence pour confirmer, puis cliquez sur « Supprimer la compétence ». La suppression ne peut pas être annulée. Les enquêtes en cours peuvent être affectées si elles tentent de charger la compétence supprimée. Pour les compétences téléchargées sous forme de fichiers zip, téléchargez le fichier zip avant de le supprimer en tant que sauvegarde. Envisagez de désactiver la compétence au lieu de la supprimer si vous en avez à nouveau besoin.

Migration depuis Runbooks

Les Runbooks existants sont automatiquement migrés vers Skills sans qu'aucune action du client ne soit requise. Lorsque votre espace d'agent passe au modèle de compétences, tous les Runbooks sont convertis en compétences et apparaissent dans votre interface utilisateur de compétences. Après la migration, vous pouvez :

Contactez le AWS Support si vous rencontrez des problèmes avec les compétences migrées automatiquement ou si vous avez besoin d'aide pour les mises à jour après la migration.