Konfigurasikan setelan Amazon Q - Amazon Q Developer
Pengaturan aksesKelola pengaturan dari baris perintahReferensi pengaturan yang tersediaContoh pengaturan umumPengaturan pemecahan masalahPerintah Amazon Q CLI lainnya

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

Konfigurasikan setelan Amazon Q

Amazon Q menyediakan berbagai cara untuk menyesuaikan perilakunya melalui pengaturan. Anda dapat mengakses pengaturan ini melalui antarmuka grafis dan opsi baris perintah.

Pengaturan akses

Anda dapat mengakses pengaturan Amazon Q dengan dua cara:

  • Pengaturan GUI: Jalankan q settings untuk membuka antarmuka pengaturan grafis

  • Baris perintah: Gunakan berbagai perintah untuk melihat dan memodifikasi pengaturan secara langsung

Kelola pengaturan dari baris perintah

Anda dapat mengelola pengaturan Amazon Q langsung dari baris perintah menggunakan perintah berikut:

Perintah pengaturan dasar
, , perintah Deskripsi
q settings open Membuka file pengaturan di editor default Anda
q settings list Daftar semua pengaturan yang dikonfigurasi
q settings list --all Daftar semua pengaturan yang tersedia dengan deskripsi
q settings list --format json-pretty Daftar pengaturan di JSON diformat
q settings [KEY] Melihat nilai setelan tertentu
q settings [KEY] [VALUE] Menetapkan pengaturan tertentu ke nilai yang diberikan
q settings --delete [KEY] Menghapus pengaturan tertentu

Saat menggunakan q settings perintah, Anda dapat menentukan format output:

q settings --format [FORMAT]

Format yang tersedia:

  • plain: Hasil keluaran sebagai teks biasa (default)

  • json: Menghasilkan hasil sebagai JSON

  • json-pretty: Menghasilkan hasil sebagai JSON yang diformat

Referensi pengaturan yang tersedia

Bagian berikut menjelaskan semua pengaturan Amazon Q CLI yang tersedia, diatur berdasarkan kategori. Setiap pengaturan mencakup nama kunci, deskripsi, jenis nilai yang diharapkan, dan contoh.

Pengaturan telemetri dan privasi

Pengaturan telemetri dan privasi
Pengaturan Kunci Deskripsi Tipe Contoh
telemetry.enabled Aktifkan/nonaktifkan koleksi telemetri boolean q settings telemetry.enabled true
telemetryClientId Pengidentifikasi klien lama untuk telemetri string q settings telemetryClientId "client-123"
codeWhisperer.shareCodeWhispererContentWithAWS Bagikan konten dengan CodeWhisperer layanan boolean q settings codeWhisperer.shareCodeWhispererContentWithAWS false

Pengaturan antarmuka obrolan

Pengaturan antarmuka obrolan
Pengaturan Kunci Deskripsi Tipe Contoh
chat.enableThinking Aktifkan alat berpikir untuk penalaran yang kompleks boolean q settings chat.enableThinking true
chat.greeting.enabled Tampilkan pesan ucapan saat memulai obrolan boolean q settings chat.greeting.enabled false
chat.editMode Aktifkan mode edit untuk antarmuka obrolan boolean q settings chat.editMode true
chat.enableNotifications Aktifkan notifikasi desktop boolean q settings chat.enableNotifications true
chat.defaultModel Model AI default untuk percakapan string q settings chat.defaultModel "claude-3-sonnet"
chat.disableMarkdownRendering Nonaktifkan pemformatan penurunan harga dalam obrolan boolean q settings chat.disableMarkdownRendering false
chat.defaultAgent Konfigurasi agen default string q settings chat.defaultAgent "my-agent"
chat.disableAutoCompaction Nonaktifkan ringkasan percakapan otomatis boolean q settings chat.disableAutoCompaction true
chat.enableHistoryHints Tampilkan petunjuk riwayat percakapan boolean q settings chat.enableHistoryHints true
chat.uiMode Tentukan varian UI yang akan digunakan string q settings chat.uiMode "compact"
chat.enableContextUsageIndicator Tampilkan persentase penggunaan konteks dalam prompt boolean q settings chat.enableContextUsageIndicator true

Pengaturan basis pengetahuan

Pengaturan basis pengetahuan
Pengaturan Kunci Deskripsi Tipe Contoh
chat.enableKnowledge Aktifkan fungsionalitas basis pengetahuan boolean q settings chat.enableKnowledge true
knowledge.defaultIncludePatterns Pola file default untuk disertakan dalam basis pengetahuan array q settings knowledge.defaultIncludePatterns '["*.py", "*.js"]'
knowledge.defaultExcludePatterns Pola file default untuk dikecualikan dari basis pengetahuan array q settings knowledge.defaultExcludePatterns '["*.log", "node_modules"]'
knowledge.maxFiles Jumlah maksimum file untuk pengindeksan pengetahuan number q settings knowledge.maxFiles 1000
knowledge.chunkSize Ukuran potongan teks untuk pemrosesan pengetahuan number q settings knowledge.chunkSize 512
knowledge.chunkOverlap Tumpang tindih antara potongan teks number q settings knowledge.chunkOverlap 50
knowledge.indexType Jenis indeks pengetahuan yang akan digunakan string q settings knowledge.indexType "fast"

