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, PDF, images et fichiers de données.

Chaque compétence nécessite un SKILL.md fichier contenant les instructions que vous souhaitez fournir à votre AWS DevOps agent. Outre le SKILL.md dossier 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 en fonction des 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 procédures étape par étape pour analyser les problèmes de régulation du 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 expliquant quand et pourquoi 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 écrites.

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, les SKILL.md matières premières, 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

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

Exemple : compétence de filtrage des incidents

Les compétences adaptées au type d'agent de triage des incidents peuvent définir des critères permettant d'ignorer automatiquement les incidents. Utilisez-le pour filtrer les incidents qui ne nécessitent pas d'investigation. Lorsqu'un nouvel incident répond aux critères d'exclusion, AWS DevOps l'agent le marque comme ignoré. Le système fournit une raison expliquant pourquoi il a été filtré.

L'exemple suivant montre une compétence qui ignore les incidents peu prioritaires lors de la maintenance planifiée :

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.

Lorsque vous créez cette compétence, sélectionnez Incident Triage comme type d'agent. Cela garantit que la compétence n'est évaluée que pendant la phase de triage.

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 :

Pour gérer les compétences de manière programmatique via la AWS CLI ou AWS les SDK, voir. Gestion des actifs

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 SKILL.md fichier.

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

Le système génère automatiquement un SKILL.md fichier 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 SKILL.md fichier 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

SKILL.md exigences relatives à la matière première :

Les compétences téléchargées sous forme de fichiers zip doivent inclure des éléments de base dans les description champs SKILL.md with name et. 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, procédez comme suit :

Restrictions importantes pour 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.

Importer une compétence depuis un référentiel

Vous pouvez importer des compétences directement depuis un répertoire de GitHub référentiel. AWS DevOps L'agent extrait le contenu de la compétence depuis le référentiel, extrait le nom et la description de SKILL.md la base et crée la compétence dans votre espace agent. Cela vous permet de gérer les compétences en matière de contrôle de version et de les importer en une seule action.

Prérequis :

Structure du référentiel :

Le répertoire du référentiel que vous importez doit suivre la structure de compétences standard :

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

Pour importer une compétence depuis un dépôt, procédez comme suit :

AWS DevOps L'agent récupère le contenu du répertoire, lit le texte de SKILL.md base pour en extraire le nom et la description de la compétence, et importe tous les fichiers dans votre espace agent.

Afficher les compétences importées :

Les compétences importées apparaissent dans la liste des compétences personnalisées avec un lien vers le référentiel source. Dans la vue détaillée des compétences :

Synchronisation des compétences importées :

Lorsque vous mettez à jour les fichiers de compétences dans votre référentiel, vous pouvez synchroniser la compétence importée pour obtenir les dernières modifications :

Vous pouvez également effectuer une synchronisation depuis la liste des compétences en cliquant sur le bouton Synchroniser sur la ligne de compétences importée.

Contraintes :

Exemples de compétences

Le référentiel de DevOps compétences GitHub contient des compétences mises à disposition par la communauté que vous pouvez utiliser telles quelles ou comme point de départ pour écrire les vôtres. Les exemples disponibles incluent des compétences en matière d'investigation d'événements de AWS santé, d'analyse de cas de AWS support, d'examens opérationnels d'EKS et d'examens opérationnels de RDS. Pour parcourir les compétences disponibles, consultez la galerie des compétences communautaires.

Pour utiliser un exemple de compétence :

Chaque compétence inclut un fichier README avec les prérequis et les instructions d'utilisation.

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 : consultez toutes les compétences de votre espace d'agent. L'onglet Compétences de la page de connaissances 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.

Compétences de visualisation : choisissez 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 choisir « Enregistrer » pour les mettre à jour. Les compétences téléchargées sous forme de fichiers zip affichent une arborescence de fichiers SKILL.md et tous les répertoires supplémentaires tels que references/ et assets/. Choisissez des 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), On-demand(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. In-progress les enquêtes se poursuivent en utilisant cette compétence. Revenez à « Active » pour que la compétence soit à nouveau immédiatement disponible. Pour activer ou désactiver des compétences par programmation, consultez la section Activation et désactivation des compétences sur la page Gestion des actifs.

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, choisissez « Modifier » dans la vue détaillée des compétences, modifiez le nom, la description ou les instructions, puis choisissez « 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, choisissez 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 choisissez « Supprimer la compétence ». La suppression ne peut pas être annulée. In-progress les enquêtes 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.