spinny:~/writing $ less context-engineering-agents.md
12Istilah yang ada saat ini, dalam dunia kecil agen AI, adalah rekayasa konteks.34Sepertinya ada label lain yang diciptakan untuk menjual sesuatu yang sudah kami lakukan. Sebagian memang demikian. Namun, seperti yang sering terjadi, label tersebut menarik perhatian karena memberi nama pada rasa sakit yang nyata.56Yang menyakitkan adalah ini: model tidak gagal hanya karena mereka "tidak berpikir". Seringkali mereka gagal karena kami mengirim mereka untuk bekerja dengan ruangan yang salah.78Kami memberi mereka instruksi lama. Kami menyembunyikan file penting darinya. Kami memberikan mereka dokumen yang terlalu panjang dan tidak menyebutkan apa yang penting. Kami menunjukkan kepada mereka log tanpa prioritas. Kami memberi mereka sepuluh alat tanpa menjelaskan kapan menggunakannya. Lalu kita kaget jika agen tersebut bergerak seperti orang yang terbangun di apartemen tak dikenal.910Promptnya adalah frasa yang Anda ucapkan padanya. Konteksnya adalah dunia yang Anda persiapkan di sekitarnya.1112## Dari rekayasa cepat hingga rekayasa konteks1314Rekayasa cepat sering kali dianggap sebagai tulisan. Pilih kata yang tepat, tanyakan dengan cara yang benar, tambahkan contoh, tentukan formatnya.1516Rekayasa konteks lebih dekat dengan arsitektur.1718Anda tidak hanya bertanya “bagaimana cara merumuskan permintaannya?”. Ia bertanya:1920- informasi apa yang benar-benar dibutuhkan?21- apa itu kebisingan?22- apa yang perlu dipulihkan dengan cepat?23- apa yang harus diingat?24- alat apa yang harus diekspos?25- instruksi mana yang stabil dan mana yang bergantung pada tugasnya?26- bagaimana cara membuat agen memahami apa yang otoritatif?2728Ini adalah perubahan yang halus namun besar. Karena ketika Anda bekerja dengan agen, konteks bukanlah blok statis. Itu berubah di setiap langkah.2930Agen membuka file, mempelajari sesuatu, menjalankan pengujian, menerima kesalahan, memperbarui rencana, memanggil alat, menemukan ketergantungan. Pada setiap putaran dia harus memutuskan apa yang harus dibawa dan apa yang tidak.3132Ini adalah rekayasa.3334## Konteksnya bukan tempat pembuangan sampah3536Templat dengan jendela konteks besar memberi kita godaan: ayo masukkan semuanya.3738Itu bisa dimengerti. Jika saya mempunyai sejuta token, mengapa saya harus memilih?3940Karena meskipun Anda bisa memasukkan semuanya, bukan berarti semuanya membantu. Memang benar, kebisingan mempunyai konsekuensi. Ini memerlukan token, memerlukan perhatian, memerlukan latensi, dan memerlukan kualitas. Seorang model bisa tersesat dalam detail yang tidak relevan seperti kita ketika kita membuka dua puluh tab dan tidak ingat lagi alasannya.4142Konteks yang baik memiliki hierarki:43441. instruksi dan kebijakan sistem;452. tujuan tertentu;463. status saat ini;474. data yang relevan;485. kendala;496. alat yang tersedia;507. melacak keputusan yang sudah diambil.5152Tidak perlu memperlakukan semuanya pada tingkat yang sama. Perintah pengguna lebih berharga daripada catatan lama. Tes yang gagal kini bernilai lebih dari sekadar preferensi estetika tiga bulan lalu. Kebijakan keamanan lebih berharga daripada jalan pintas produksi.5354Rekayasa konteks juga berarti memberi bobot, bukan sekedar data.5556## Memori: ingat lebih sedikit, ingat lebih baik5758Memori pada agen adalah salah satu topik yang paling licin.5960Sebagai pengguna, Anda ingin agen mengenal Anda. Anda ingin dia mengingat nadanya, rencananya, kesepakatannya, hal-hal yang sudah diputuskan. Sebagai seorang insinyur, Anda tahu bahwa setiap memori yang persisten juga mempunyai risiko: bisa saja salah, lama, terlalu pribadi, terlalu umum, dan tidak dapat diverifikasi.6162Memori yang berguna setidaknya harus memiliki tiga kualitas:6364- asal: dari mana informasi ini berasal?65- tanggal: kapan kebenarannya?66- tujuan: jenis tugas apa yang sebaiknya digunakan?6768Tanpa ketiga hal ini, ingatan menjadi takhayul.6970Saya suka menganggap memori agen sebagai buku kerja, bukan sebagai pikiran ajaib. Ada catatan sementara, keputusan yang dikonfirmasi, preferensi gaya, kendala teknis, tautan ke sumber. Beberapa hal kedaluwarsa. Beberapa perlu ditulis ulang. Beberapa harus dihilangkan karena agen salah menyimpulkannya.7172Sistem yang baik harus membuat pemeliharaan ini normal. Tidak heroik.7374## Pengambilan dan alat bukanlah hal yang sama7576Ketika kita berbicara tentang konteks, sering kali kita langsung tertuju pada RAG. Penyematan, basis data vektor, pemotongan, pemeringkatan ulang.7778Semuanya berguna. Namun pengambilan hanyalah salah satu cara untuk membawa informasi ke model. Dia bukan satu-satunya.7980Agen bisa mendapatkan konteks dengan membaca file, menanyakan API, memanggil server MCP, membuka browser, menjalankan pengujian, mencari di Slack, melihat dasbor, bertanya kepada manusia.8182Bagian yang menarik adalah menentukan rute mana yang akan digunakan dan kapan.8384Jika agen perlu menjawab pertanyaan historis, mungkin pengambilan saja sudah cukup. Jika dia harus memperbaiki bug, dia harus membaca kode sebenarnya. Jika dia perlu memahami mengapa penerapan gagal, dia perlu melihat log baru. Jika Anda perlu menulis surat kepada pelanggan, Anda perlu mengetahui nada, riwayat, dan status tiket. Jika dia harus bertindak dalam produksi, dia harus meminta izin.8586Konteks bukanlah database. Ini adalah alur kerja.8788## Agen yang baik juga tahu cara mengabaikannya8990Tanda kedewasaan agen adalah kemampuan untuk mengatakan: Saya tidak memerlukan informasi ini.9192Kelihatannya sepele, namun sangat sulit. Banyak sistem agen yang terakumulasi. Setiap panggilan alat menambahkan teks. Setiap kesalahan tetap berada di buffer. Setiap file yang dibaca menambah tumpukan. Pada akhirnya model tersebut memiliki sejarah yang sangat panjang dan tidak ada petanya.9394Kompresi diperlukan. Sintesis perantara diperlukan. Itu perlu terstruktur.9596Bukan "hanya itu yang terjadi", tetapi:9798- objektif masih berlaku;99- hipotesis saat ini;100- file sudah diperiksa;101- keputusan yang diambil;102- risiko terbuka;103- tindakan selanjutnya.104105Hal ini membuat agen tidak terlalu teatrikal dan lebih membantu. Bukan karena dia terlihat lebih pintar, tapi karena dia bekerja dengan meja yang rapi.106107## Rekayasa konteks untuk tim, bukan untuk seniman yang cepat108109Alasan mengapa topik ini menarik minat saya adalah karena topik ini mengalihkan tanggung jawab dari individu ke sistem.110111Dalam rekayasa cepat, orang yang paling bisa berbicara dengan model sering kali menang. Dalam rekayasa konteks, tim yang paling baik mengatur pekerjaannya adalah pemenangnya: dokumentasi, konvensi, isu, log, pengujian, kepemilikan, penamaan, sumber.112113Repositori yang bersih menjadi konteks yang lebih baik. Masalah yang ditulis dengan baik akan menjadi bahan bakar yang lebih baik. Runbook yang diperbarui menghemat token dan kecemasan. Changelog yang jelas mengurangi halusinasi.114115Ini adalah berita baik dan agak tidak menyenangkan. Indah karena menghargai praktik yang baik. Tidak nyaman karena Anda tidak dapat menyelesaikan semuanya dengan perintah yang cerdas.116117Agen memperkuat kebersihan sistem yang mereka temukan.118119## Bagaimana saya akan menerapkannya besok120121Jika saya memperkenalkan rekayasa konteks ke dalam proyek nyata, saya akan mulai dari hal-hal kecil:122123- file instruksi proyek yang singkat dan terpelihara;124- contoh yang baik mengenai keluaran yang diharapkan;125- daftar alat yang tersedia dan kasus penggunaannya;126- keputusan arsitektur ditulis dengan cara yang dapat dikutip;127- terbitan dengan konteks wajib minimum;128- mudah untuk mengambil log dan tes;129- memori persisten yang dapat dimodifikasi oleh manusia.130131Lalu saya akan mengukur hal sederhana: berapa kali agen harus meminta klarifikasi atau pergi ke arah yang salah?132133Jika ini sering terjadi, saya tidak akan langsung menambahkan model yang lebih besar. Saya akan melihat konteksnya.134135## Bacaan saya136137Rekayasa konteks adalah kata yang berlebihan, ya. Tapi konsepnya masuk akal.138139Hal ini mengingatkan kita bahwa kecerdasan seorang agen tidak hanya terletak pada modelnya saja. Letaknya pada lingkungan yang kita persiapkan untuknya: apa yang dilihatnya, apa yang diingatnya, apa yang boleh ia lakukan, apa yang dilarang ia lakukan, sumber mana yang ia akui benar.140141Bagian kemanusiaannya adalah: mempersiapkan konteks dengan baik adalah salah satu bentuk kepedulian. Ini memberi tahu agen, tetapi juga tim, "Saya tidak ingin Anda menebak-nebak, saya ingin Anda mendapatkan apa yang Anda butuhkan."142143Kurang ajaib. Kamar yang lebih bersih. Agen membutuhkannya sama seperti kita.144145## Sumber146147- [Blog LangChain: Bangkitnya rekayasa konteks](https://blog.langchain.com/the-rise-of-context-engineering/)148- [Simon Willison: Rekayasa konteks](https://simonwillison.net/2025/Jun/27/context-engineering/)149- [Protokol Konteks Model: Pendahuluan](https://modelcontextprotocol.io/introduction)150- [Antropik: Membangun agen yang efektif](https://www.anthropic.com/engineering/building- Effective-agents)151- [OpenAI: Alat baru untuk agen bangunan](https://openai.com/index/new-tools-for-building-agents/)152
:Rekayasa konteks: pekerjaan sebelum perintahlines 1-152 (END) — press q to close