spinny:~/writing $ less context-engineering-agents.md
12Perkataan masa kini, dalam dunia kecil ejen AI, ialah kejuruteraan konteks.34Nampaknya satu lagi label dicipta untuk menjual sesuatu yang telah kami lakukan. Sebahagiannya adalah. Walau bagaimanapun, seperti yang sering berlaku, label itu terperangkap kerana ia memberi nama kepada kesakitan yang sebenar.56Kesakitan adalah ini: model tidak gagal hanya kerana mereka "tidak berfikir". Mereka sering gagal kerana kami menghantar mereka bekerja dengan bilik yang salah.78Kami memberi mereka arahan lama. Kami menyembunyikan fail penting daripadanya. Kami memberikan mereka dokumen yang terlalu panjang dan tidak menyatakan apa yang penting. Kami menunjukkan kepada mereka log tanpa keutamaan. Kami memberi mereka sepuluh alat tanpa menjelaskan bila untuk menggunakannya. Kemudian kami terkejut jika ejen itu bergerak seperti orang yang terbangun di apartmen yang tidak diketahui.910Gesaan ialah frasa yang anda ucapkan kepadanya. Konteksnya ialah dunia yang anda sediakan di sekelilingnya.1112## Daripada kejuruteraan segera kepada kejuruteraan konteks1314Kejuruteraan segera sering dianggap sebagai menulis. Pilih perkataan yang betul, tanya dengan cara yang betul, tambah contoh, nyatakan format.1516Kejuruteraan konteks lebih dekat dengan seni bina.1718Anda tidak hanya bertanya "bagaimana cara saya merumuskan permintaan?". Ia bertanya:1920- apakah maklumat yang benar-benar diperlukan?21- apakah bunyi bising?22- apa yang perlu dipulihkan dengan cepat?23- apa yang perlu diingat?24- alatan yang manakah harus didedahkan?25- arahan yang manakah stabil dan yang mana bergantung pada tugasan?26- bagaimana saya boleh membuat ejen memahami apa yang berwibawa?2728Ia adalah perubahan yang halus tetapi besar. Kerana apabila anda bekerja dengan ejen, konteks bukanlah blok statik. Ia berubah pada setiap langkah.2930Ejen membuka fail, mempelajari sesuatu, menjalankan ujian, menerima ralat, mengemas kini rancangan, memanggil alat, menemui pergantungan. Dengan setiap pusingan dia perlu memutuskan apa yang perlu dibawa dan apa yang perlu ditinggalkan.3132Ini adalah kejuruteraan.3334## Konteksnya bukan tapak pelupusan sampah3536Templat dengan tetingkap konteks yang besar memberi kami godaan: mari kita masukkan semuanya.3738Ia boleh difahami. Jika saya mempunyai sejuta token, mengapa saya harus memilih?3940Kerana walaupun anda boleh memasukkan semuanya, itu tidak bermakna semuanya membantu. Sesungguhnya, bunyi bising mempunyai kos. Ia kos token, ia memerlukan perhatian, ia kos kependaman, ia kos kualiti. Model boleh tersesat dalam butiran yang tidak berkaitan sama seperti kami apabila kami membuka dua puluh tab dan tidak lagi mengingati sebabnya.4142Konteks yang baik mempunyai hierarki:43441. arahan dan polisi sistem;452. objektif khusus;463. status semasa;474. data yang berkaitan;485. kekangan;496. alatan yang ada;507. mengesan keputusan yang telah dibuat.5152Tidak perlu merawat semuanya pada tahap yang sama. Arahan pengguna bernilai lebih daripada nota lama. Ujian yang gagal kini bernilai lebih daripada keutamaan estetik dari tiga bulan lalu. Dasar keselamatan bernilai lebih daripada pintasan pengeluaran.5354Kejuruteraan konteks juga bermakna memberi pemberat, bukan hanya data.5556## Ingatan: kurang ingat, ingat lebih baik5758Memori dalam ejen adalah salah satu topik yang paling licin.5960Sebagai pengguna, anda mahu ejen mengenali anda. Anda mahu dia mengingati nada, rancangan, konvensyen, perkara yang telah diputuskan. Sebagai seorang jurutera, anda tahu bahawa setiap ingatan yang berterusan juga merupakan risiko: ia boleh menjadi salah, lama, terlalu peribadi, terlalu generik, tidak dapat disahkan.6162Ingatan yang berguna harus mempunyai sekurang-kurangnya tiga kualiti:6364- asal: dari mana maklumat ini datang?65- tarikh: bila ia benar?66- tujuan: apakah jenis tugas yang patut digunakan?6768Tanpa tiga perkara ini, ingatan menjadi khurafat.6970Saya suka memikirkan ingatan agen sebagai buku kerja, bukan sebagai minda ajaib. Terdapat nota sementara, keputusan yang disahkan, pilihan gaya, kekangan teknikal, pautan ke sumber. Beberapa perkara luput. Ada yang perlu ditulis semula. Ada yang mesti disingkirkan kerana ejen itu salah sangka.7172Sistem yang baik mesti menjadikan penyelenggaraan ini normal. Bukan heroik.7374## Pengambilan semula dan alatan bukanlah perkara yang sama7576Apabila kita bercakap tentang konteks, kita sering berakhir dengan serta-merta pada RAG. Pembenaman, pangkalan data vektor, chunking, penarafan semula.7778Semua berguna. Tetapi pengambilan semula hanyalah satu cara untuk membawa maklumat kepada model. Dia bukan seorang sahaja.7980Ejen boleh mendapatkan konteks dengan membaca fail, menanyakan API, memanggil pelayan MCP, membuka penyemak imbas, menjalankan ujian, mencari Slack, melihat papan pemuka, bertanya kepada manusia.8182Bahagian yang menarik ialah menentukan laluan mana yang hendak digunakan dan bila.8384Jika ejen perlu menjawab soalan sejarah, mungkin hanya mencari semula sudah memadai. Jika dia perlu membetulkan pepijat, dia perlu membaca kod sebenar. Jika dia perlu memahami mengapa penggunaan gagal, dia perlu melihat log baru. Jika anda perlu menulis surat kepada pelanggan, anda perlu mendapatkan semula nada, sejarah dan status tiket. Jika dia mesti bertindak dalam pengeluaran, dia mesti meminta izin.8586Konteks bukan pangkalan data. Ia adalah satu aliran kerja.8788## Ejen yang baik juga tahu mengabaikan8990Tanda kematangan dalam ejen ialah keupayaan untuk berkata: Saya tidak memerlukan maklumat ini.9192Nampak remeh, tetapi sangat sukar. Banyak sistem agen terkumpul. Setiap panggilan alat menambah teks. Setiap ralat kekal dalam penimbal. Setiap fail yang dibaca menambah pada timbunan. Pada akhirnya model itu mempunyai sejarah yang sangat panjang dan tiada peta.9394Pemampatan diperlukan. Sintesis perantaraan diperlukan. Ia perlu distrukturkan.9596Bukan "itu sahaja yang berlaku", tetapi:9798- objektif masih sah;99- hipotesis semasa;100- fail sudah diperiksa;101- keputusan yang dibuat;102- risiko terbuka;103- tindakan seterusnya.104105Ini menjadikan ejen kurang teater dan lebih membantu. Bukan kerana dia kelihatan lebih bijak, tetapi kerana dia bekerja dengan meja yang kemas.106107## Kejuruteraan konteks untuk pasukan, bukan untuk artis segera108109Sebab topik ini menarik minat saya ialah ia mengalihkan tanggungjawab daripada individu kepada sistem.110111Dalam kejuruteraan segera, orang yang boleh bercakap dengan model yang terbaik selalunya menang. Dalam kejuruteraan konteks, pasukan yang paling baik mengatur kerjanya menang: dokumentasi, konvensyen, isu, log, ujian, pemilikan, penamaan, sumber.112113Repositori yang bersih menjadi konteks yang lebih baik. Isu yang ditulis dengan baik menjadi bahan api yang lebih baik. Buku panduan yang dikemas kini menjimatkan token dan kebimbangan. Log perubahan yang jelas mengurangkan halusinasi.114115Ini berita baik dan agak tidak selesa. Cantik kerana ia memberi ganjaran kepada amalan yang baik. Menyusahkan kerana anda tidak boleh menyelesaikan segala-galanya dengan gesaan yang bijak.116117Ejen menguatkan kebersihan sistem yang mereka temui.118119## Bagaimana saya akan menggunakannya esok120121Jika saya memperkenalkan kejuruteraan konteks ke dalam projek sebenar, saya akan bermula dari perkara kecil:122123- fail arahan projek yang pendek dan diselenggara;124- contoh baik output yang dijangkakan;125- senarai alat dan kes yang tersedia untuk menggunakannya;126- keputusan seni bina yang ditulis dengan cara yang boleh dirujuk;127- isu dengan konteks mandatori minimum;128- mudah untuk mendapatkan semula log dan ujian;129- ingatan berterusan yang boleh diubah suai oleh manusia.130131Kemudian saya akan mengukur perkara mudah: berapa kali ejen perlu meminta penjelasan atau pergi ke arah yang salah?132133Jika ia kerap berlaku, saya tidak akan menambah model yang lebih besar serta-merta. Saya akan melihat konteksnya.134135## Bacaan saya136137Kejuruteraan konteks adalah perkataan yang agak kembung, ya. Tetapi konsepnya mantap.138139Ia mengingatkan kita bahawa kecerdasan ejen bukan hanya dalam model. Ia terletak pada persekitaran yang kita sediakan untuknya: apa yang dia lihat, apa yang dia ingat, apa yang dia boleh buat, apa yang dia dilarang lakukan, sumber mana yang dia akui sebagai benar.140141Bahagian manusia adalah ini: menyediakan konteks dengan baik adalah satu bentuk penjagaan. Ia memberitahu ejen, tetapi juga pasukan, "Saya tidak mahu anda meneka, saya mahu anda mempunyai apa yang anda perlukan."142143Kurang sihir. Bilik yang lebih bersih. Ejen memerlukannya sama seperti kita.144145## Sumber146147- [Blog LangChain: Peningkatan kejuruteraan konteks](https://blog.langchain.com/the-rise-of-context-engineering/)148- [Simon Willison: Kejuruteraan konteks](https://simonwillison.net/2025/Jun/27/context-engineering/)149- [Protokol Konteks Model: Pengenalan](https://modelcontextprotocol.io/introduction)150- [Anthropic: Membina ejen berkesan](https://www.anthropic.com/engineering/building-effective-agents)151- [OpenAI: Alat baharu untuk ejen bangunan](https://openai.com/index/new-tools-for-building-agents/)152
:Kejuruteraan konteks: kerja sebelum gesaanlines 1-152 (END) — press q to close