Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

DevOps Keterampilan Agen

AWS DevOps Keterampilan Agen adalah set instruksi modular yang memperluas kemampuan agen dengan pengetahuan domain khusus dan metodologi investigasi yang disesuaikan dengan infrastruktur dan alur kerja operasional Anda.

Apa itu Keterampilan

Keterampilan adalah direktori mandiri yang berisi instruksi Markdown yang memberikan kemampuan khusus untuk AWS DevOps Agen. AWS DevOps Agen mendukung subset spesifikasi Keterampilan Agen — standar terbuka untuk instruksi dan sumber daya agen pengemasan — hanya mendukung dokumen yang tidak dapat dieksekusi: instruksi Markdown, PDF, gambar, dan file data.

Setiap keterampilan membutuhkan SKILL.md file yang berisi instruksi yang ingin Anda berikan untuk AWS DevOps Agen Anda. Selain SKILL.md file yang diperlukan, keterampilan dapat mencakup:

Mengapa menggunakan Skills

Keterampilan mengubah AWS DevOps Agen dari asisten tujuan umum menjadi spesialis untuk infrastruktur dan alur kerja operasional Anda. Tidak seperti instruksi satu kali yang disediakan dalam pesan obrolan, Skills adalah kemampuan yang dapat digunakan kembali yang dimuat secara otomatis ketika relevan dengan tugas yang dilakukan oleh AWS DevOps Agen.

Manfaat utama:

Bagaimana Keterampilan bekerja

Ketika AWS DevOps Agen menemukan tugas yang relevan, ia memuat keterampilan yang sesuai dan mengikuti instruksi untuk memandu penyelidikannya. Misalnya, keterampilan “Investigasi Kinerja Database” mungkin mencakup prosedur langkah demi langkah untuk menganalisis masalah pelambatan RDS, memungkinkan agen memeriksa status alarm secara sistematis, menganalisis metrik koneksi, dan mengidentifikasi kueri yang lambat.

Struktur keterampilan

Keterampilan diatur sebagai direktori yang berisi:

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

SKILL.md

Ini SKILL.md adalah satu-satunya file wajib. Ini berisi instruksi inti yang ditulis dalam format Markdown. File ini harus:

Materi depan

Frontmatter adalah blok metadata di bagian atas SKILL.md file, tertutup di antara pembatas---. Ini berisi description bidang name dan yang digunakan AWS DevOps Agen untuk menentukan kapan harus mengaktifkan Skill selama penyelidikan atau tugas.

---
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 — Pengidentifikasi unik untuk Skill. Gunakan huruf kecil, angka, dan tanda hubung saja (maksimal 64 karakter). Tidak boleh dimulai atau diakhiri dengan tanda hubung.

deskripsi — Penjelasan terperinci tentang kapan dan mengapa AWS DevOps Agen harus menggunakan Skill ini. AWS DevOps Agen mengevaluasi bidang ini untuk memutuskan apakah Skill relevan dengan tugas saat ini. Deskripsi yang tidak jelas atau hilang dapat menyebabkan agen melewatkan Skill sepenuhnya, bahkan jika instruksinya ditulis dengan baik.

Penting — Tulis deskripsi dari perspektif agen. Sertakan skenario spesifik, layanan, jenis kesalahan, atau gejala yang seharusnya memicu Skill. Misalnya, “Gunakan keterampilan ini saat menyelidiki latensi database, kesalahan koneksi, atau batas waktu kueri untuk instans Amazon RDS” lebih efektif daripada “keterampilan RDS”.

Saat Anda membuat Skill di UI, sistem menghasilkan frontmatter secara otomatis dari nama dan deskripsi yang Anda berikan. Keterampilan yang diunggah sebagai file zip harus menyertakan frontmatter dalam SKILL.md file.

Contoh: Keterampilan lengkap

Contoh berikut menunjukkan keterampilan yang lengkap dan terbentuk dengan baik untuk menyelidiki masalah kinerja RDS. Ini menunjukkan struktur direktori, SKILL.md materi depan, prosedur investigasi yang dapat ditindaklanjuti, dan file referensi tambahan.

Struktur direktori:

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

Contoh: Keterampilan penyaringan insiden

Keterampilan yang ditargetkan untuk jenis agen Triage Insiden dapat menentukan kriteria untuk melewatkan insiden secara otomatis. Gunakan ini untuk menyaring insiden yang tidak memerlukan penyelidikan. Ketika insiden baru cocok dengan kriteria lewati, AWS DevOps Agen menandainya sebagai Dile wati. Sistem memberikan alasan yang menjelaskan mengapa itu disaring.

