Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat agen kustom
Anda dapat membuat agen kustom dengan dua cara: menggunakan formulir di aplikasi web DevOps Agen, atau melalui percakapan terpandu di Obrolan. Kedua metode menghasilkan konfigurasi agen kustom yang sama yang disimpan di Ruang Agen Anda.
Sebelum membuat agen kustom, Anda harus memiliki Ruang Agen dengan setidaknya satu integrasi yang terhubung. Untuk informasi selengkapnya, lihat [Membuat Ruang Agen](getting-started-with-aws-devops-agent-creating-an-agent-space.md).
## Membuat agen kustom menggunakan formulir
Formulir ini memungkinkan Anda dengan cepat membuat agen kustom dengan menentukan nama, prompt sistem, dan keterampilan opsional. Untuk menetapkan alat MCP ke agen, gunakan Chat setelah membuat agen.
**Untuk membuat agen kustom menggunakan formulir:**
1. Arahkan ke halaman **Agen** di aplikasi web DevOps Agen Anda.
1. Di bagian **Agen Kustom**, pilih **Buat agen**.
1. Dalam dialog, pilih **Formulir**.
1. Isi formulir:
+ **Nama** — Pengenal unik untuk agen Anda. Gunakan huruf kecil, angka, dan tanda hubung saja (maksimum 64 karakter). Tidak boleh memulai atau mengakhiri dengan tanda hubung. Contoh: `weekly-health-report`
+ **Prompt sistem** — Instruksi yang menentukan apa yang dilakukan agen dan bagaimana operasinya, ditulis dalam Markdown (minimal 10 karakter, maksimum 50.000 karakter). Untuk panduan tentang menulis petunjuk yang efektif, lihat [Menulis prompt sistem](#writing-a-system-prompt).
+ **Keterampilan** (opsional) — Pilih keterampilan dari Ruang Agen Anda yang memberikan pengetahuan atau kemampuan domain tambahan kepada agen. Gunakan bidang pencarian untuk menemukan keterampilan berdasarkan nama.
1. Pilih **Buat agen**.
Setelah pembuatan, Anda diarahkan ke halaman detail agen tempat Anda dapat melihat konfigurasi, menjalankan agen, atau mengatur pemicu.
## Membuat agen kustom menggunakan Obrolan
Obrolan memberikan pengalaman percakapan yang dipandu untuk membuat agen khusus. Metode ini direkomendasikan ketika Anda ingin menetapkan alat MCP ke agen, atau ketika Anda ingin bantuan menulis prompt sistem.
**Untuk membuat agen kustom menggunakan Chat:**
1. Arahkan ke halaman **Agen** di aplikasi web DevOps Agen Anda.
1. Di bagian **Agen Kustom**, pilih **Buat agen**.
1. Dalam dialog, pilih **Obrolan**. Dialog ditutup dan percakapan baru terbuka di panel Obrolan dengan pesan yang telah disusun sebelumnya.
1. Obrolan memandu Anda melalui proses kolaboratif:
+ **Klarifikasi maksud** — Mengonfirmasi tujuan dan ruang lingkup agen Anda.
+ **Pemeriksaan duplikat** — Memverifikasi tidak ada agen serupa yang sudah ada di Ruang Agen Anda.
+ **Pemilihan alat dan keterampilan** - Mengusulkan alat dan keterampilan MCP mana yang dibutuhkan agen, dan meminta Anda untuk mengonfirmasi.
+ **Jenis keluaran** — Menentukan apakah agen harus menghasilkan respons teks, artefak, atau rekomendasi.
+ **Draf prompt sistem** — Menulis prompt sistem dan menyajikannya untuk ulasan Anda. Anda dapat mengulangi sampai Anda puas.
+ **Konfirmasi** — Menyarankan nama dan mengonfirmasi semua pengaturan sebelum membuat agen.
Anda juga dapat membuat agen kustom dengan meminta Chat langsung kapan saja. Contoh:
```
Create an agent that generates a weekly report of all investigations from the past week.
```
```
Create a custom agent for checking certificate expiration across all accounts.
```
```
Make me an agent that audits DynamoDB table configurations daily.
```
## Menulis prompt sistem
Prompt sistem adalah bagian terpenting dari agen kustom Anda. Ini mendefinisikan tujuan agen, pendekatan, kendala, dan output yang diharapkan. Prompt yang ditulis dengan baik menghasilkan hasil yang konsisten dan andal.
**Struktur prompt sistem Anda dengan bagian-bagian ini:**
+ **Tujuan** — Apa yang harus dicapai agen dalam satu kalimat atau paragraf pendek.
+ **Pendekatan** — Step-by-step prosedur yang harus diikuti agen, merujuk nama alat tertentu yang harus dipanggil dan dalam urutan apa.
+ **Kendala — Batas** pada apa yang harus dan tidak boleh dilakukan agen. Misalnya, akses hanya-baca, rentang waktu yang perlu dipertimbangkan, atau layanan yang akan dikecualikan.
+ **Output** — Apa yang harus diproduksi agen dan dalam format apa. Tentukan apakah itu harus menghasilkan teks, membuat artefak, atau membuat rekomendasi.
**Contoh prompt sistem:**
```
You are a DevOps reporting agent specializing in summarizing investigation activity.
## Goal
Generate a concise weekly report of all investigations from the past 7 days.
## Approach
1. Call `list_investigations` to fetch investigations from the last 7 days.
2. For each investigation, retrieve its title, status, root cause, and resolution time.
3. Group investigations by status and root cause category.
4. Identify trends: services most affected, average resolution time, recurring root causes.
## Constraints
- Only include investigations from the past 7 days.
- Read-only access — do not modify, close, or reassign investigations.
## Output
Produce a single artifact titled "Weekly Investigation Report" containing:
- A table listing each investigation with title, status, and resolution time.
- A chart showing investigation counts by root cause category.
- A summary paragraph with key trends and recommendations.
```
**Kiat untuk petunjuk sistem yang efektif:**
+ **Jadilah spesifik tentang alat** — Nama alat referensi secara langsung (misalnya,`list_investigations`,`use_aws`,`query_cloudwatch_logs`) sehingga agen tahu alat mana yang harus dihubungi.
+ **Tentukan kriteria keberhasilan** — Jelaskan seperti apa output yang bagus sehingga agen tahu kapan itu selesai.
+ **Tetapkan batas** — Nyatakan secara eksplisit apa yang tidak boleh dilakukan agen untuk mencegah tindakan yang tidak diinginkan.
+ **Gunakan format Markdown** - Header, daftar, dan blok kode membuat prompt lebih mudah bagi agen untuk mengurai dan mengikuti.
## Mengkonfigurasi alat
Alat MCP menentukan tindakan apa yang dapat dilakukan agen kustom Anda selama pemanggilan. Anda memilih alat dari set lengkap yang tersedia di Ruang Agen Anda, termasuk alat dari AWS akun yang terhubung, platform observabilitas, CI/CD saluran pipa, sistem tiket, dan server MCP kustom.
Alat hanya dapat dikonfigurasi melalui Obrolan. Untuk menetapkan alat saat membuat agen, gunakan metode pembuatan obrolan. Untuk menambah atau mengubah alat pada agen yang ada, minta Chat untuk memperbarui agen. Contoh:
```
Add the query_cloudwatch_logs and use_aws tools to my weekly-health-report agent.
```
```
Update certificate-checker to also use the list_resources tool.
```
```
Remove the use_kubectl tool from cluster-audit-agent.
```
Saat memilih alat, ikuti prinsip hak istimewa paling sedikit — tetapkan hanya alat yang dibutuhkan agen untuk menyelesaikan tugasnya. Ini mengurangi risiko tindakan yang tidak diinginkan dan membuat agen tetap fokus.
## Mengkonfigurasi keterampilan
Keterampilan memberi agen kustom Anda pengetahuan domain tambahan, prosedur investigasi, atau kemampuan khusus. Ketika agen kustom berjalan, ia memuat keterampilan yang ditetapkan dan dapat mereferensikan instruksi mereka selama pemanggilan.
Anda dapat menetapkan keterampilan selama pembuatan (menggunakan formulir atau Obrolan) atau menambahkannya nanti dengan mengedit agen. Keterampilan yang diberikan kepada agen kustom harus sudah ada di Ruang Agen Anda. Untuk informasi lebih lanjut tentang membuat keterampilan, lihat[DevOps Keterampilan Agen](about-aws-devops-agent-devops-agent-skills.md).
Agen khusus juga memiliki kemampuan bawaan untuk membuat artefak dan rekomendasi yang tidak memerlukan penugasan keterampilan. Untuk informasi selengkapnya, lihat [Output agen kustom](custom-agents-custom-agent-outputs.md).
Anda dapat menetapkan hingga 200 keterampilan per agen khusus. Pilih keterampilan yang relevan dengan tujuan agen untuk mengurangi konsumsi konteks dan meningkatkan fokus agen.