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 von Agenten

AWS DevOps Bei den Agentenkompetenzen handelt es sich um modulare Befehlssätze, die die Fähigkeiten des Agenten um spezielle Fachkenntnisse und Ermittlungsmethoden erweitern, die auf Ihre Infrastruktur und Ihre betrieblichen Abläufe zugeschnitten sind.

Was sind Fähigkeiten

Skills sind eigenständige Verzeichnisse, die Markdown-Anweisungen enthalten, die dem Agenten spezielle Funktionen bieten. AWS DevOps AWS DevOps Agent unterstützt einen Teil der Agent Skills-Spezifikation — einen offenen Standard für das Verpacken von Anweisungen und Ressourcen für Agenten — und unterstützt nur nicht ausführbare Dokumente: Markdown-Anweisungen, PDFs, Bilder und Datendateien.

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

Warum Skills verwenden

Fähigkeiten machen den AWS DevOps Agenten von einem Allzweckassistenten zu einem Spezialisten für Ihre Infrastruktur und Ihre betrieblichen Abläufe. Im Gegensatz zu einmaligen Anweisungen in einer Chat-Nachricht handelt es sich bei Skills um wiederverwendbare Funktionen, die automatisch geladen werden, wenn sie für die vom AWS DevOps Agenten ausgeführten Aufgaben relevant sind.

Die wichtigsten Vorteile:

Wie funktionieren Fähigkeiten

Wenn der AWS DevOps Agent auf eine relevante Aufgabe stößt, lädt er die entsprechenden Fähigkeiten hoch und folgt den Anweisungen, um seine Untersuchung zu leiten. Ein Skill zum Thema „Untersuchung der Datenbankleistung“ könnte beispielsweise schrittweise Verfahren zur Analyse von RDS-Drosselungsproblemen beinhalten, sodass der Agent den Alarmstatus systematisch überprüfen, Verbindungskennzahlen analysieren und langsame Abfragen identifizieren kann.

Aufbau der Fertigkeit

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:

Titelthema

Frontmatter ist der Metadatenblock am Anfang einer SKILL.md Datei, der zwischen --- Trennzeichen eingeschlossen ist. Er 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 muss.

---
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 verwenden 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, auch 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 sollen. 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 in der Benutzeroberfläche einen Skill erstellen, generiert das System automatisch anhand des von Ihnen angegebenen Namens und der Beschreibung eine Vorlage. Skills, die als ZIP-Dateien hochgeladen werden, müssen das Titelthema in der SKILL.md Datei enthalten.

Beispiel: Fertigkeit abschließen

Das folgende Beispiel zeigt einen vollständigen, wohlgeformten Skill zur Untersuchung von RDS-Leistungsproblemen. Es zeigt die Verzeichnisstruktur, den SKILL.md Inhalt, 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

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

Beispiel: Fähigkeit zum Filtern von Vorfällen

Fähigkeiten, die auf den Agententyp Incident Triage zugeschnitten sind, können Kriterien für das automatische Überspringen von Incidents definieren. Verwenden Sie diese Option, um Vorfälle zu filtern, die keiner Untersuchung bedürfen. Wenn ein neuer Vorfall den Kriterien zum Überspringen entspricht, markiert der AWS DevOps Agent ihn als Übersprungen. Das System gibt einen Grund an, aus dem erklärt wird, warum es gefiltert wurde.

Das folgende Beispiel zeigt einen Skill, der Vorfälle mit niedriger Priorität während einer geplanten Wartung überspringt:

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.

Wenn Sie diesen Skill erstellen, wählen Sie Incident Triage als Agententyp aus. Dadurch wird sichergestellt, dass der Skill nur während der Triage-Phase bewertet wird.

Fähigkeiten erstellen

Bevor Sie Fähigkeiten erstellen können, benötigen Sie einen Agentenbereich. 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:

Informationen zur programmgesteuerten Verwaltung von Fähigkeiten über die AWS CLI oder AWS SDKs finden Sie unter. Verwaltung von Komponenten

Einen Skill in der Benutzeroberfläche erstellen

In der AWS DevOps Agent Operator Web App erstellte Skills 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

Als Zip-Dateien hochgeladene Fähigkeiten enthalten eine SKILL.md Datei sowie zusätzliche Ressourcen wie Referenzmaterialien 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

SKILL.md Anforderungen an das Thema:

Fähigkeiten, die als ZIP-Dateien hochgeladen werden, müssen die Felder „ SKILL.md Mit“ name und description „Titelmaterial“ enthalten. AWS DevOps Der Agent bestimmt anhand dieser Felder, wann der Skill aktiviert werden muss. Einzelheiten zum Schreiben eines effektiven Titelthemas finden Sie im Abschnitt Titelthema weiter oben in diesem Thema.

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

Um einen Skill per Zip-Upload zu erstellen:

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

Bewährte Methoden für die Benennung von Fähigkeiten:

Verwenden Sie klare, aussagekräftige Namen wie „rds-throttling-investigation“ statt generischer Namen. Ein guter Skillname spiegelt das spezifische Szenario oder den Service wider, auf den er sich bezieht, und macht es einfacher, den richtigen Skill auf einen Blick zu identifizieren.

Einen Skill aus einem Repository importieren

Sie können Skills direkt aus einem GitHub Repository-Verzeichnis importieren. AWS DevOps Der Agent ruft den Skill-Inhalt aus dem Repository ab, extrahiert den Namen und die Beschreibung aus der SKILL.md Titelseite und erstellt den Skill in Ihrem Agentenbereich. Auf diese Weise können Sie Skills in der Versionskontrolle verwalten und sie mit einer einzigen Aktion importieren.

