Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menggunakan kait konteks
Context hook adalah fitur di Amazon Q Developer CLI yang dapat Anda gunakan untuk secara otomatis menyuntikkan konteks ke dalam percakapan Anda dengan Q Developer. Alih-alih menambahkan konteks secara manual dengan /context perintah, kait konteks menjalankan perintah dan menyertakan outputnya sebagai konteks.
Jenis kait konteks
Q Developer CLI mendukung dua jenis kait konteks:
- Percakapan mulai kait
-
Jalankan sekali di awal percakapan. Output mereka ditambahkan ke konteks percakapan dan berlanjut sepanjang sesi.
- Kait per prompt
-
Jalankan dengan setiap pesan pengguna. Output mereka ditambahkan hanya ke prompt saat ini.
Mengelola kait konteks
Anda dapat mengelola kait konteks dengan menggunakan /context hooks perintah di Q Developer CLI.
Lihat kait Anda
Untuk melihat semua kait yang dikonfigurasi di tingkat global dan profil:
/context hooks
Perintah ini menampilkan semua kait yang dikonfigurasi untuk profil Anda saat ini dan di tingkat global, bersama dengan statusnya (diaktifkan atau dinonaktifkan).
Tambahkan pengait
Untuk menambahkan hook konteks baru:
/context hooks add [--global] <name> --trigger <trigger> --command <command>
- <name>
-
Nama unik untuk kail
- <trigger>
-
Entah
per_promptatauconversation_start - <command>
-
Perintah shell untuk mengeksekusi
- --global
-
(Opsional) Tambahkan hook ke konfigurasi global alih-alih profil saat ini
contoh Menambahkan hook status git
/context hooks add git-status --trigger per_prompt --command "git status --short"
Lepaskan kait
Untuk menghapus hook konteks yang ada:
/context hooks rm <name> [--global]
Mengaktifkan atau menonaktifkan kait
Untuk mengaktifkan hook tertentu:
/context hooks enable [--global] <name>
Untuk menonaktifkan hook tertentu:
/context hooks disable [--global] <name>
Untuk mengaktifkan semua kait:
/context hooks enable-all [--global]
Untuk menonaktifkan semua kait:
/context hooks disable-all [--global]
Dapatkan bantuan dengan kait
Untuk menampilkan bantuan terperinci untuk perintah kait:
/context hooks help
Konfigurasi
Anda dapat memverifikasi konfigurasi kait Anda di lokasi berikut.
Jika kailnya global:
~/.aws/amazonq/global_context.json
Jika hook berbasis profil:
~/.aws/amazonq/profiles/profile-name/context.json
Contoh kasus penggunaan
Contoh berikut menunjukkan kasus penggunaan umum untuk kait konteks.
Status Git
Tambahkan hook untuk menampilkan status git dengan setiap prompt:
/context hooks add git-status --trigger per_prompt --command "git status --short"
Hook ini menjalankan git status --short perintah sebelum setiap prompt dan menyertakan output dalam percakapan Anda dengan Q Developer. Ini membantu Q Developer memahami status repositori git Anda saat ini ketika Anda mengajukan pertanyaan tentang kontrol versi atau memerlukan bantuan dengan perintah git.
Informasi proyek
Tambahkan hook untuk menampilkan informasi proyek di awal percakapan:
/context hooks add project-info --trigger conversation_start --command "echo 'Project: '$(basename $(pwd))"
Hook ini berjalan sekali di awal percakapan Anda dan menyertakan nama proyek saat ini dalam konteksnya. Ini membantu Q Developer memberikan tanggapan yang lebih relevan yang spesifik untuk proyek Anda.
Tip
Anda dapat memperluas hook ini untuk memasukkan lebih banyak informasi proyek, seperti bahasa pemrograman, kerangka kerja, atau struktur proyek.
Perilaku dan keterbatasan
Saat Anda menggunakan kait konteks, ingatlah perilaku dan batasan berikut:
-
Hooks berjalan secara paralel untuk meminimalkan dampak pada waktu respons
-
Output hook diformat dan ditandai dengan jelas dalam konteks
-
/clearPerintah mengevaluasi kembali kait awal percakapan -
Kait disimpan dalam konfigurasi CLI Pengembang Q Anda
-
Saat ini, hanya kait perintah inline yang didukung
-
Output kait dibatasi hingga 10KB per kait
-
Hooks time out setelah 5 detik secara default
Pertimbangan keamanan
Saat Anda menggunakan kait konteks, pertimbangkan praktik terbaik keamanan berikut:
-
Context hook mengeksekusi perintah shell dengan izin pengguna Anda saat ini. Hati-hati tentang perintah mana yang Anda sertakan dalam kait Anda, karena mereka memiliki akses yang sama dengan akun pengguna Anda.
-
Berhati-hatilah saat menambahkan kait yang mungkin mengekspos informasi sensitif, seperti kredensil atau data pribadi. Tinjau output hook Anda untuk memastikan bahwa mereka tidak menyertakan informasi yang tidak ingin Anda bagikan.
-
Pertimbangkan untuk menonaktifkan kait saat tidak diperlukan. Ini mengurangi risiko secara tidak sengaja mengekspos informasi sensitif.
-
Jangan gunakan kait untuk menjalankan perintah yang dapat memodifikasi sistem atau data Anda. Hooks harus digunakan untuk membaca informasi, bukan untuk membuat perubahan.
-
Berhati-hatilah saat menggunakan kait di lingkungan bersama. Pengguna lain mungkin dapat melihat output kait Anda jika mereka memiliki akses ke sesi CLI Pengembang Q Anda.
Awas
Jangan pernah menyertakan perintah di kait Anda yang mengekspos kata sandi, kunci akses, atau kredensi lainnya. Informasi ini dapat disimpan dalam riwayat percakapan Anda dan berpotensi terpapar kepada orang lain.
Pemecahan Masalah
Jika Anda mengalami masalah dengan kait konteks, coba solusi berikut:
| Isu | Solusi |
|---|---|
| Hook tidak berjalan | Verifikasi bahwa hook diaktifkan dengan /context hooks |
| Perintah gagal | Uji perintah langsung di terminal Anda untuk memastikannya berfungsi |
| Output terlalu besar | Ubah perintah Anda untuk membatasi ukuran output |
| Waktu kait habis | Optimalkan perintah Anda untuk eksekusi yang lebih cepat |