Ikatan kunci

Pengaturan pengikatan kunci
Pengaturan Kunci Deskripsi Tipe Contoh
chat.skimCommandKey Pengikatan kunci untuk perintah pencarian fuzzy char q settings chat.skimCommandKey "f"
chat.autocompletionKey Pengikatan kunci untuk penerimaan petunjuk pelengkapan otomatis char q settings chat.autocompletionKey "Tab"
chat.tangentModeKey Pengikatan tombol untuk mode singgung toggle char q settings chat.tangentModeKey "t"
chat.delegateModeKey Pengikatan kunci untuk perintah delegasi char q settings chat.delegateModeKey "d"

Fitur beralih

Pengaturan sakelar fitur
Pengaturan Kunci Deskripsi Tipe Contoh
chat.enableTangentMode Aktifkan fitur mode tangen boolean q settings chat.enableTangentMode true
introspect.tangentMode Masuk otomatis mode singgung untuk pertanyaan introspeksi boolean q settings introspect.tangentMode true
chat.enableTodoList Aktifkan fitur todo list boolean q settings chat.enableTodoList true
chat.enableCheckpoint Aktifkan fitur pos pemeriksaan boolean q settings chat.enableCheckpoint true
chat.enableDelegate Aktifkan alat delegasi untuk manajemen subagent boolean q settings chat.enableDelegate true

Pengaturan API dan layanan

Pengaturan API dan layanan
Pengaturan Kunci Deskripsi Tipe Contoh
api.timeout Batas waktu permintaan API dalam hitungan detik number q settings api.timeout 30
api.codewhisperer.service CodeWhisperer URL titik akhir layanan string q settings api.codewhisperer.service "https://codewhisperer.us-east-1.amazonaws.com"
api.q.service Q URL titik akhir layanan string q settings api.q.service "https://q.us-east-1.amazonaws.com"

Pengaturan Protokol Konteks Model

Pengaturan MCP
Pengaturan Kunci Deskripsi Tipe Contoh
mcp.initTimeout Batas waktu inisialisasi server MCP number q settings mcp.initTimeout 10
mcp.noInteractiveTimeout Batas waktu MCP non-interaktif number q settings mcp.noInteractiveTimeout 5
mcp.loadedBefore Lacak server MCP yang dimuat sebelumnya boolean q settings mcp.loadedBefore true

Contoh pengaturan umum

Berikut adalah beberapa skenario konfigurasi umum:

Konfigurasi aturan dasar

# Enable telemetry
q settings telemetry.enabled true

# Set default chat model
q settings chat.defaultModel "claude-3-sonnet"

# Disable greeting message
q settings chat.greeting.enabled false

Konfigurasi basis pengetahuan

# Enable knowledge base
q settings chat.enableKnowledge true

# Set file patterns to include
q settings knowledge.defaultIncludePatterns '["*.py", "*.js", "*.md", "*.txt"]'

# Set file patterns to exclude
q settings knowledge.defaultExcludePatterns '["*.log", "node_modules", ".git", "*.pyc"]'

# Set maximum files to index
q settings knowledge.maxFiles 2000

Konfigurasi fitur

# Enable experimental features
q settings chat.enableThinking true
q settings chat.enableTangentMode true
q settings chat.enableTodoList true
q settings chat.enableCheckpoint true

# Configure key bindings
q settings chat.tangentModeKey "t"
q settings chat.delegateModeKey "d"

Melihat dan mengelola pengaturan

# View all configured settings
q settings list

# View all available settings with descriptions
q settings list --all

# View specific setting
q settings chat.defaultModel

# Export settings as JSON
q settings list --format json-pretty > my-settings.json

# Delete a setting
q settings --delete chat.defaultModel

Pengaturan pemecahan masalah

Masalah dan solusi umum saat bekerja dengan pengaturan:

Nilai pengaturan tidak valid

Jika Anda mengalami kesalahan saat menyetel nilai:

  • Nilai Boolean: Gunakan true atau false (huruf kecil)

  • Nilai array: Gunakan format JSON dengan tanda kutip tunggal: '["item1", "item2"]'

  • Nilai string: Gunakan tanda kutip untuk string dengan spasi: "my value"

Mengatur ulang pengaturan

Untuk mengatur ulang pengaturan ke default:

# Delete individual settings
q settings --delete setting.name

# Open settings file for manual editing
q settings open

# View current settings to identify issues
q settings list --all

Masalah file pengaturan

Jika file pengaturan menjadi rusak:

  1. Cadangkan pengaturan saat ini: q settings list --format json > backup.json

  2. Buka file pengaturan: q settings open

  3. Verifikasi sintaks JSON atau pulihkan dari cadangan

Perintah Amazon Q CLI lainnya

Amazon Q menawarkan banyak fitur baris perintah lainnya di luar manajemen pengaturan. Untuk referensi komprehensif dari semua perintah yang tersedia dan argumennya, lihatReferensi Perintah Amazon Q CLI.

Untuk bantuan dengan perintah apa pun, gunakan --help bendera:

q [COMMAND] --help