Mengelola agen kustom - Amazon Q Developer
Lokasi file agen kustomPraktik terbaik untuk mengatur agen kustomBerbagi agen kustom dengan tim

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengelola agen kustom

Bagian ini mencakup cara mengatur, mengelola, dan bekerja dengan agen kustom secara efektif dalam alur kerja pengembangan Anda.

Lokasi file agen kustom

File konfigurasi agen kustom disimpan sebagai file JSON di direktori tertentu:

Agen kustom global

~/.aws/amazonq/cli-agents/{agent-name}.json

Tersedia di semua proyek dan direktori di sistem Anda.

Agen kustom tingkat proyek

.amazonq/cli-agents/{agent-name}.json

Hanya tersedia dalam direktori proyek tertentu dan subdirektorinya.

Penting: Nama file hanya untuk referensi Anda. {agent-name} Nama agen sebenarnya ditentukan oleh name bidang dalam file konfigurasi JSON itu sendiri, yang diperlukan.

Prioritas agen kustom dan resolusi konflik

Ketika Amazon Q Developer CLI mencari agen khusus, ia mengikuti urutan prioritas tertentu:

  1. Agen kustom lokal terlebih dahulu - Memeriksa agen khusus di direktori kerja saat ini

  2. Agen kustom global kedua - Kembali ke agen kustom di direktori home Anda

  3. Built-in default - Menggunakan agen default jika tidak ada agen kustom kustom ditemukan

Jika direktori lokal dan global berisi agen kustom dengan nama yang sama, agen kustom lokal diutamakan. Amazon Q Developer CLI akan menampilkan pesan peringatan ketika ini terjadi:

WARNING: Agent conflict for my-agent. Using workspace version.

Sistem prioritas ini memungkinkan Anda untuk:

  • Ganti agen kustom global dengan versi khusus proyek

  • Uji modifikasi agen khusus secara lokal sebelum membuatnya global

  • Pertahankan konfigurasi agen kustom yang berbeda untuk proyek yang berbeda

Praktik terbaik untuk mengatur agen kustom

Kapan menggunakan agen kustom global

Gunakan agen kustom global untuk:

  • Alur kerja tujuan umum - Agen khusus yang digunakan di beberapa proyek

  • Produktivitas pribadi - Agen khusus yang disesuaikan dengan gaya kerja pribadi Anda

  • Tugas pengembangan umum - Peninjauan kode, debugging, pembuatan dokumentasi

  • Alur kerja khusus alat - Manajemen AWS, operasi Git, alur kerja Docker

Kapan menggunakan agen kustom lokal

Gunakan agen kustom lokal untuk:

  • Konfigurasi khusus proyek - Agen khusus yang memerlukan akses ke file proyek tertentu

  • Kolaborasi tim - Agen khusus dibagikan melalui kontrol versi

  • Lingkungan pengembangan - Agen khusus dengan persyaratan unik untuk proyek tertentu

  • Pengujian dan eksperimen - Modifikasi agen kustom sementara tanpa mempengaruhi pengaturan global

Konvensi penamaan agen kustom

Pertimbangkan konvensi penamaan ini untuk organisasi agen kustom yang lebih baik:

  • Nama berbasis tujuan -,, aws-specialist.json code-reviewer.json documentation-writer.json

  • Nama khusus teknologi -,, python-dev.json react-frontend.json terraform-ops.json

  • Nama khusus proyek -,, project-alpha.json mobile-app.json api-backend.json

  • Nama khusus lingkungan -,, development.json staging.json production.json

Berbagi agen kustom dengan tim

Agen kustom lokal dapat dibagikan dengan anggota tim melalui sistem kontrol versi. Pendekatan ini memungkinkan tim untuk:

  • Standarisasi lingkungan pengembangan - Pastikan semua anggota tim memiliki akses ke alat dan konfigurasi yang sama

  • Bagikan konteks khusus proyek - Sertakan dokumentasi proyek, standar pengkodean, dan skrip khusus

  • Pertahankan konsistensi - Gunakan izin dan pengaturan alat yang sama di seluruh tim

  • Berkolaborasi dalam peningkatan - Gunakan permintaan tarik untuk meninjau dan meningkatkan konfigurasi agen kustom

Praktik terbaik kontrol versi

Saat berbagi agen khusus melalui kontrol versi:

  • Sertakan direktori agen kustom - Tambahkan .aws/amazonq/agents/ ke repositori Anda

  • Dokumen tujuan agen kustom - Gunakan deskripsi yang jelas dalam file konfigurasi agen kustom

  • Tinjau perubahan agen kustom - Perlakukan perubahan konfigurasi agen kustom seperti perubahan kode

  • Uji konfigurasi agen kustom - Verifikasi bahwa agen kustom bersama berfungsi dengan benar untuk semua anggota tim

  • Hindari informasi sensitif - Jangan sertakan kunci API, kata sandi, atau informasi pribadi di agen kustom bersama