Rekayasa konteks: pekerjaan sebelum perintah

spinny:~/writing $ vim context-engineering-agents.md

1~
2Istilah yang ada saat ini, dalam dunia kecil agen AI, adalah rekayasa konteks.
3~
4Sepertinya 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.
5~
6Yang menyakitkan adalah ini: model tidak gagal hanya karena mereka "tidak berpikir". Seringkali mereka gagal karena kami mengirim mereka untuk bekerja dengan ruangan yang salah.
7~
8Kami 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.
9~
10Promptnya adalah frasa yang Anda ucapkan padanya. Konteksnya adalah dunia yang Anda persiapkan di sekitarnya.
11~
12## Dari rekayasa cepat hingga rekayasa konteks
13~
14Rekayasa cepat sering kali dianggap sebagai tulisan. Pilih kata yang tepat, tanyakan dengan cara yang benar, tambahkan contoh, tentukan formatnya.
15~
16Rekayasa konteks lebih dekat dengan arsitektur.
17~
18Anda tidak hanya bertanya “bagaimana cara merumuskan permintaannya?”. Ia bertanya:
19~
20- 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?
27~
28Ini adalah perubahan yang halus namun besar. Karena ketika Anda bekerja dengan agen, konteks bukanlah blok statis. Itu berubah di setiap langkah.
29~
30Agen 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.
31~
32Ini adalah rekayasa.
33~
34## Konteksnya bukan tempat pembuangan sampah
35~
36Templat dengan jendela konteks besar memberi kita godaan: ayo masukkan semuanya.
37~
38Itu bisa dimengerti. Jika saya mempunyai sejuta token, mengapa saya harus memilih?
39~
40Karena 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.
41~
42Konteks yang baik memiliki hierarki:
43~
441. 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.
51~
52Tidak 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.
53~
54Rekayasa konteks juga berarti memberi bobot, bukan sekedar data.
55~
56## Memori: ingat lebih sedikit, ingat lebih baik
57~
58Memori pada agen adalah salah satu topik yang paling licin.
59~
60Sebagai 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.
61~
62Memori yang berguna setidaknya harus memiliki tiga kualitas:
63~
64- asal: dari mana informasi ini berasal?
65- tanggal: kapan kebenarannya?
66- tujuan: jenis tugas apa yang sebaiknya digunakan?
67~
68Tanpa ketiga hal ini, ingatan menjadi takhayul.
69~
70Saya 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.
71~
72Sistem yang baik harus membuat pemeliharaan ini normal. Tidak heroik.
73~
74## Pengambilan dan alat bukanlah hal yang sama
75~
76Ketika kita berbicara tentang konteks, sering kali kita langsung tertuju pada RAG. Penyematan, basis data vektor, pemotongan, pemeringkatan ulang.
77~
78Semuanya berguna. Namun pengambilan hanyalah salah satu cara untuk membawa informasi ke model. Dia bukan satu-satunya.
79~
80Agen bisa mendapatkan konteks dengan membaca file, menanyakan API, memanggil server MCP, membuka browser, menjalankan pengujian, mencari di Slack, melihat dasbor, bertanya kepada manusia.
81~
82Bagian yang menarik adalah menentukan rute mana yang akan digunakan dan kapan.
83~
84Jika 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.
85~
86Konteks bukanlah database. Ini adalah alur kerja.
87~
88## Agen yang baik juga tahu cara mengabaikannya
89~
90Tanda kedewasaan agen adalah kemampuan untuk mengatakan: Saya tidak memerlukan informasi ini.
91~
92Kelihatannya 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.
93~
94Kompresi diperlukan. Sintesis perantara diperlukan. Itu perlu terstruktur.
95~
96Bukan "hanya itu yang terjadi", tetapi:
97~
98- objektif masih berlaku;
99- hipotesis saat ini;
100- file sudah diperiksa;
101- keputusan yang diambil;
102- risiko terbuka;
103- tindakan selanjutnya.
104~
105Hal ini membuat agen tidak terlalu teatrikal dan lebih membantu. Bukan karena dia terlihat lebih pintar, tapi karena dia bekerja dengan meja yang rapi.
106~
107## Rekayasa konteks untuk tim, bukan untuk seniman yang cepat
108~
109Alasan mengapa topik ini menarik minat saya adalah karena topik ini mengalihkan tanggung jawab dari individu ke sistem.
110~
111Dalam 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.
112~
113Repositori 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.
114~
115Ini 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.
116~
117Agen memperkuat kebersihan sistem yang mereka temukan.
118~
119## Bagaimana saya akan menerapkannya besok
120~
121Jika saya memperkenalkan rekayasa konteks ke dalam proyek nyata, saya akan mulai dari hal-hal kecil:
122~
123- 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.
130~
131Lalu saya akan mengukur hal sederhana: berapa kali agen harus meminta klarifikasi atau pergi ke arah yang salah?
132~
133Jika ini sering terjadi, saya tidak akan langsung menambahkan model yang lebih besar. Saya akan melihat konteksnya.
134~
135## Bacaan saya
136~
137Rekayasa konteks adalah kata yang berlebihan, ya. Tapi konsepnya masuk akal.
138~
139Hal 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.
140~
141Bagian 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."
142~
143Kurang ajaib. Kamar yang lebih bersih. Agen membutuhkannya sama seperti kita.
144~
145## Sumber
146~
147- [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~

NORMAL · context-engineering-agents.md [readonly]152 lines · :q to close

2Istilah yang ada saat ini, dalam dunia kecil agen AI, adalah rekayasa konteks.

4Sepertinya 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.

6Yang menyakitkan adalah ini: model tidak gagal hanya karena mereka "tidak berpikir". Seringkali mereka gagal karena kami mengirim mereka untuk bekerja dengan ruangan yang salah.

8Kami 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.

10Promptnya adalah frasa yang Anda ucapkan padanya. Konteksnya adalah dunia yang Anda persiapkan di sekitarnya.

11~

12## Dari rekayasa cepat hingga rekayasa konteks

13~

14Rekayasa cepat sering kali dianggap sebagai tulisan. Pilih kata yang tepat, tanyakan dengan cara yang benar, tambahkan contoh, tentukan formatnya.

15~

16Rekayasa konteks lebih dekat dengan arsitektur.

17~

18Anda tidak hanya bertanya “bagaimana cara merumuskan permintaannya?”. Ia bertanya:

19~

20- 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?

27~

28Ini adalah perubahan yang halus namun besar. Karena ketika Anda bekerja dengan agen, konteks bukanlah blok statis. Itu berubah di setiap langkah.

29~

30Agen 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.

31~

32Ini adalah rekayasa.

33~

34## Konteksnya bukan tempat pembuangan sampah

35~

36Templat dengan jendela konteks besar memberi kita godaan: ayo masukkan semuanya.

37~

38Itu bisa dimengerti. Jika saya mempunyai sejuta token, mengapa saya harus memilih?

39~

40Karena 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.

41~

42Konteks yang baik memiliki hierarki:

43~

441. 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.

51~

52Tidak 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.

53~

54Rekayasa konteks juga berarti memberi bobot, bukan sekedar data.

55~

56## Memori: ingat lebih sedikit, ingat lebih baik

57~

58Memori pada agen adalah salah satu topik yang paling licin.

59~

60Sebagai 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.

61~

62Memori yang berguna setidaknya harus memiliki tiga kualitas:

63~

64- asal: dari mana informasi ini berasal?

65- tanggal: kapan kebenarannya?

66- tujuan: jenis tugas apa yang sebaiknya digunakan?

67~

68Tanpa ketiga hal ini, ingatan menjadi takhayul.

69~

70Saya 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.

71~

72Sistem yang baik harus membuat pemeliharaan ini normal. Tidak heroik.

73~

74## Pengambilan dan alat bukanlah hal yang sama

75~

76Ketika kita berbicara tentang konteks, sering kali kita langsung tertuju pada RAG. Penyematan, basis data vektor, pemotongan, pemeringkatan ulang.

77~

78Semuanya berguna. Namun pengambilan hanyalah salah satu cara untuk membawa informasi ke model. Dia bukan satu-satunya.

79~

80Agen bisa mendapatkan konteks dengan membaca file, menanyakan API, memanggil server MCP, membuka browser, menjalankan pengujian, mencari di Slack, melihat dasbor, bertanya kepada manusia.

81~

82Bagian yang menarik adalah menentukan rute mana yang akan digunakan dan kapan.

83~

84Jika 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.

85~

86Konteks bukanlah database. Ini adalah alur kerja.

87~

88## Agen yang baik juga tahu cara mengabaikannya

89~

90Tanda kedewasaan agen adalah kemampuan untuk mengatakan: Saya tidak memerlukan informasi ini.

91~

92Kelihatannya 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.

93~

94Kompresi diperlukan. Sintesis perantara diperlukan. Itu perlu terstruktur.

95~

96Bukan "hanya itu yang terjadi", tetapi:

97~

98- objektif masih berlaku;

99- hipotesis saat ini;

100- file sudah diperiksa;

101- keputusan yang diambil;

102- risiko terbuka;

103- tindakan selanjutnya.

104~

105Hal ini membuat agen tidak terlalu teatrikal dan lebih membantu. Bukan karena dia terlihat lebih pintar, tapi karena dia bekerja dengan meja yang rapi.

106~

107## Rekayasa konteks untuk tim, bukan untuk seniman yang cepat

108~

109Alasan mengapa topik ini menarik minat saya adalah karena topik ini mengalihkan tanggung jawab dari individu ke sistem.

110~

111Dalam 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.

112~

113Repositori 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.

114~

115Ini 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.

116~

117Agen memperkuat kebersihan sistem yang mereka temukan.

118~

119## Bagaimana saya akan menerapkannya besok

120~

121Jika saya memperkenalkan rekayasa konteks ke dalam proyek nyata, saya akan mulai dari hal-hal kecil:

122~

123- 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.

130~

131Lalu saya akan mengukur hal sederhana: berapa kali agen harus meminta klarifikasi atau pergi ke arah yang salah?

132~

133Jika ini sering terjadi, saya tidak akan langsung menambahkan model yang lebih besar. Saya akan melihat konteksnya.

134~

135## Bacaan saya

136~

137Rekayasa konteks adalah kata yang berlebihan, ya. Tapi konsepnya masuk akal.

138~

139Hal 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.

140~

141Bagian 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."

142~

143Kurang ajaib. Kamar yang lebih bersih. Agen membutuhkannya sama seperti kita.

144~

145## Sumber

146~

147- [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~