Voraussetzungen:

Struktur des Repositorys:

Das Repository-Verzeichnis, das Sie importieren, muss der Standard-Skill-Struktur folgen:

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

Um einen Skill aus einem Repository zu importieren:

AWS DevOps Der Agent ruft den Inhalt des Verzeichnisses ab, liest die SKILL.md Titelseite, um den Namen und die Beschreibung des Skills zu extrahieren, und importiert alle Dateien in Ihren Agentenbereich.

Importierte Fähigkeiten anzeigen:

Importierte Fähigkeiten werden in der Liste der benutzerdefinierten Fähigkeiten mit einem Link zum Quell-Repository angezeigt. In der Skill-Detailansicht:

Synchronisieren importierter Fähigkeiten:

Wenn du die Skill-Dateien in deinem Repository aktualisierst, kannst du den importierten Skill synchronisieren, um die neuesten Änderungen abzurufen:

Sie können auch von der Ansicht der Skills-Liste aus synchronisieren, indem Sie in der Zeile mit den importierten Fähigkeiten auf Synchronisieren klicken.

Einschränkungen:

Werkzeuge der Gemeinschaft

Das AWS DevOps Agent Tools-Repository auf der GitHub Website enthält von der Community bereitgestellte Skills, benutzerdefinierte Agenten und MCP-Server, die Sie unverändert oder als Ausgangspunkt für das Schreiben Ihrer eigenen verwenden können. Das Repository wird vom Agent-Serviceteam verwaltet. AWS DevOps Alle Beiträge durchlaufen dieselbe Sicherheitsüberprüfungsleiste, bevor sie hinzugefügt werden. So erhalten Sie schnell Zugriff auf neue Funktionen und können sicher sein, dass jedes Tool den AWS Qualitätsstandards entspricht. In der Community Skills-Galerie auf der GitHub Website finden Sie Informationen zu den verfügbaren Inhalten.

Zu den verfügbaren Fähigkeiten gehören:

Um einen Community-Skill zu verwenden:

Jeder Skill enthält eine README-Datei mit Voraussetzungen und Nutzungshinweisen.

Das Repository enthält auch benutzerdefinierte Community-Agenten und bereitstellbare MCP-Server. Einzelheiten finden Sie unter Community Custom Agents und Community MCP-Server.

Verwalten von Qualifikationen

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

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

Fähigkeiten anzeigen — Wählen Sie einen Skill aus, um dessen Detailansicht zu sehen. In der Benutzeroberfläche erstellte Skills zeigen bearbeitbare Inhalte an, in denen Sie den Namen, die Beschreibung oder die Anweisungen direkt in der Benutzeroberfläche ändern und zum Aktualisieren auf „Speichern“ klicken können. Für Skills, die als Zip-Dateien hochgeladen wurden, wird ein Dateibaum angezeigt, in dem alle zusätzlichen Verzeichnisse wie references/ SKILL.md und assets/ angezeigt werden. Wählen Sie Dateien in der Baumstruktur aus, um deren Inhalt im schreibgeschützten Modus anzuzeigen.

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

Skills aktivieren und deaktivieren — Skills vorübergehend deaktivieren, ohne sie mit dem Active/Inactive Schalter zu löschen. Öffnen Sie die Detailansicht des Skills und stellen Sie den Schalter auf „Inaktiv“, um zu verhindern, dass der Agent den Skill für neue Untersuchungen lädt, während alle Inhalte und Konfigurationen erhalten bleiben. In-progress Bei Untersuchungen wird der Skill weiterhin verwendet. Schalten Sie zurück auf „Aktiv“, um den Skill sofort wieder verfügbar zu machen. Informationen zum programmgesteuerten Aktivieren oder Deaktivieren von Skills finden Sie unter Aktivieren und Deaktivieren von Skills auf der Seite „Ressourcen verwalten“.

Fähigkeiten aktualisieren — Ändern Sie vorhandene Fähigkeiten auf der Grundlage der Art und Weise, wie sie erstellt wurden. Wählen Sie für Skills, die in der Benutzeroberfläche erstellt wurden, in der Skill-Detailansicht „Bearbeiten“, ändern Sie den Namen, die Beschreibung oder die Anweisungen und wählen Sie „Speichern“, um sie zu aktualisieren. 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.

Fähigkeiten löschen — Fertigkeiten dauerhaft aus Ihrem Agentenbereich entfernen. Öffnen Sie die Ansicht der Skillliste, wählen Sie das Menü mit weiteren Optionen (◇) und wählen Sie „Löschen“. Lesen Sie sich die Warnung vor dem dauerhaften Löschen durch, geben Sie zur Bestätigung den Namen des Skills ein und wählen Sie „Skill löschen“. Das Löschen kann nicht rückgängig gemacht werden. In-progress Untersuchungen können beeinträchtigt werden, wenn sie versuchen, den gelöschten Skill zu laden. Laden Sie bei Skills, die als Zip-Dateien hochgeladen wurden, 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 möglicherweise erneut benötigen.

Migration von Runbooks

Bestehende Runbooks werden automatisch zu Skills migriert, ohne dass ein Eingreifen des Kunden erforderlich ist. Wenn Ihr Agentenbereich auf das Skills-Modell umgestellt wird, werden alle Runbooks in Skills umgewandelt und in Ihrer Skills-Benutzeroberfläche angezeigt. 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.