Instruksi agen

Gunakan instruksi agen untuk memberikan panduan yang selalu diterapkan AWS DevOps Agen untuk setiap sesi. Sesi adalah percakapan tunggal atau investigasi dengan agen. Pada halaman Agen di Aplikasi Web Operator Ruang Agen, Anda dapat mengatur instruksi Global yang berlaku untuk semua agen, atau menetapkan instruksi untuk agen terkelola tertentu seperti triase Obrolan atau Insiden. Instruksi ini disimpan sebagai AGENTS.md file. Tidak sepertiDevOps Keterampilan Agen, yang memuat sesuai permintaan ketika agen mencocokkan deskripsi keterampilan dengan tugas saat ini, instruksi agen selalu ada sejak awal setiap sesi, terlepas dari apa yang sedang dikerjakan agen.

Apa itu instruksi agen

Instruksi agen memberikan panduan tanpa syarat dan selalu aktif untuk agen Anda. Pada awal setiap sesi, layanan agen mengambil instruksi yang dikonfigurasi untuk Ruang Agen Anda dan menyuntikkan konten mereka langsung ke prompt sistem agen. Agen tidak memutuskan apakah akan memuatnya, mereka selalu hadir.

Setiap sesi agen menerima instruksi dari instruksi global dan instruksi khusus agen yang relevan, misalnya, Obrolan.

Instruksi agen disimpan sebagai AGENTS.md file dan berbeda dari beberapa DevOps Keterampilan Agen cara penting:

Aspek	Keterampilan	Instruksi agen (AGENTS.md)
Nama dan deskripsi	Diperlukan	Tidak berlaku
Format konten	Bundel penurunan harga atau ZIP	Hanya penurunan harga
File sumber daya	Didukung	Tidak Support
Injeksi konteks	Sesuai permintaan (agen memutuskan melalui pencocokan deskripsi keterampilan)	Selalu (tanpa syarat, setiap sesi)
Keunikan	Beberapa per Ruang Agen	Satu per agen (satu untuk instruksi global, satu per agen terkelola)

Instruksi agen tidak memiliki bidang nama atau deskripsi. AGENTS.md File yang mendasarinya hanya berisi penurunan harga tanpa frontmatter, tidak ada dukungan bundel ZIP, dan tidak ada file sumber daya.

Mengapa menggunakan instruksi agen

Instruksi agen memberi Anda cara yang andal untuk memastikan panduan tertentu selalu dalam konteks, tanpa bergantung pada keputusan pemuatan keterampilan agen.

Manfaat utama:

• Prediktabilitas: Instruksi selalu ada, terlepas dari tugas apa yang sedang dikerjakan agen. Tidak diperlukan pencocokan deskripsi, dan agen tidak dapat melewatkan konten.

• Cakupan terjamin: Tidak seperti Keterampilan, yang mungkin atau mungkin tidak dimuat agen tergantung pada relevansi tugas, instruksi agen selalu disuntikkan pada awal setiap sesi.

• Kebijakan tetap: Gunakan instruksi agen untuk kebijakan operasional tetap, pedoman keamanan, standar pengkodean, atau panduan apa pun yang harus berlaku untuk setiap sesi tanpa kecuali.

• Cakupan yang ditargetkan: Anda dapat menerapkan instruksi ke semua jenis agen sekaligus menggunakan instruksi global, atau membatasi instruksi ke jenis agen tertentu ketika panduan hanya relevan dengan pekerjaan agen tersebut.

Bagaimana instruksi agen bekerja

Ketika sesi dimulai, layanan agen mengambil instruksi yang dikonfigurasi untuk Ruang Agen Anda dan menyuntikkan kontennya ke dalam prompt sistem agen sebelum sesi dimulai. Ini terjadi secara otomatis untuk setiap sesi. Agen tidak mengevaluasi apakah akan memuatnya; itu selalu menyuntikkan konten.

Setiap sesi baru memuat instruksi baru saat startup. Jika Anda memperbarui instruksi, perubahan akan segera berlaku untuk sesi yang dimulai setelah Anda menyimpan. Sesi yang sudah berlangsung terus menggunakan konten yang dimuat saat dimulai.

Pelingkupan menentukan instruksi mana yang diterima sesi. Instruksi global berlaku untuk semua jenis agen di Ruang Agen Anda, sehingga setiap sesi menerimanya. Agent-specific instruksi hanya berlaku untuk sesi jenis agen tertentu. Sesi menerima instruksi dari instruksi global dan instruksi khusus agen yang relevan.

Pelingkupan jenis agen

Scoping mengontrol sesi agen mana yang menerima serangkaian instruksi tertentu. Ada dua opsi pelingkupan:

