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 kepada Agen. AWS DevOps 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 penurunan harga, 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 Keterampilan

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, Keterampilan adalah kemampuan yang dapat digunakan kembali yang dimuat secara otomatis bila 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 Basis Data” mungkin mencakup prosedur langkah demi langkah untuk menganalisis masalah pelambatan RDS, memungkinkan agen untuk secara sistematis memeriksa status alarm, menganalisis metrik koneksi, dan mengidentifikasi kueri 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

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

Frontmatter

Frontmatter adalah blok metadata di bagian atas SKILL.md file, tertutup di antara pembatas. --- Ini berisi name dan description bidang yang digunakan AWS DevOps Agen untuk menentukan kapan harus mengaktifkan Keterampilan 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.
---

nama — Pengidentifikasi unik untuk Skill. Gunakan huruf kecil, angka, dan tanda hubung saja (maksimum 64 karakter). Tidak boleh memulai atau mengakhiri dengan tanda hubung.

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

Penting — Tulis deskripsi dari perspektif agen. Sertakan skenario, layanan, jenis kesalahan, atau gejala tertentu yang seharusnya memicu Keterampilan. 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 akan menghasilkan frontmatter secara otomatis dari nama dan deskripsi yang Anda berikan. Keterampilan yang diunggah sebagai file zip harus menyertakan frontmatter dalam file. SKILL.md

Contoh: Keterampilan lengkap

Contoh berikut menunjukkan keterampilan yang lengkap dan terbentuk dengan baik untuk menyelidiki masalah kinerja RDS. Ini menunjukkan struktur direktori, SKILL.md frontmatter, 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-referensi.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 Incident 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 Dilewati. 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 tipe 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 keterampilan yang dibuat di UI:

Mengunggah keterampilan

Keterampilan yang diunggah sebagai file zip berisi SKILL.md 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 SKILL.md with name dan field. description AWS DevOps Agen menggunakan bidang ini untuk menentukan kapan harus mengaktifkan Skill. Untuk detail tentang menulis 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 yang jelas dan deskriptif seperti “rds-throttling-investigation” daripada nama generik. Nama keterampilan yang baik mencerminkan skenario atau layanan spesifik yang dialaminya, 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 frontmatter, 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 konten direktori, membaca SKILL.md frontmatter untuk mengekstrak nama keterampilan dan deskripsi, 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 memperbarui file keterampilan di repositori, Anda dapat menyinkronkan keterampilan yang diimpor untuk menarik perubahan terbaru:

Anda juga dapat menyinkronkan dari tampilan daftar keterampilan dengan mengklik tombol Sinkronisasi pada baris keterampilan yang diimpor.

Kendala:

Keterampilan sampel

Repositori Keterampilan GitHub berisi DevOps keterampilan yang disumbangkan komunitas yang dapat Anda gunakan apa adanya atau sebagai titik awal untuk menulis keterampilan Anda sendiri. Sampel yang tersedia termasuk keterampilan untuk investigasi acara AWS Kesehatan, analisis kasus AWS Support, tinjauan operasional EKS, dan tinjauan operasional RDS. Untuk menelusuri keterampilan yang tersedia, lihat galeri keterampilan komunitas.

Untuk menggunakan keterampilan sampel:

Setiap keterampilan mencakup README dengan prasyarat dan instruksi penggunaan.

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 Keterampilan halaman Pengetahuan menampilkan nama keterampilan, status Aktif atau Tidak Aktif, tanggal pembuatan, tanggal terakhir diperbarui, dan tindakan yang tersedia.

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

Memilih agen untuk keterampilan — Konfigurasikan jenis agen mana yang dapat menggunakan setiap keterampilan saat membuat atau mengeditnya. Di menu tarik-turun Jenis Agen, pilih satu atau beberapa jenis agen menggunakan kotak centang: Generik (default — berlaku untuk semua jenis agen), (kueri percakapan), Triase Insiden On-demand(penilaian insiden awal), RCA Insiden (analisis akar penyebab), Mitigasi Insiden (respons insiden otomatis), atau Evaluasi (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 untuk 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 diperbarui. 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 mungkin terpengaruh jika mereka mencoba memuat keterampilan yang dihapus. Untuk keterampilan yang diunggah sebagai file zip, unduh file zip sebelum dihapus sebagai cadangan. Pertimbangkan untuk menonaktifkan keterampilan alih-alih menghapusnya jika Anda mungkin membutuhkannya lagi.

Migrasi dari Runbook

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

Hubungi AWS Support jika Anda mengalami masalah dengan Keterampilan yang dimigrasi secara otomatis atau memerlukan bantuan terkait pembaruan pasca-migrasi.