Mendefinisikan agen kustom - Amazon Q Developer
Membuat agen kustom pertama AndaPerintah agen kustomMigrasi dari profil lamaMenggunakan agen default vs agen kustom khusus

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

Mendefinisikan agen kustom

Bagian ini mencakup cara membuat dan menggunakan agen khusus di alur kerja CLI Pengembang Amazon Q Anda.

Membuat agen kustom pertama Anda

Berikut step-by-step panduan untuk membuat agen kustom pertama Anda:

  1. Mulai sesi obrolan CLI Pengembang Amazon Q:

    $ q chat

  2. Daftar agen yang ada untuk melihat apa yang tersedia:

    /agent list

  3. Buat agen baru (ganti my-agent dengan nama pilihan Anda):

    /agent create --name my-agent

    Ini membuat file konfigurasi agen baru dan membukanya di editor default Anda (diatur melalui variabel EDITOR lingkungan).

  4. Sesuaikan konfigurasi agen kustom sesuai kebutuhan. Untuk awal yang sederhana, Anda mungkin ingin:

    • Tambahkan deskripsi yang menjelaskan tujuan agen kustom

    • Tentukan alat mana yang harus tersedia

    • Pra-persetujuan alat yang sering Anda gunakan

  5. Simpan file konfigurasi dan keluar dari editor Anda untuk kembali ke sesi obrolan.

  6. Mulai sesi obrolan baru dengan agen kustom Anda:

    $ q chat --agent my-agent

    Catatan: Anda tidak dapat mengganti agen kustom dalam sesi obrolan yang ada. Perubahan agen khusus memerlukan memulai sesi baru.

  7. Uji agen kustom Anda dengan memintanya untuk melakukan tugas menggunakan alat yang telah Anda konfigurasi.

Untuk informasi rinci tentang opsi konfigurasi agen kustom, lihat Referensi konfigurasi.

Perintah agen kustom

Amazon Q Developer CLI menyediakan beberapa perintah untuk mengelola agen kustom. Perintah ini tersedia selama sesi obrolan dan mulai dengan/agent.

Perintah agen kustom
Perintah Deskripsi Ketersediaan
/agent list Menampilkan semua agen kustom yang tersedia di lingkungan Anda Sesi obrolan
/agent schema Menampilkan skema JSON untuk membuat file konfigurasi agen kustom Sesi obrolan
/agent create --name [name] Membuat file konfigurasi agen kustom baru dan membukanya di editor default Anda Sesi obrolan

Catatan: Beberapa operasi manajemen agen kustom memerlukan pengeditan file manual daripada perintah interaktif. Perubahan agen kustom berlaku saat Anda memulai sesi obrolan baru.

Migrasi dari profil lama

Saat memperbarui ke versi CLI Pengembang Amazon Q yang mendukung agen dan masuk, Anda mungkin diminta untuk memigrasikan profil lama Anda ke agen jika:

  • Anda memiliki konfigurasi profil lama yang ada

  • Anda berjalan dalam mode interaktif (migrasi dilewati) --no-interactive

  • Anda belum menyelesaikan proses migrasi sebelumnya

Proses migrasi:

  • Mengonversi konfigurasi profil yang ada ke format agen baru

  • Mempertahankan izin alat dan pengaturan konteks yang ada

  • Membuat file konfigurasi agen di direktori home Anda

  • Mempertahankan kompatibilitas mundur dengan alur kerja yang ada

Migrasi bersifat opsional dan dapat ditolak. Jika Anda memilih untuk tidak bermigrasi, Anda dapat terus menggunakan agen default atau membuat agen baru secara manual. Untuk mengontrol perilaku migrasi, gunakan --no-interactive tanda untuk melewati permintaan migrasi sepenuhnya.

Menggunakan agen default vs agen kustom khusus

Amazon Q Developer CLI menyertakan agen default bawaan yang menyediakan akses ke semua alat dengan izin minimal yang disetujui sebelumnya. Agen default ini:

  • Termasuk semua alat yang tersedia (built-in dan MCP)

  • Pra-menyetujui hanya fs_read alat untuk keamanan

  • Secara otomatis menyertakan file proyek umum seperti README.md dan AmazonQ.md

  • Menggunakan konfigurasi MCP lama jika tersedia

Agen kustom khusus memungkinkan Anda untuk:

  • Batasi akses alat hanya untuk apa yang Anda butuhkan

  • Pra-menyetujui alat tambahan untuk mengurangi interupsi

  • Sertakan dokumentasi proyek dan file konteks tertentu

  • Konfigurasikan perilaku alat untuk kasus penggunaan spesifik Anda