• Instruksi global: Berlaku untuk semua jenis agen di Ruang Agen Anda. Setiap sesi agen menerima konten ini.

• Agent-specific: Hanya berlaku untuk sesi dari jenis agen yang dipilih.

Agen terkelola yang tersedia untuk instruksi khusus agen adalah:

• Obrolan - Ad-hoc pertanyaan dan permintaan selama sesi obrolan.

• Triase insiden - Penyaringan alarm, klasifikasi keparahan, dan pelingkupan awal.

• Insiden RCA - Analisis akar penyebab dengan pengumpulan dan validasi bukti.

• Mitigasi insiden - Short-term remediasi dan rekomendasi perbaikan jangka panjang.

• Evaluasi - Penilaian kinerja agen dan pemeriksaan kepatuhan kebijakan.

Panduan ukuran konten

Setiap kali Anda memulai percakapan atau investigasi, agen membaca seluruh instruksi Anda sebelum melakukan hal lain. Agen memiliki jumlah memori kerja yang tetap per sesi, dan instruksi Anda menggunakan beberapa di antaranya. Semakin besar file, semakin sedikit ruang yang tersisa untuk pertanyaan Anda, investigasi, log yang dibaca agen, dan alasannya sendiri. Instruksi yang lebih pendek dan terfokus memberi agen lebih banyak kapasitas untuk menyelesaikan masalah Anda.

• Batas keras: 25 KB

• Ukuran yang disarankan: 120 baris (direkomendasikan untuk sebagian besar konfigurasi)

Fokuskan instruksi Anda pada panduan yang harus ada di setiap sesi. Untuk prosedur investigasi khusus yang hanya berlaku untuk tugas-tugas tertentu, pertimbangkan untuk menggunakan DevOps Keterampilan Agen sebagai gantinya.

Contoh

Contoh berikut menunjukkan instruksi agen yang terbentuk dengan baik dengan panduan investigasi, standar pemformatan respons, dan persyaratan keamanan yang berlaku untuk setiap sesi agen.

# Agent Instructions

## Investigation approach
- Always check CloudWatch alarms and recent deployments before proposing a root cause.

## Response format
- Lead with a one-sentence summary of findings before listing details.
- Include the AWS region and resource identifier for any resource you reference.
- Use bullet points for lists of findings or recommendations.

## Security
- Never log, display, or suggest storing credentials or secrets in plaintext.
- When recommending IAM changes, follow least-privilege principles.

Mengatur instruksi agen

Sebelum mengatur instruksi agen, Anda harus memiliki Ruang Agen. Untuk informasi selengkapnya, lihat Membuat Ruang Agen.

Setiap agen memiliki tepat satu set instruksi. Ketika Anda menyimpan konten baru, itu menimpa konten yang ada untuk agen itu.

Untuk mengatur instruksi global (berlaku untuk semua agen):

1. Arahkan ke halaman Agen di Aplikasi Web Operator Ruang Agen Anda.

2. Pilih Lihat di samping Instruksi global.

3. Masukkan instruksi penurunan harga Anda di editor.

4. Pilih Simpan.

Untuk mengatur instruksi untuk agen tertentu:

1. Arahkan ke halaman Agen di Aplikasi Web Operator Ruang Agen Anda.

2. Di bawah Agen terkelola, pilih Lihat di samping agen yang ingin Anda konfigurasikan: Obrolan, Triase insiden, RCA Insiden, Mitigasi insiden, atau Evaluasi.

3. Masukkan instruksi penurunan harga Anda di editor.

4. Pilih Simpan.

Mengelola instruksi agen

AWS DevOps Agen menyediakan kemampuan manajemen untuk instruksi agen melalui Aplikasi Web Operator.

Melihat petunjuk: Arahkan ke halaman Agen dan pilih Lihat di samping Instruksi global atau agen terkelola tertentu. Editor menunjukkan konten saat ini. Gunakan tab Pratinjau untuk melihat penurunan harga yang dirender atau tab Kode untuk melihat penurunan harga mentah.

Instruksi pengeditan: Buka agen seperti dijelaskan di atas, ubah konten di editor, dan pilih Simpan.

Mengunggah instruksi dari file: Buka agen, lalu pilih tombol Unggah di editor untuk mengunggah file penurunan harga dari komputer Anda.

Petunjuk pengunduhan: Buka agen, lalu pilih tombol Unduh di editor untuk mengunduh konten saat ini sebagai file.

Menghapus instruksi: Buka agen, pilih tombol Hapus di editor, dan konfirmasikan penghapusan. Tindakan ini tidak dapat dibatalkan. Pertimbangkan untuk mengunduh konten terlebih dahulu jika Anda mungkin membutuhkannya lagi.