Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

DevOps Fähigkeiten der Agenten

AWS DevOps Agent Skills sind modulare Befehlssätze, die die Fähigkeiten des Agenten um spezialisiertes Fachwissen und Ermittlungsmethoden erweitern, die auf Ihre Infrastruktur und Ihre betrieblichen Arbeitsabläufe zugeschnitten sind.

Was sind Fähigkeiten

Skills sind eigenständige Verzeichnisse, die Markdown-Anweisungen enthalten, die dem Agenten spezielle Funktionen zur AWS DevOps Verfügung stellen. AWS DevOps Der Agent unterstützt einen Teil der Agent Skills-Spezifikation — einen offenen Standard für die Paketierung von Anweisungen und Ressourcen für Agenten — und unterstützt nur Dokumente, die nicht ausführbar sind: Markdown-Anweisungen, Bilder und Datendateien. PDFs

Für jeden Skill ist eine Skill.md-Datei erforderlich, die Anweisungen enthält, die Sie Ihrem Agenten zur Verfügung stellen möchten. AWS DevOps Zusätzlich zur erforderlichen Skill.md-Datei können Skills Folgendes beinhalten:

Warum Skills einsetzen

Skills machen AWS DevOps Agent von einem Allzweck-Assistenten zu einem Spezialisten für Ihre Infrastruktur und Ihre betrieblichen Arbeitsabläufe. Im Gegensatz zu einmaligen Anweisungen in einer Chat-Nachricht sind Skills wiederverwendbare Funktionen, die automatisch geladen werden, wenn sie für die vom AWS DevOps Agenten ausgeführten Aufgaben relevant sind.

Die wichtigsten Vorteile:

So funktionieren Skills

Wenn der AWS DevOps Agent auf eine relevante Aufgabe stößt, lädt er die entsprechenden Fähigkeiten ein und folgt den Anweisungen, die ihm bei der Untersuchung zur Verfügung stehen. Ein Skill „Untersuchung der Datenbankleistung“ kann beispielsweise step-by-step Verfahren zur Analyse von Problemen mit der RDS-Drosselung beinhalten, sodass der Agent den Alarmstatus systematisch überprüfen, Verbindungsmetriken analysieren und langsame Abfragen identifizieren kann.

Struktur der Fertigkeiten

Ein Skill ist als Verzeichnis organisiert, das Folgendes enthält:

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

Skill.md

Das SKILL.md ist die einzige obligatorische Datei. Sie enthält die Kernanweisungen, die im Markdown-Format geschrieben sind. Diese Datei sollte:

Frontsache

Frontmatter ist der Metadatenblock am Anfang einer SKILL.md Datei, der zwischen --- Trennzeichen eingeschlossen ist. Es enthält die description Felder name und, anhand derer der AWS DevOps Agent festlegt, wann der Skill während einer Untersuchung oder Aufgabe aktiviert werden soll.

---
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 — Eine eindeutige Kennung für den Skill. Verwenden Sie nur Kleinbuchstaben, Zahlen und Bindestriche (maximal 64 Zeichen). Darf nicht mit einem Bindestrich beginnen oder enden.

Beschreibung — Eine ausführliche Erklärung, wann und warum der AWS DevOps Agent diesen Skill einsetzen sollte. AWS DevOps Der Agent bewertet dieses Feld, um zu entscheiden, ob der Skill für die aktuelle Aufgabe relevant ist. Eine vage oder fehlende Beschreibung kann dazu führen, dass der Agent den Skill komplett überspringt, selbst wenn die Anweisungen gut geschrieben sind.

Wichtig — Schreiben Sie die Beschreibung aus der Sicht des Agenten. Geben Sie die spezifischen Szenarien, Dienste, Fehlertypen oder Symptome an, die den Skill auslösen sollten. Beispielsweise ist „Verwenden Sie diesen Skill bei der Untersuchung von Datenbanklatenz, Verbindungsfehlern oder Abfrage-Timeouts für Amazon RDS-Instances“ effektiver als „RDS-Skill“.

Wenn Sie einen Skill in der Benutzeroberfläche erstellen, generiert das System anhand des von Ihnen angegebenen Namens und der Beschreibung automatisch eine Titelseite. Skills, die als ZIP-Dateien hochgeladen werden, müssen Frontmaterial in der SKILL.md Datei enthalten.

Beispiel: Fertigkeit abschließen

Das folgende Beispiel zeigt eine vollständige, wohlgeformte Fähigkeit zur Untersuchung von RDS-Leistungsproblemen. Es zeigt die Verzeichnisstruktur, den Inhalt von Skill.md, umsetzbare Ermittlungsverfahren und eine ergänzende Referenzdatei.

Verzeichnisstruktur:

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

referenzen/ .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% |

Fähigkeiten schaffen

Bevor Sie Skills erstellen können, müssen Sie über einen Agent Space verfügen. Weitere Informationen finden Sie unter Einen Agentenbereich erstellen.

Je nach Ihren Workflow-Einstellungen und der Komplexität Ihrer Fähigkeiten können Sie Skills auf zwei Arten erstellen:

Einen Skill in der Benutzeroberfläche erstellen

Fähigkeiten, die in der AWS DevOps Agent Operator Web App erstellt wurden, enthalten einen Namen, eine Beschreibung und Anweisungen in einer einzigen Skill.md-Datei.

So erstellen Sie einen Skill in der Benutzeroberfläche:

Das System generiert automatisch eine Skill.md-Datei mit der richtigen Frontmatter-Struktur.

Um einen in der Benutzeroberfläche erstellten Skill zu bearbeiten:

Einen Skill hochladen

Fähigkeiten, die als ZIP-Dateien hochgeladen wurden, enthalten eine Skill.md-Datei sowie zusätzliche Ressourcen wie Referenzmaterial oder Ressourcen.

