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 khusus 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.
Membuat agen kustom menggunakan formulir
Formulir ini memungkinkan Anda membuat agen kustom dengan cepat dengan menentukan nama, prompt sistem, dan keterampilan opsional. Untuk menetapkan alat MCP ke agen, gunakan Obrolan setelah membuat agen.
Untuk membuat agen kustom menggunakan formulir:
Arahkan ke halaman Agen di aplikasi web DevOps Agen Anda.
Di bagian Agen Khusus, pilih Buat agen.
Dalam dialog, pilih Formu lir.
Isi formulir:
Nama — Pengidentifikasi unik untuk agen Anda. Gunakan huruf kecil, angka, dan tanda hubung saja (maksimal 64 karakter). Tidak boleh dimulai atau diakhiri dengan tanda hubung. Contoh:
weekly-health-reportPrompt sistem — Instruksi yang menentukan apa yang dilakukan agen dan bagaimana operasinya, ditulis dalam Markdown (minimal 10 karakter, maksimum 50.000 karakter). Untuk panduan menulis petunjuk yang efektif, lihat Menulis prompt sistem.
Keter ampilan (opsional) — Pilih keterampilan dari Ruang Agen Anda yang memberikan pengetahuan atau kemampuan domain tambahan kepada agen. Gunakan bidang pencarian untuk menemukan keterampilan berdasarkan nama.
Pilih Buat agen.
Setelah pembuatan, Anda diarahkan ke halaman detail agen tempat Anda dapat melihat konfigurasi, menjalankan agen, atau mengatur pemicu.
Membuat agen khusus menggunakan Obrolan
Obrolan memberikan pengalaman percakapan yang dipandu untuk membuat agen khusus. Metode ini disarankan ketika Anda ingin menetapkan alat MCP ke agen, atau ketika Anda ingin bantuan menulis prompt sistem.
Untuk membuat agen kustom menggunakan Obrolan:
Arahkan ke halaman Agen di aplikasi web DevOps Agen Anda.
Di bagian Agen Khusus, pilih Buat agen.
Dalam dialog, pilih Obro lan. Dialog ditutup dan percakapan baru terbuka di panel Obrolan dengan pesan yang telah disusun sebelumnya.
Chat memandu Anda melalui proses kolaboratif:
Klarifikasi niat — Mengkonfirmasi 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 tinjauan Anda. Anda dapat mengulangi sampai Anda puas.
Konfirmasi — Menyarankan nama dan mengonfirmasi semua pengaturan sebelum membuat agen.
Anda juga dapat membuat agen khusus dengan meminta Chat secara 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.
Mengimpor agen kustom dari repositori
Anda dapat mengimpor prompt sistem agen kustom langsung dari file Markdown di GitHub repositori. Isi file menjadi prompt sistem agen. Anda dapat mengelola prompt agen di kontrol versi dan mengimpornya dengan satu tindakan.
Prasyarat:
GitHub Akun yang terkait dengan Ruang Agen Anda. Untuk menghubungkan GitHub akun, lihatMenghubungkan GitHub. Koneksi GitHub akun apa pun memungkinkan pengimporan dari repositori publik. Untuk repositori pribadi, akun terkait harus memiliki akses baca ke repositori. GitHub Enterprise Server dan GitHub Enterprise Cloud dengan koneksi residensi data juga didukung.
Berkas Markdown (
.md) dalam GitHub repositori yang berisi prompt sistem.
Untuk mengimpor agen kustom dari repositori:
Arahkan ke halaman Agen di aplikasi web DevOps Agen Anda.
Di bagian Agen Khusus, pilih Buat agen.
Dalam dialog, pilih Impor. Dialog berubah menjadi tampilan Impor dari GitHub.
Isi formulir:
Nama — Pengidentifikasi unik untuk agen Anda. Gunakan huruf kecil, angka, dan tanda hubung saja (maksimal 64 karakter). Tidak boleh dimulai atau diakhiri dengan tanda hubung.
URL Repositori — Tautan ke file Markdown (
.md) tunggal yang berisi prompt sistem agen. Sebagai contoh:https://github.com/my-org/my-repo/blob/main/my-agent.md. Untuk GitHub Enterprise Server atau GitHub Enterprise Cloud dengan tempat tinggal data, gunakan URL instans Anda sebagai gantinya. Sebagai contoh:https://github.example.com/my-org/my-repo/blob/main/my-agent.md. Jika URL tidak berakhir.md, peringatan akan muncul. Impor gagal jika file tersebut bukan Markdown.Keter ampilan (opsional) — Pilih keterampilan dari Ruang Agen Anda untuk memberikan pengetahuan atau kemampuan domain tambahan kepada agen.
Pilih Agen impor.
File repositori hanya menyediakan prompt sistem. Nama dan keterampilan berasal dari formulir.
Setelah pembuatan, Anda diarahkan ke halaman detail agen tempat Anda dapat melihat konfigurasi, menjalankan agen, atau mengatur pemicu.
Melihat agen yang diimpor:
Agen yang diimpor menampilkan GitHub lencana Sinkronisasi dari di sebelah namanya di halaman detail agen, bersama dengan stempel waktu terakhir yang disin kronkan dan tautan ke file sumber aktif. GitHub Dalam daftar A gen Khusus, agen yang diimpor menyertakan tautan ke file sumbernya.
Jika Anda mengedit agen yang diimpor, prompt sistem menampilkan Read-only label dengan petunjuk yang menghubungkan ke file sumber. Nama dan keterampilan tetap dapat diedit.
Menyinkronkan agen yang diimpor:
Saat Anda memperbarui file Markdown di repositori Anda, buka halaman detail agen yang diimpor dan pilih Sin kronisasi untuk menarik prompt sistem terbaru.
Kendala:
Format URL — Hanya GitHub URL yang diterima, termasuk GitHub Enterprise Server dan GitHub Enterprise Cloud dengan tempat tinggal data. Akun yang terhubung GitHub harus cocok dengan host URL. Misalnya,
github.example.comkoneksi hanya dapat mengimpor darigithub.example.comURL, bukan darigithub.comURL.Berkas Markdown diperlukan — URL harus menunjuk ke satu
.mdfile.Ukuran file maksimum — File tidak boleh melebihi 1 MB (batas GitHub API).
GitHub akun diperlukan — Ruang Agen Anda harus memiliki GitHub akun terkait untuk mengimpor agen. Untuk repositori pribadi, akun harus memiliki akses baca.
Agen adat komunitas
Repositori Alat AWS DevOps Agen
Untuk menggunakan agen kustom komunitas, impor dari repositori menggunakan aliran Imp or dari repositori di halaman Agen. Salin URL file Markdown agen dan tempel sebagai URL repositori. Untuk detailnya, lihat Mengimpor agen kustom dari repositori.
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 dapat diandalkan.
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 — Batasan pada apa yang harus dan tidak boleh dilakukan agen. Misalnya, akses baca-saja, rentang waktu yang perlu dipertimbangkan, atau layanan untuk 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:
Spesifik tentang alat — Referensikan nama alat secara langsung (misalnya,
list_investigations,use_aws,query_cloudwatch_logs) sehingga agen tahu alat mana yang akan dipanggil.Tentukan kriteria keberhasilan — Jelaskan seperti apa output yang baik sehingga agen tahu kapan itu selesai.
Tetapkan batasan — Secara eksplisit menyatakan 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 pengamatan, saluran CI/CD pipa, sistem tiket, dan server MCP khusus.
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 terendah — tetapkan hanya alat yang dibutuhkan agen untuk menyelesaikan tugasnya. Ini mengurangi risiko tindakan yang tidak diinginkan dan membuat agen tetap fokus.
Alat Release Manager
Agen khusus memiliki akses ke alat Release Manager. Alat ini memungkinkan agen Anda membuat, membuat daftar, mendapatkan, dan membatalkan tugas Release Manager. Agen Anda juga dapat menganalisis laporan tinjauan kesiapan rilis untuk menampilkan temuan dan tindakan yang direkomendasikan.
Untuk menggunakan alat Release Manager, tetapkan alat tersebut ke agen kustom Anda melalui Obrolan. Contoh:
Add the release manager tools to my release-pipeline-agent.
Untuk informasi selengkapnya tentang kemampuan manajemen rilis, lihatManajemen rilis.
Mengkonfigurasi keterampilan
Keterampilan memberi agen khusus Anda pengetahuan domain tambahan, prosedur investigasi, atau kemampuan khusus. Ketika agen khusus 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 ditugaskan ke agen khusus harus sudah ada di Ruang Agen Anda. Untuk informasi selengkapnya tentang membuat keterampilan, lihatDevOps Keterampilan Agen.
Agen khusus juga memiliki kemampuan bawaan untuk membuat artefak dan rekomendasi yang tidak memerlukan penugasan keterampilan. Untuk informasi selengkapnya, lihat Output agen kustom.
Anda dapat menetapkan hingga 200 keterampilan per agen kustom. Pilih keterampilan yang relevan dengan tujuan agen untuk mengurangi konsumsi konteks dan meningkatkan fokus agen.