Contoh berikut menunjukkan keterampilan yang melewatkan insiden prioritas rendah selama pemeliharaan terjadwal:

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.

Saat Anda membuat skill ini, pilih Incident Triage sebagai jenis agen. Ini memastikan keterampilan hanya dievaluasi selama fase triase.

Menciptakan Keterampilan

Sebelum membuat keterampilan, Anda harus memiliki Ruang Agen. Untuk informasi selengkapnya, lihat Membuat Ruang Agen.

Anda dapat membuat keterampilan dalam dua cara tergantung pada preferensi alur kerja dan kompleksitas keterampilan Anda:

Untuk mengelola keterampilan secara terprogram melalui AWS CLI atau AWS SDK, lihat. Mengelola aset

Membuat keterampilan di UI

Keterampilan yang dibuat di Aplikasi Web Operator AWS DevOps Agen berisi nama, deskripsi, dan instruksi dalam satu SKILL.md file.

Untuk membuat keterampilan di UI:

Sistem secara otomatis menghasilkan SKILL.md file dengan struktur frontmatter yang tepat.

Untuk mengedit skill yang dibuat di UI:

Mengunggah keterampilan

Keterampilan yang diunggah sebagai SKILL.md file zip berisi file ditambah sumber daya tambahan seperti bahan referensi atau aset.

Struktur keterampilan:

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 persyaratan frontmatter:

Keterampilan yang diunggah sebagai file zip harus menyertakan frontmatter di description bidang SKILL.md with name and. AWS DevOps Agen menggunakan bidang ini untuk menentukan kapan harus mengaktifkan Skill. Untuk detail tentang penulisan frontmatter yang efektif, lihat bagian Frontmatter sebelumnya dalam topik ini.

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

Untuk membuat keterampilan melalui unggahan zip:

Pembatasan penting untuk keterampilan yang diunggah sebagai file zip:

Praktik terbaik untuk keterampilan penamaan:

Gunakan nama deskriptif yang jelas seperti “rds-throttling-investigasi” daripada nama generik. Nama keterampilan yang baik mencerminkan skenario atau layanan spesifik yang ditangani, sehingga lebih mudah untuk mengidentifikasi keterampilan yang tepat secara sekilas.

Mengimpor keterampilan dari repositori

Anda dapat mengimpor keterampilan langsung dari direktori GitHub repositori. AWS DevOps Agen mengambil konten keterampilan dari repositori, mengekstrak nama dan deskripsi dari SKILL.md materi depan, dan menciptakan keterampilan di Ruang Agen Anda. Ini memungkinkan Anda untuk mengelola keterampilan dalam kontrol versi dan mengimpornya dengan satu tindakan.

Prasyarat:

Struktur repositori:

Direktori repositori yang Anda impor harus mengikuti struktur keterampilan standar:

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

Untuk mengimpor keterampilan dari repositori:

AWS DevOps Agen mengambil isi direktori, membaca SKILL.md frontmatter untuk mengekstrak nama dan deskripsi keterampilan, dan mengimpor semua file ke Ruang Agen Anda.

Melihat keterampilan yang diimpor:

Keterampilan yang diimpor muncul di daftar Keterampilan Kustom dengan tautan ke repositori sumber. Dalam tampilan detail keterampilan:

Menyinkronkan keterampilan yang diimpor:

Saat Anda memperbarui file keterampilan di repositori Anda, Anda dapat menyinkronkan keterampilan yang diimpor untuk menarik perubahan terbaru:

Anda juga dapat menyinkronkan dari tampilan daftar keterampilan dengan memilih Sin kronisasi pada baris keterampilan yang diimpor.

Kendala:

Alat komunitas

Repositori Alat AWS DevOps Agen di GitHub situs web berisi keterampilan yang disumbangkan komunitas, agen khusus, dan server MCP yang dapat Anda gunakan apa adanya atau sebagai titik awal untuk menulis sendiri. Repositori dikelola oleh tim layanan AWS DevOps Agen. Semua kontribusi melewati bilah peninjauan keamanan yang sama sebelum ditambahkan, sehingga Anda mendapatkan pengiriman cepat kemampuan baru dengan jaminan bahwa setiap alat memenuhi standar AWS kualitas. Untuk menelusuri apa yang tersedia, lihat galeri keterampilan komunitas di GitHub situs web.

Keterampilan yang tersedia meliputi:

