Kelola petunjuk - Amazon Q Developer
Tentang tipe promptCommandsMenggunakan petunjukMeneruskan argumen ke prompt MCPLokasi penyimpananSistem prioritasFitur yang disempurnakanIntegrasi MCPContoh

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

Kelola petunjuk

CLI Pengembang Amazon Q menyediakan kemampuan manajemen prompt yang komprehensif untuk permintaan lokal dan prompt Model Context Protocol (MCP). Sistem ini memungkinkan Anda untuk membuat, mengedit, mengatur, dan menggunakan prompt yang dapat digunakan kembali di seluruh alur kerja pengembangan Anda.

Tentang tipe prompt

Sistem prompt mendukung tiga jenis prompt:

  • Prompt lokal: Prompt khusus proyek yang disimpan di ruang kerja Anda

  • Permintaan global: Permintaan di seluruh pengguna tersedia di semua proyek

  • Permintaan MCP: Prompt yang disediakan oleh server MCP dengan fungsionalitas yang ditingkatkan

Commands

Semua manajemen prompt diakses melalui /prompts perintah dengan berbagai subperintah.

Daftar petunjuk

/prompts list

Menampilkan semua petunjuk yang tersedia dalam tata letak tiga kolom yang menampilkan nama, deskripsi, dan sumber. Menampilkan jumlah prompt dan menunjukkan permintaan mana yang berasal dari penyimpanan lokal, penyimpanan global, atau server MCP.

Buat prompt

/prompts create --name name [--content content]

Membuat prompt lokal baru di ruang kerja saat ini.

Parameter
name(diperlukan)

Nama prompt (maksimal 50 karakter)

--content content (opsional)

Spesifikasi konten langsung

Perilaku:

  • Jika --content disediakan, buat prompt dengan konten tertentu

  • Jika tidak ada konten yang disediakan, buka editor default Anda untuk pembuatan konten

  • Prompt disimpan .amazonq/prompts/ di ruang kerja saat ini

Edit petunjuk

/prompts edit name

Membuka prompt yang ada di editor default Anda untuk modifikasi.

Permintaan yang didukung:

  • Permintaan ruang kerja lokal

  • Permintaan pengguna global

  • MCP prompt (jika didukung oleh server)

Lihat detail secepatnya

/prompts details name

Menampilkan informasi komprehensif tentang prompt termasuk:

  • Detail metadata dan argumen

  • Lengkapi konten prompt sebelum pemrosesan AI

  • Persyaratan dan contoh parameter

  • Informasi sumber (server lokal, global, atau MCP)

Menggunakan petunjuk

Setelah Anda membuat prompt, panggil mereka dalam obrolan menggunakan awalan @:

@prompt-name

Contoh

@code-review
# Uses your local code-review prompt
@team-standup
# Uses your team-standup prompt

Meneruskan argumen ke prompt MCP

Prompt server MCP dapat menerima argumen untuk menyesuaikan perilaku mereka. Prompt berbasis file (lokal dan global) tidak mendukung argumen.

Sintaks argumen prompt MCP

@server-name/prompt-name <required-arg> [optional-arg]

Gunakan /prompts details prompt-name untuk menemukan argumen apa yang diterima oleh prompt MCP.

# Example: Using MCP prompt with arguments
@dev-tools/analyze "performance issue" "detailed"
@security-tools/scan "web-app" "high-severity"

Lokasi penyimpanan

Permintaan lokal (khusus ruang kerja)

  • Lokasi: project/.amazonq/prompts/

  • Lingkup: Hanya tersedia dalam proyek saat ini

  • Prioritas: Tertinggi (mengesampingkan permintaan global dan MCP dengan nama yang sama)

Permintaan global (seluruh pengguna)

  • Lokasi: ~/.aws/amazonq/prompts/

  • Lingkup: Tersedia di semua proyek

  • Prioritas: Medium (mengganti prompt MCP dengan nama yang sama)

Permintaan MCP

  • Sumber: Disediakan oleh server MCP yang dikonfigurasi

  • Lingkup: Tergantung pada konfigurasi server

  • Prioritas: Terendah (diganti dengan permintaan lokal dan global)

Sistem prioritas

Ketika beberapa prompt memiliki nama yang sama, sistem menggunakan urutan prioritas ini:

  1. Permintaan lokal (prioritas tertinggi)

  2. Permintaan global

  3. Permintaan MCP (prioritas terendah)

Ini memungkinkan Anda untuk mengganti MCP atau permintaan global dengan versi khusus proyek bila diperlukan.

Fitur yang disempurnakan

Pratinjau konten

Sistem menampilkan konten prompt lengkap sebelum mengirimnya ke model AI, menghilangkan kebingungan tentang informasi apa yang sebenarnya diproses.

Peningkatan penanganan kesalahan

  • Kesalahan server MCP dikonversi ke pesan yang ramah pengguna

  • Contoh penggunaan yang bermanfaat dihasilkan dari metadata prompt

  • Panduan yang jelas untuk parameter yang tidak valid atau persyaratan yang hilang

Pemformatan visual

  • Gaya terminal yang konsisten di semua operasi yang cepat

  • Tampilan konten yang tepat untuk semua jenis pesan prompt

  • Tata letak tiga kolom untuk meningkatkan keterbacaan dalam daftar

Integrasi MCP

Sistem prompt terintegrasi dengan mulus dengan server MCP:

  • Penemuan otomatis: Permintaan MCP secara otomatis ditemukan dari server yang dikonfigurasi

  • UX yang disempurnakan: Pengalaman pengguna yang ditingkatkan untuk manajemen prompt MCP

  • Terjemahan kesalahan: Kesalahan JSON mentah diubah menjadi pesan yang dapat ditindaklanjuti

  • Pratinjau konten: Pratinjau konten lengkap untuk permintaan MCP sebelum eksekusi

Contoh

Contoh-contoh ini menunjukkan pembuatan prompt berbasis file dan penggunaan prompt MCP.

Pembuatan dan penggunaan prompt berbasis file dasar

# Create a simple prompt without arguments
/prompts create --name code-review --content "Please review this code for best practices, security issues, and potential improvements:"

# Use the prompt (no arguments supported for file-based prompts)
@code-review

MCP penggunaan prompt dengan argumen

# Using MCP prompts with arguments
@dev-tools/analyze "performance bottleneck" "cpu usage"
@security-tools/scan "web-app" "high-severity"
@aws-tools/deploy "my-service" "production" "us-west-2"