Manajemen konteks

Mengelola konteks

File konteks berisi informasi yang Anda ingin Amazon Q pertimbangkan selama percakapan Anda. Ini dapat mencakup persyaratan proyek, standar pengkodean, aturan pengembangan, atau informasi lain yang membantu Amazon Q memberikan tanggapan yang lebih relevan.

Ada dua cara untuk mengkonfigurasi konteks:

• Sumber daya agen (disarankan): Konteks persisten yang ditentukan dalam file konfigurasi agen Anda

• Konteks sesi: Konteks sementara ditambahkan selama sesi obrolan menggunakan /context perintah

Mengkonfigurasi konteks persisten dengan sumber daya agen

Cara yang disarankan untuk mengonfigurasi konteks adalah melalui resources bidang di file konfigurasi agen Anda. Ini menciptakan konteks persisten yang tersedia setiap kali Anda menggunakan agen.

Tambahkan jalur file atau pola glob ke resources array di konfigurasi agen Anda:

{
  "name": "my-agent",
  "description": "My development agent",
  "resources": [
    "file://README.md",
    "file://.amazonq/rules/**/*.md",
    "file://docs/**/*.md",
    "file://src/config.py"
  ]
}

Sumber daya harus diawali file:// untuk dimasukkan sebagai file konteks. File-file ini akan tersedia secara otomatis di semua sesi obrolan menggunakan agen ini.

Menambahkan konteks sesi sementara

Anda dapat menambahkan file sementara ke sesi obrolan Anda saat ini menggunakan /context add perintah. Penambahan ini hanya tersedia untuk sesi saat ini dan tidak akan bertahan saat Anda memulai sesi obrolan baru.

q chat
> /context add README.md
Added 1 path(s) to context.
Note: Context modifications via slash command is temporary.

Anda juga dapat menambahkan beberapa file sekaligus menggunakan pola glob:

q chat
> /context add docs/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Untuk membuat perubahan konteks permanen, tambahkan file ke resources bidang agen Anda sebagai gantinya.

Konteks tampilan

Untuk melihat konteks Anda saat ini, gunakan /context show perintah:

q chat
> /context show
👤 Agent (my-agent):
    README.md (1 match)
    .amazonq/rules/**/*.md (3 matches)
    docs/**/*.md (5 matches)

💬 Session (temporary):
    <none>

5 matched files in use:
👤 README.md (~250 tkns)
👤 .amazonq/rules/security.md (~180 tkns)
👤 .amazonq/rules/coding-standards.md (~320 tkns)
👤 docs/architecture.md (~150 tkns)
👤 docs/best-practices.md (~200 tkns)

Total: ~1100 tokens

Outputnya menunjukkan:

• 👤 Agen: Konteks persisten dari resources bidang agen Anda

• 💬 Sesi: Konteks sementara ditambahkan selama sesi saat ini

Menghapus konteks

Untuk menghapus file dari konteks sesi Anda saat ini, gunakan /context rm perintah:

q chat
> /context rm src/temp-file.py
Removed 1 path(s) from context.
Note: Context modifications via slash command is temporary.

Untuk menghapus semua konteks sesi, gunakan /context clear perintah:

q chat
> /context clear
Cleared context
Note: Context modifications via slash command is temporary.

Catatan: Anda tidak dapat menghapus konteks yang ditentukan agen menggunakan /context perintah. Untuk menghapus konteks secara permanen, edit resources bidang agen Anda.

Kasus penggunaan umum

Berikut adalah beberapa kasus penggunaan umum untuk manajemen konteks:

Menggunakan aturan proyek

Amazon Q mendukung aturan tingkat proyek yang dapat menentukan pedoman dan batasan keamanan. Aturan-aturan ini didefinisikan dalam file Markdown di .amazonq/rules direktori proyek Anda.

Misalnya, Anda dapat membuat aturan yang menentukan:

• Direktori mana yang harus dihindari Amazon Q

• Persyaratan keamanan untuk kode yang dihasilkan

• Standar pengkodean dan praktik terbaik

Cara yang disarankan untuk memasukkan aturan proyek adalah melalui konfigurasi agen Anda:

{
  "name": "my-project-agent",
  "resources": [
    "file://.amazonq/rules/**/*.md",
    "file://README.md",
    "file://docs/architecture.md"
  ]
}

Anda juga dapat menambahkan aturan proyek untuk sementara waktu ke sesi Anda saat ini:

q chat
> /context add .amazonq/rules/*.md
Added 3 path(s) to context.
Note: Context modifications via slash command is temporary.

Untuk informasi selengkapnya tentang membuat dan menggunakan aturan proyek, lihat Membuat aturan proyek untuk digunakan dengan obrolan Pengembang Amazon Q di dokumentasi IDE.

Migrasi dari konteks sesi ke sumber daya agen

Jika Anda menemukan diri Anda berulang kali menambahkan file konteks yang sama menggunakan /context add perintah, pertimbangkan untuk memindahkannya ke resources bidang agen Anda untuk ketekunan:

1. Catat file yang sering Anda tambahkan /context add

2. Edit file konfigurasi agen Anda

3. Tambahkan path file ke resources array dengan file:// awalan

4. Simpan konfigurasi agen

Contoh migrasi:

# Instead of running these commands every session:
> /context add README.md
> /context add docs/*.md
> /context add .amazonq/rules/*.md

# Add them to your agent config once:
{
  "resources": [
    "file://README.md",
    "file://docs/**/*.md", 
    "file://.amazonq/rules/**/*.md"
  ]
}