Untuk menggunakan keterampilan komunitas:

Setiap keterampilan mencakup README dengan prasyarat dan instruksi penggunaan.

Repositori juga mencakup agen kustom komunitas dan server MCP yang dapat digunakan. Untuk detailnya, lihat A gen kustom komunitas dan server MCP Komunitas.

Keterampilan Mengelola

AWS DevOps Agen menyediakan kemampuan manajemen keterampilan yang komprehensif melalui Aplikasi Web Operator:

Keterampilan daftar — Lihat semua Keterampilan di Ruang Agen Anda. Tab Keter ampilan halaman Pengetahuan menampilkan nama keterampilan, status Aktif atau Tidak Aktif, tanggal pembuatan, tanggal pembaruan terakhir, dan tindakan yang tersedia.

Keterampilan melihat — Pilih keterampilan apa pun untuk melihat tampilan detailnya. Keterampilan yang dibuat di UI menampilkan konten yang dapat diedit di mana Anda dapat mengubah nama, deskripsi, atau instruksi langsung di UI dan memilih “Simpan” untuk memperbarui. Keterampilan yang diunggah sebagai file zip menampilkan pohon file yang SKILL.md ditampilkan dan direktori tambahan seperti referensi/ dan aset/. Pilih file di pohon untuk melihat isinya dalam mode read-only.

Memilih agen untuk keterampilan — Konfigurasikan jenis agen mana yang dapat menggunakan setiap keterampilan saat membuat atau mengeditnya. Di dropdown Jenis Agen, pilih satu atau beberapa jenis agen menggunakan kotak centang: Gen erik (default — berlaku untuk semua jenis agen), (kueri percakapan), Triage Insiden On-demand (penilaian insiden awal), RCA Insiden (analisis akar penyebab), Mitigasi Insiden (respons insiden otomatis), atau Evalu asi (rekomendasi proaktif). Generik dipilih secara default dan membuat keterampilan tersedia untuk semua jenis agen. Keterampilan yang ditargetkan untuk agen tertentu mengurangi konsumsi konteks dan meningkatkan fokus agen.

Mengaktifkan dan menonaktifkan keterampilan - Nonaktifkan keterampilan sementara tanpa menghapusnya menggunakan sakelar Active/Inactive . Buka tampilan detail keterampilan dan alihkan sakelar ke “Tidak Aktif” untuk mencegah agen memuatnya untuk penyelidikan baru sambil mempertahankan semua konten dan konfigurasi. In-progress Investigasi terus menggunakan keterampilan. Beralih kembali ke “Aktif” untuk membuat keterampilan segera tersedia lagi. Untuk mengaktifkan atau menonaktifkan keterampilan secara terprogram, lihat Mengaktifkan dan menonaktifkan keterampilan di halaman Mengelola Aset.

Memperbarui keterampilan - Memodifikasi keterampilan yang ada berdasarkan bagaimana mereka diciptakan. Untuk keterampilan yang dibuat di UI, pilih “Edit” di tampilan detail keterampilan, ubah nama, deskripsi, atau instruksi, dan pilih “Simpan” untuk memperbarui. Untuk keterampilan yang diunggah sebagai file zip, ubah file secara lokal, buat file zip baru, dan unggah versi baru.

Menghapus keterampilan — Hapus keterampilan secara permanen dari Ruang Agen Anda. Buka tampilan daftar keterampilan, pilih menu opsi lainnya () dan pilih “Hapus,” tinjau peringatan tentang penghapusan permanen, ketik nama keterampilan untuk mengonfirmasi, dan pilih “Hapus Keterampilan.” Penghapusan tidak dapat dibatalkan. In-progress investigasi dapat terpengaruh jika mereka mencoba memuat keterampilan yang dihapus. Untuk keterampilan yang diunggah sebagai file zip, unduh file zip sebelum menghapus sebagai cadangan. Pertimbangkan untuk menonaktifkan keterampilan alih-alih menghapusnya jika Anda mungkin membutuhkannya lagi.

Migrasi dari Runbook

Runbook yang ada secara otomatis dimigrasikan ke Skills tanpa memerlukan tindakan pelanggan. Saat Ruang Agen Anda beralih ke model Keterampilan, semua Runbook diubah menjadi Skills dan muncul di UI Keterampilan Anda. Setelah migrasi, Anda dapat:

Hubun AWS gi Dukungan jika Anda mengalami masalah dengan Keterampilan yang dimigrasi secara otomatis atau memerlukan bantuan dengan pembaruan pasca-migrasi.