Struktur der Fähigkeiten:

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

Anforderungen an Skill.MD Frontmatter:

Skills, die als ZIP-Dateien hochgeladen werden, müssen Frontmatter in Skill.md mit Feldern und enthalten. name description AWS DevOps Der Agent verwendet diese Felder, um zu bestimmen, wann der Skill aktiviert werden soll. Einzelheiten zum Verfassen effektiver Titelseiten finden Sie weiter oben in diesem Thema im Abschnitt Frontmatter.

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

So erstellen Sie einen Skill per ZIP-Upload:

Wichtige Einschränkungen für Skills, die als ZIP-Dateien hochgeladen wurden:

Bewährte Methoden zur Benennung von Fähigkeiten:

Verwenden Sie klare, aussagekräftige Namen wie "rds-throttling-investigation" anstelle von generischen Namen. Ein guter Skillname spiegelt das spezifische Szenario oder den Service wider, für den er sich eignet, sodass es einfacher ist, den richtigen Skill auf einen Blick zu identifizieren.

Verwalten von Qualifikationen

AWS DevOps Agent bietet über die Operator Web App umfassende Funktionen zur Verwaltung von Fähigkeiten:

Fähigkeiten auflisten — Sehen Sie sich alle Fähigkeiten in Ihrem Agentenbereich an. Auf der Seite Skills werden der Skillname, der Status Aktiv oder Inaktiv, das Erstellungsdatum, das Datum der letzten Aktualisierung und die verfügbaren Aktionen angezeigt.

Skills anzeigen — Klicken Sie auf einen Skill, um dessen Detailansicht zu öffnen. In der Benutzeroberfläche erstellte Fähigkeiten zeigen bearbeitbare Inhalte an, in denen Sie den Namen, die Beschreibung oder Anweisungen direkt in der Benutzeroberfläche ändern und zur Aktualisierung auf „Speichern“ klicken können. Bei Fähigkeiten, die als ZIP-Dateien hochgeladen wurden, wird ein Dateibaum angezeigt, der Skill.md und alle zusätzlichen Verzeichnisse wie references/ und assets/ enthält. Klicken Sie in der Baumstruktur auf Dateien, um deren Inhalt im schreibgeschützten Modus anzuzeigen.

Agenten für einen Skill auswählen — Konfigurieren Sie, welche Agententypen die einzelnen Skills bei der Erstellung oder Bearbeitung verwenden können. Wählen Sie in der Dropdownliste Agententyp mithilfe der folgenden Kontrollkästchen einen oder mehrere Agententypen aus: Generisch (Standard — gilt für alle Agententypen), On-Demand (Konversationsanfragen), Incident Triage (erste Bewertung des Vorfalls), Incident RCA (Ursachenanalyse), Incident Mitigation (automatisierte Reaktion auf Vorfälle) oder Evaluation (proaktive Empfehlungen). Generisch ist standardmäßig ausgewählt und macht den Skill für alle Agententypen verfügbar. Fähigkeiten, die auf bestimmte Agenten ausgerichtet sind, reduzieren den Kontextverbrauch und verbessern den Fokus der Agenten.

Skills aktivieren und deaktivieren — Skills vorübergehend deaktivieren, ohne sie mit dem Active/Inactive Schalter zu löschen. Öffne die Skill-Detailansicht und stelle den Schalter auf „Inaktiv“, um zu verhindern, dass der Agent sie für neue Untersuchungen lädt, während alle Inhalte und Konfigurationen erhalten bleiben. Bei laufenden Untersuchungen wird der Skill weiterhin verwendet. Wechsle zurück zu „Aktiv“, um den Skill sofort wieder verfügbar zu machen.

Skills aktualisieren — Ändern Sie bestehende Skills auf Grundlage der Art und Weise, wie sie erstellt wurden. Klicken Sie bei Fähigkeiten, die in der Benutzeroberfläche erstellt wurden, in der Skill-Detailansicht auf „Bearbeiten“, ändern Sie den Namen, die Beschreibung oder die Anweisungen und klicken Sie zur Aktualisierung auf „Speichern“. Bei Skills, die als ZIP-Dateien hochgeladen wurden, ändern Sie die Dateien lokal, erstellen Sie eine neue ZIP-Datei und laden Sie eine neue Version hoch.

Skills löschen — Entfernen Sie Skills dauerhaft aus Ihrem Agentenbereich. Öffnen Sie die Skill-Listenansicht, klicken Sie auf das Menü mit weiteren Optionen () und wählen Sie „Löschen“ aus. Lesen Sie die Warnung vor dem dauerhaften Löschen, geben Sie zur Bestätigung den Namen des Skills ein und klicken Sie auf „Skill löschen“. Das Löschen kann nicht rückgängig gemacht werden. Laufende Untersuchungen können beeinträchtigt werden, wenn versucht wird, den gelöschten Skill zu laden. Bei Skills, die als ZIP-Dateien hochgeladen wurden, laden Sie die ZIP-Datei herunter, bevor Sie sie als Backup löschen. Erwägen Sie, den Skill zu deaktivieren, anstatt ihn zu löschen, falls Sie ihn erneut benötigen.

Migration von Runbooks

Bestehende Runbooks werden automatisch zu Skills migriert, ohne dass ein Eingreifen des Kunden erforderlich ist. Wenn Ihr Agent Space auf das Skills-Modell umgestellt wird, werden alle Runbooks in Skills umgewandelt und erscheinen in Ihrer Skills-Benutzeroberfläche. Nach der Migration können Sie:

Wenden Sie sich an den AWS Support, wenn Sie Probleme mit automatisch migrierten Skills haben oder Unterstützung bei Updates nach der Migration benötigen.