Kejuruteraan konteks: kerja sebelum gesaan

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

1~
2Perkataan masa kini, dalam dunia kecil ejen AI, ialah kejuruteraan konteks.
3~
4Nampaknya 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.
5~
6Kesakitan adalah ini: model tidak gagal hanya kerana mereka "tidak berfikir". Mereka sering gagal kerana kami menghantar mereka bekerja dengan bilik yang salah.
7~
8Kami 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.
9~
10Gesaan ialah frasa yang anda ucapkan kepadanya. Konteksnya ialah dunia yang anda sediakan di sekelilingnya.
11~
12## Daripada kejuruteraan segera kepada kejuruteraan konteks
13~
14Kejuruteraan segera sering dianggap sebagai menulis. Pilih perkataan yang betul, tanya dengan cara yang betul, tambah contoh, nyatakan format.
15~
16Kejuruteraan konteks lebih dekat dengan seni bina.
17~
18Anda tidak hanya bertanya "bagaimana cara saya merumuskan permintaan?". Ia bertanya:
19~
20- 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?
27~
28Ia adalah perubahan yang halus tetapi besar. Kerana apabila anda bekerja dengan ejen, konteks bukanlah blok statik. Ia berubah pada setiap langkah.
29~
30Ejen 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.
31~
32Ini adalah kejuruteraan.
33~
34## Konteksnya bukan tapak pelupusan sampah
35~
36Templat dengan tetingkap konteks yang besar memberi kami godaan: mari kita masukkan semuanya.
37~
38Ia boleh difahami. Jika saya mempunyai sejuta token, mengapa saya harus memilih?
39~
40Kerana 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.
41~
42Konteks yang baik mempunyai hierarki:
43~
441. 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.
51~
52Tidak 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.
53~
54Kejuruteraan konteks juga bermakna memberi pemberat, bukan hanya data.
55~
56## Ingatan: kurang ingat, ingat lebih baik
57~
58Memori dalam ejen adalah salah satu topik yang paling licin.
59~
60Sebagai 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.
61~
62Ingatan yang berguna harus mempunyai sekurang-kurangnya tiga kualiti:
63~
64- asal: dari mana maklumat ini datang?
65- tarikh: bila ia benar?
66- tujuan: apakah jenis tugas yang patut digunakan?
67~
68Tanpa tiga perkara ini, ingatan menjadi khurafat.
69~
70Saya 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.
71~
72Sistem yang baik mesti menjadikan penyelenggaraan ini normal. Bukan heroik.
73~
74## Pengambilan semula dan alatan bukanlah perkara yang sama
75~
76Apabila kita bercakap tentang konteks, kita sering berakhir dengan serta-merta pada RAG. Pembenaman, pangkalan data vektor, chunking, penarafan semula.
77~
78Semua berguna. Tetapi pengambilan semula hanyalah satu cara untuk membawa maklumat kepada model. Dia bukan seorang sahaja.
79~
80Ejen boleh mendapatkan konteks dengan membaca fail, menanyakan API, memanggil pelayan MCP, membuka penyemak imbas, menjalankan ujian, mencari Slack, melihat papan pemuka, bertanya kepada manusia.
81~
82Bahagian yang menarik ialah menentukan laluan mana yang hendak digunakan dan bila.
83~
84Jika 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.
85~
86Konteks bukan pangkalan data. Ia adalah satu aliran kerja.
87~
88## Ejen yang baik juga tahu mengabaikan
89~
90Tanda kematangan dalam ejen ialah keupayaan untuk berkata: Saya tidak memerlukan maklumat ini.
91~
92Nampak 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.
93~
94Pemampatan diperlukan. Sintesis perantaraan diperlukan. Ia perlu distrukturkan.
95~
96Bukan "itu sahaja yang berlaku", tetapi:
97~
98- objektif masih sah;
99- hipotesis semasa;
100- fail sudah diperiksa;
101- keputusan yang dibuat;
102- risiko terbuka;
103- tindakan seterusnya.
104~
105Ini menjadikan ejen kurang teater dan lebih membantu. Bukan kerana dia kelihatan lebih bijak, tetapi kerana dia bekerja dengan meja yang kemas.
106~
107## Kejuruteraan konteks untuk pasukan, bukan untuk artis segera
108~
109Sebab topik ini menarik minat saya ialah ia mengalihkan tanggungjawab daripada individu kepada sistem.
110~
111Dalam 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.
112~
113Repositori 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.
114~
115Ini 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.
116~
117Ejen menguatkan kebersihan sistem yang mereka temui.
118~
119## Bagaimana saya akan menggunakannya esok
120~
121Jika saya memperkenalkan kejuruteraan konteks ke dalam projek sebenar, saya akan bermula dari perkara kecil:
122~
123- 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.
130~
131Kemudian saya akan mengukur perkara mudah: berapa kali ejen perlu meminta penjelasan atau pergi ke arah yang salah?
132~
133Jika ia kerap berlaku, saya tidak akan menambah model yang lebih besar serta-merta. Saya akan melihat konteksnya.
134~
135## Bacaan saya
136~
137Kejuruteraan konteks adalah perkataan yang agak kembung, ya. Tetapi konsepnya mantap.
138~
139Ia 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.
140~
141Bahagian 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."
142~
143Kurang sihir. Bilik yang lebih bersih. Ejen memerlukannya sama seperti kita.
144~
145## Sumber
146~
147- [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~

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

2Perkataan masa kini, dalam dunia kecil ejen AI, ialah kejuruteraan konteks.

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

6Kesakitan adalah ini: model tidak gagal hanya kerana mereka "tidak berfikir". Mereka sering gagal kerana kami menghantar mereka bekerja dengan bilik yang salah.

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

10Gesaan ialah frasa yang anda ucapkan kepadanya. Konteksnya ialah dunia yang anda sediakan di sekelilingnya.

11~

12## Daripada kejuruteraan segera kepada kejuruteraan konteks

13~

14Kejuruteraan segera sering dianggap sebagai menulis. Pilih perkataan yang betul, tanya dengan cara yang betul, tambah contoh, nyatakan format.

15~

16Kejuruteraan konteks lebih dekat dengan seni bina.

17~

18Anda tidak hanya bertanya "bagaimana cara saya merumuskan permintaan?". Ia bertanya:

19~

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

27~

28Ia adalah perubahan yang halus tetapi besar. Kerana apabila anda bekerja dengan ejen, konteks bukanlah blok statik. Ia berubah pada setiap langkah.

29~

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

31~

32Ini adalah kejuruteraan.

33~

34## Konteksnya bukan tapak pelupusan sampah

35~

36Templat dengan tetingkap konteks yang besar memberi kami godaan: mari kita masukkan semuanya.

37~

38Ia boleh difahami. Jika saya mempunyai sejuta token, mengapa saya harus memilih?

39~

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

41~

42Konteks yang baik mempunyai hierarki:

43~

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

51~

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

53~

54Kejuruteraan konteks juga bermakna memberi pemberat, bukan hanya data.

55~

56## Ingatan: kurang ingat, ingat lebih baik

57~

58Memori dalam ejen adalah salah satu topik yang paling licin.

59~

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

61~

62Ingatan yang berguna harus mempunyai sekurang-kurangnya tiga kualiti:

63~

64- asal: dari mana maklumat ini datang?

65- tarikh: bila ia benar?

66- tujuan: apakah jenis tugas yang patut digunakan?

67~

68Tanpa tiga perkara ini, ingatan menjadi khurafat.

69~

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

71~

72Sistem yang baik mesti menjadikan penyelenggaraan ini normal. Bukan heroik.

73~

74## Pengambilan semula dan alatan bukanlah perkara yang sama

75~

76Apabila kita bercakap tentang konteks, kita sering berakhir dengan serta-merta pada RAG. Pembenaman, pangkalan data vektor, chunking, penarafan semula.

77~

78Semua berguna. Tetapi pengambilan semula hanyalah satu cara untuk membawa maklumat kepada model. Dia bukan seorang sahaja.

79~

80Ejen boleh mendapatkan konteks dengan membaca fail, menanyakan API, memanggil pelayan MCP, membuka penyemak imbas, menjalankan ujian, mencari Slack, melihat papan pemuka, bertanya kepada manusia.

81~

82Bahagian yang menarik ialah menentukan laluan mana yang hendak digunakan dan bila.

83~

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

85~

86Konteks bukan pangkalan data. Ia adalah satu aliran kerja.

87~

88## Ejen yang baik juga tahu mengabaikan

89~

90Tanda kematangan dalam ejen ialah keupayaan untuk berkata: Saya tidak memerlukan maklumat ini.

91~

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

93~

94Pemampatan diperlukan. Sintesis perantaraan diperlukan. Ia perlu distrukturkan.

95~

96Bukan "itu sahaja yang berlaku", tetapi:

97~

98- objektif masih sah;

99- hipotesis semasa;

100- fail sudah diperiksa;

101- keputusan yang dibuat;

102- risiko terbuka;

103- tindakan seterusnya.

104~

105Ini menjadikan ejen kurang teater dan lebih membantu. Bukan kerana dia kelihatan lebih bijak, tetapi kerana dia bekerja dengan meja yang kemas.

106~

107## Kejuruteraan konteks untuk pasukan, bukan untuk artis segera

108~

109Sebab topik ini menarik minat saya ialah ia mengalihkan tanggungjawab daripada individu kepada sistem.

110~

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

112~

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

114~

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

116~

117Ejen menguatkan kebersihan sistem yang mereka temui.

118~

119## Bagaimana saya akan menggunakannya esok

120~

121Jika saya memperkenalkan kejuruteraan konteks ke dalam projek sebenar, saya akan bermula dari perkara kecil:

122~

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

130~

131Kemudian saya akan mengukur perkara mudah: berapa kali ejen perlu meminta penjelasan atau pergi ke arah yang salah?

132~

133Jika ia kerap berlaku, saya tidak akan menambah model yang lebih besar serta-merta. Saya akan melihat konteksnya.

134~

135## Bacaan saya

136~

137Kejuruteraan konteks adalah perkataan yang agak kembung, ya. Tetapi konsepnya mantap.

138~

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

140~

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

142~

143Kurang sihir. Bilik yang lebih bersih. Ejen memerlukannya sama seperti kita.

144~

145## Sumber

146~

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