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](https://agentskills.io/) — standar terbuka untuk instruksi dan sumber daya agen pengemasan — hanya mendukung dokumen yang tidak dapat dieksekusi: Instruksi penurunan harga, gambar, dan file data. PDFs
Setiap keterampilan membutuhkan file Skill.md yang berisi instruksi yang ingin Anda berikan untuk Agen Anda. AWS DevOps Selain file Skill.md yang diperlukan, keterampilan dapat mencakup:
+ **Alur kerja investigasi** untuk skenario atau jenis infrastruktur tertentu.
+ **Bahan referensi** termasuk pola arsitektur dan prosedur operasional.
+ **Penargetan tipe agen** — Keterampilan dapat ditargetkan ke jenis agen tertentu (Generik, Sesuai Permintaan, Triase Insiden, RCA Insiden, Mitigasi Insiden, Evaluasi) untuk mengurangi konsumsi konteks dan meningkatkan fokus agen.
## 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:**
+ **Spesialisasi agen Anda — Agen** Penjahit AWS DevOps dengan prosedur investigasi, praktik terbaik, dan pengetahuan organisasi khusus untuk infrastruktur dan pola operasional Anda.
+ **Kurangi pengulangan** — Buat alur kerja investigasi sekali dan AWS DevOps Agen menggunakannya secara otomatis di semua investigasi yang relevan, sehingga tidak perlu memberikan panduan yang sama berulang kali.
+ **Kemampuan menulis** — Gabungkan beberapa Keterampilan untuk membangun alur kerja end-to-end investigasi. AWS DevOps Agen membaca beberapa keterampilan selama eksekusi, seperti keterampilan untuk mengambil penerapan dari CI/CD pipeline kustom Anda dan keterampilan untuk mencari repositori kode Anda.
+ **Amplify custom tools** — Buat skill yang memandu AWS DevOps Agen dalam menggunakan alat server MCP kustom Anda secara efektif. Keterampilan dapat mendokumentasikan kapan harus menggunakan alat tertentu, parameter apa yang akan digunakan untuk skenario yang berbeda, dan bagaimana menafsirkan hasil untuk mencapai alur kerja khusus untuk infrastruktur Anda.
## 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 step-by-step prosedur 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
```
### Keterampilan.md
`SKILL.md`Ini adalah satu-satunya file wajib. Ini berisi instruksi inti yang ditulis dalam format Markdown. File ini harus:
+ Jelaskan kapan dan bagaimana menggunakan keterampilan.
+ Berikan prosedur step-by-step investigasi.
+ Sertakan pohon keputusan untuk skenario yang berbeda.
+ Dokumentasikan output yang diharapkan dan kriteria keberhasilan.
### 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 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, frontmatter Skill.md, 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
```
**Keterampilan.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
```
**referensi/ .mdrds-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% |
```
## Menciptakan Keterampilan
Sebelum membuat keterampilan, Anda harus memiliki Ruang Agen. Untuk informasi selengkapnya, lihat [Membuat Ruang Agen](getting-started-with-aws-devops-agent-creating-an-agent-space.md).
Anda dapat membuat keterampilan dalam dua cara tergantung pada preferensi alur kerja dan kompleksitas keterampilan Anda:
### Membuat keterampilan di UI
Keterampilan yang dibuat di Aplikasi Web Operator AWS DevOps Agen berisi nama, deskripsi, dan instruksi dalam satu file Skill.md.
**Untuk membuat keterampilan di UI:**
+ Arahkan ke halaman Keterampilan di Aplikasi Web Operator Ruang Agen Anda.
+ Klik “Tambahkan keterampilan”.
+ Pilih “Buat keterampilan” dari modal.
+ Isi formulir keterampilan:
+ **Nama** - Huruf kecil, angka, dan tanda hubung saja (maksimum 64 karakter). Tidak boleh memulai atau mengakhiri dengan tanda hubung. Contoh: `rds-throttling-investigation`
+ **Deskripsi** — Penjelasan singkat tentang kapan harus menggunakan keterampilan ini (disarankan minimal 100 karakter, maksimum 1.024 karakter). Ini membantu agen menentukan kapan harus mengaktifkan keterampilan.
+ **Status** - Setel ke Aktif (default) atau Tidak Aktif. Keterampilan tidak aktif tidak digunakan oleh agen.
+ **Jenis Agen** — Pilih satu atau beberapa jenis agen yang dapat menggunakan keterampilan ini. **Generik** dipilih secara default dan membuat keterampilan tersedia untuk semua jenis agen. Untuk menargetkan agen tertentu, batalkan pilihan Generik dan pilih dari: Sesuai permintaan, Triase Insiden, RCA Insiden, Mitigasi Insiden, atau Evaluasi.
+ **Instruksi** — Step-by-step prosedur dalam format Markdown. Jadilah spesifik dan dapat ditindaklanjuti.
+ Klik “Buat” untuk menyimpan keterampilan.
Sistem secara otomatis menghasilkan file Skill.md dengan struktur frontmatter yang tepat.
**Untuk mengedit keterampilan yang dibuat di UI:**
+ Arahkan ke keterampilan dalam daftar Keterampilan dan klik keterampilan untuk membukanya.
+ Klik **Edit**.
+ Ubah nama, deskripsi, atau instruksi.
+ Klik **Simpan** untuk memperbarui keterampilan.
### Mengunggah keterampilan
Keterampilan yang diunggah sebagai file zip berisi file Skill.md 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
```
**Persyaratan frontmatter Skill.md:**
Keterampilan yang diunggah sebagai file zip harus menyertakan frontmatter di Skill.md dengan dan bidang. `name` `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:**
+ Buat direktori dengan file keahlian Anda mengikuti struktur di atas.
+ Pastikan Skill.md menyertakan frontmatter yang tepat (nama dan deskripsi).
+ Kompres direktori menjadi file.zip.
+ Arahkan ke halaman Keterampilan di Aplikasi Web Operator Ruang Agen Anda.
+ Klik “Tambahkan keterampilan”.
+ Pilih “Unggah keterampilan” dari modal.
+ Seret dan lepas file.zip Anda atau klik untuk menelusuri (hanya file ZIP, maksimum 6 MB).
+ Pilih satu atau beberapa jenis agen yang dapat menggunakan keterampilan ini (Generik dipilih secara default dan berlaku untuk semua jenis agen; batalkan pilihan untuk menargetkan On-Demand, Triage Incident, Incident RCA, Incident Mitigation, atau Evaluation secara khusus).
+ Tinjau persyaratan file zip dan hasil validasi.
+ Klik “Unggah” untuk menambahkan keterampilan ke Ruang Agen Anda.
**Pembatasan penting untuk keterampilan yang diunggah sebagai file zip:**
+ **Skrip saat ini tidak didukung** - Keterampilan yang berisi skrip di `scripts/` direktori akan ditolak selama pengunggahan. Eksekusi skrip akan diaktifkan dalam rilis masa depan setelah agen memiliki akses ke lingkungan pengkodean yang aman.
+ **Batas ukuran** - Total ukuran file zip tidak boleh melebihi 6 MB (termasuk semua file).
+ **Skill.md diperlukan** - File zip harus berisi file Skill.md dengan frontmatter yang valid.
**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.
## Keterampilan Mengelola
AWS DevOps Agen menyediakan kemampuan manajemen keterampilan yang komprehensif melalui Aplikasi Web Operator:
**Keterampilan daftar** — Lihat semua Keterampilan di Ruang Agen Anda. Halaman Keterampilan menampilkan nama keterampilan, status Aktif atau Tidak Aktif, tanggal pembuatan, tanggal pembaruan terakhir, dan tindakan yang tersedia.
**Keterampilan melihat** — Klik pada 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 klik “Simpan” untuk memperbarui. Keterampilan yang diunggah sebagai file zip menampilkan pohon file yang menunjukkan Skill.md dan direktori tambahan seperti referensi/dan aset/. Klik 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), **Sesuai permintaan** (kueri percakapan), **Triase Insiden (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. Investigasi yang sedang berlangsung terus menggunakan keterampilan. Beralih kembali ke “Aktif” untuk membuat keterampilan segera tersedia lagi.
**Memperbarui keterampilan** - Memodifikasi keterampilan yang ada berdasarkan bagaimana mereka diciptakan. Untuk keterampilan yang dibuat di UI, klik “Edit” di tampilan detail keterampilan, ubah nama, deskripsi, atau instruksi, dan klik “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, klik menu opsi lainnya () dan pilih “Hapus,” tinjau peringatan tentang penghapusan permanen, ketik nama keterampilan untuk mengonfirmasi, dan klik “Hapus Keterampilan.” Penghapusan tidak dapat dibatalkan. Investigasi yang sedang berlangsung 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:
+ **Tinjau Keterampilan yang dimigrasi** — Periksa apakah migrasi otomatis mengonversi Runbook Anda dengan benar.
+ **Perbarui sesuai kebutuhan** — Edit Keterampilan langsung di UI untuk menyempurnakan instruksi, memperbarui deskripsi, atau mengonfigurasi penargetan jenis agen.
+ **Perluas dengan referensi** — Untuk Keterampilan yang akan mendapat manfaat dari bahan referensi tambahan atau diagram arsitektur, buat ulang sebagai keterampilan unggah zip dengan direktori referensi/atau aset/.
+ **Buat Keterampilan baru** — Tambahkan Keterampilan baru untuk alur kerja investigasi yang sebelumnya tidak tercakup oleh Runbook.
Hubungi AWS Support jika Anda mengalami masalah dengan Keterampilan yang dimigrasi secara otomatis atau memerlukan bantuan terkait pembaruan pasca-migrasi.