spinny:~/writing $ vim context-engineering-agents.md
1~2اس لمحے کا لفظ، AI ایجنٹوں کی چھوٹی سی دنیا میں، سیاق و سباق کی انجینئرنگ ہے۔3~4ایسا لگتا ہے کہ ہم نے پہلے ہی کچھ فروخت کرنے کے لئے ایک اور لیبل ایجاد کیا ہے۔ جزوی طور پر یہ ہے۔ تاہم، جیسا کہ اکثر ہوتا ہے، لیبل اس لیے پکڑتا ہے کیونکہ یہ ایک حقیقی درد کو ایک نام دیتا ہے۔5~6درد یہ ہے: ماڈل صرف اس وجہ سے ناکام نہیں ہوتے کہ وہ "سوچتے ہی نہیں"۔ وہ اکثر ناکام ہو جاتے ہیں کیونکہ ہم انہیں غلط کمرے کے ساتھ کام کرنے کے لیے بھیجتے ہیں۔7~8ہم انہیں پرانی ہدایات دیتے ہیں۔ ہم اس سے اہم فائلیں چھپاتے ہیں۔ ہم انہیں ایسی دستاویزات پاس کرتے ہیں جو بہت لمبی ہوتی ہیں اور یہ نہیں بتاتے کہ کیا اہم ہے۔ ہم انہیں بغیر ترجیح کے لاگ دکھاتے ہیں۔ ہم انہیں یہ بتائے بغیر دس ٹولز دیتے ہیں کہ انہیں کب استعمال کرنا ہے۔ پھر ہم حیران ہوتے ہیں اگر ایجنٹ کسی نامعلوم اپارٹمنٹ میں جاگنے والے شخص کی طرح حرکت کرتا ہے۔9~10پرامپٹ وہ جملہ ہے جسے آپ کہتے ہیں۔ سیاق و سباق وہ دنیا ہے جسے آپ اس کے ارد گرد تیار کرتے ہیں۔11~12## فوری انجینئرنگ سے سیاق و سباق کی انجینئرنگ تک13~14فوری انجینئرنگ کو اکثر لکھنے کے بارے میں سوچا جاتا تھا۔ صحیح الفاظ کا انتخاب کریں، صحیح طریقے سے پوچھیں، مثالیں شامل کریں، فارمیٹ کی وضاحت کریں۔15~16سیاق و سباق کی انجینئرنگ فن تعمیر کے قریب ہے۔17~18آپ صرف یہ نہیں پوچھتے کہ "میں درخواست کیسے تیار کروں؟"۔ یہ پوچھتا ہے:19~20- واقعی کس معلومات کی ضرورت ہے؟21- شور کیا ہیں؟22- مکھی پر بازیافت کرنے کی کیا ضرورت ہے؟23- کیا یاد رکھنا چاہئے؟24- کن ٹولز کو بے نقاب کیا جانا چاہئے؟25- کون سی ہدایات مستحکم ہیں اور جو کام پر منحصر ہیں؟26- میں ایجنٹ کو کیسے سمجھاؤں کہ مستند کیا ہے؟27~28یہ ایک لطیف لیکن بہت بڑی تبدیلی ہے۔ کیونکہ جب آپ ایجنٹوں کے ساتھ کام کرتے ہیں تو سیاق و سباق ایک مستحکم بلاک نہیں ہوتا ہے۔ یہ ہر قدم پر بدلتا ہے۔29~30ایجنٹ ایک فائل کھولتا ہے، کچھ سیکھتا ہے، ٹیسٹ چلاتا ہے، غلطی موصول ہوتی ہے، پلان کو اپ ڈیٹ کرتا ہے، کسی ٹول کو کال کرتا ہے، انحصار کا پتہ لگاتا ہے۔ ہر گود کے ساتھ اسے یہ فیصلہ کرنا ہوتا ہے کہ اسے اپنے ساتھ کیا لینا ہے اور کیا چھوڑنا ہے۔31~32یہ انجینئرنگ ہے۔33~34## سیاق و سباق زمینی نہیں ہے۔35~36بڑی سیاق و سباق والی ونڈوز والے ٹیمپلیٹس نے ہمیں ایک آزمائش دی: آئیے سب کچھ اندر ڈال دیں۔37~38بات سمجھ میں آتی ہے۔ اگر میرے پاس ایک ملین ٹوکن ہیں تو میں کیوں انتخاب کروں؟39~40کیونکہ یہاں تک کہ جب آپ سب کچھ ڈال سکتے ہیں، اس کا مطلب یہ نہیں ہے کہ سب کچھ مدد کرتا ہے۔ بے شک، شور کی ایک قیمت ہوتی ہے۔ اس پر ٹوکن لاگت آتی ہے، اس پر توجہ کی لاگت آتی ہے، اس میں تاخیر خرچ ہوتی ہے، اس کے معیار کی قیمت ہوتی ہے۔ ایک ماڈل ہماری طرح غیر متعلقہ تفصیلات میں کھو سکتا ہے جب ہم بیس ٹیبز کھولتے ہیں اور اب یاد نہیں رہتا کہ کیوں۔41~42اچھے سیاق و سباق کا ایک درجہ بندی ہے:43~441. نظام کی ہدایات اور پالیسیاں؛452. مخصوص مقصد؛463. موجودہ حیثیت؛474. متعلقہ ڈیٹا؛485. رکاوٹیں؛496. دستیاب اوزار؛507. پہلے سے کیے گئے فیصلوں کو ٹریک کریں۔51~52ہر چیز کا ایک ہی سطح پر علاج کرنے کی ضرورت نہیں ہے۔ صارف کمانڈ کی قیمت پرانے نوٹ سے زیادہ ہے۔ ایک ناکام ٹیسٹ اب تین مہینے پہلے کی جمالیاتی ترجیح سے زیادہ قابل قدر ہے۔ سیکیورٹی پالیسی کی قیمت پروڈکشن شارٹ کٹ سے زیادہ ہے۔53~54سیاق و سباق کی انجینئرنگ کا مطلب وزن دینا بھی ہے، نہ کہ صرف ڈیٹا۔55~56## یادداشت: کم یاد رکھیں، بہتر یاد رکھیں57~58ایجنٹوں میں میموری سب سے زیادہ پھسلنے والے موضوعات میں سے ایک ہے۔59~60بطور صارف، آپ چاہتے ہیں کہ ایجنٹ آپ کو جانے۔ آپ چاہتے ہیں کہ وہ لہجہ، منصوبہ، کنونشن، پہلے سے طے شدہ چیزیں یاد رکھے۔ ایک انجینئر کے طور پر، آپ جانتے ہیں کہ ہر مستقل یادداشت بھی ایک خطرہ ہے: یہ غلط، پرانی، بہت ذاتی، بہت عام، ناقابل تصدیق ہو سکتی ہے۔61~62مفید میموری میں کم از کم تین خصوصیات ہونی چاہئیں۔63~64- ثبوت: یہ معلومات کہاں سے آتی ہے؟65- تاریخ: یہ کب سچ تھا؟66- مقصد: اسے کس قسم کے کام کے لیے استعمال کیا جانا چاہیے؟67~68ان تین چیزوں کے بغیر یادداشت توہم پرستی بن جاتی ہے۔69~70میں ایجنٹ میموری کو ایک ورک بک کے طور پر سوچنا پسند کرتا ہوں، جادوئی ذہن کے طور پر نہیں۔ عارضی نوٹ، تصدیق شدہ فیصلے، طرز کی ترجیحات، تکنیکی رکاوٹیں، ذرائع کے لنکس ہیں۔ کچھ چیزیں ختم ہوجاتی ہیں۔ کچھ کو دوبارہ لکھنے کی ضرورت ہے۔ کچھ کو ختم کر دینا چاہیے کیونکہ ایجنٹ نے ان کا غلط اندازہ لگایا۔71~72ایک اچھے نظام کو اس دیکھ بھال کو معمول بنانا چاہیے۔ بہادر نہیں۔73~74## بازیافت اور اوزار ایک ہی چیز نہیں ہیں۔75~76جب ہم سیاق و سباق کے بارے میں بات کرتے ہیں، تو ہم اکثر فوری طور پر RAG پر ختم ہو جاتے ہیں۔ ایمبیڈنگ، ویکٹر ڈیٹا بیس، چنکنگ، رینکنگ۔77~78تمام مفید۔ لیکن بازیافت ماڈل تک معلومات لانے کا صرف ایک طریقہ ہے۔ وہ اکیلا نہیں ہے۔79~80ایک ایجنٹ فائلوں کو پڑھ کر، API سے استفسار کر کے، MCP سرور کو کال کر کے، براؤزر کھول کر، ٹیسٹ چلا کر، Slack کو تلاش کر کے، ڈیش بورڈ کو دیکھ کر، انسان سے پوچھ کر سیاق و سباق حاصل کر سکتا ہے۔81~82دلچسپ حصہ یہ فیصلہ کر رہا ہے کہ کون سا راستہ استعمال کرنا ہے اور کب۔83~84اگر ایجنٹ کو کسی تاریخی سوال کا جواب دینے کی ضرورت ہے، تو شاید صرف بازیافت ہی کافی ہے۔ اگر اسے کوئی بگ ٹھیک کرنا ہے تو اسے اصلی کوڈ پڑھنا ہوگا۔ اگر اسے یہ سمجھنے کی ضرورت ہے کہ تعیناتی کیوں ناکام ہوتی ہے، تو اسے تازہ نوشتہ جات کو دیکھنے کی ضرورت ہے۔ اگر آپ کو کسی گاہک کو لکھنے کی ضرورت ہے، تو آپ کو ٹکٹ کا لہجہ، تاریخ اور حیثیت دوبارہ حاصل کرنے کی ضرورت ہے۔ اگر اسے پیداوار پر عمل کرنا ہے تو اسے اجازت لینا ہوگی۔85~86سیاق و سباق ڈیٹا بیس نہیں ہے۔ یہ ایک ورک فلو ہے۔87~88## اچھا ایجنٹ نظر انداز کرنا بھی جانتا ہے۔89~90ایجنٹوں میں پختگی کی علامت یہ کہنے کی صلاحیت ہوگی: مجھے اس معلومات کی ضرورت نہیں ہے۔91~92یہ معمولی لگتا ہے، لیکن یہ بہت مشکل ہے. بہت سے ایجنٹی نظام جمع ہوتے ہیں۔ ہر ٹول کال متن کا اضافہ کرتی ہے۔ ہر خرابی بفر میں رہتی ہے۔ پڑھنے والی ہر فائل اسٹیک میں اضافہ کرتی ہے۔ آخر میں ماڈل کی ایک بہت لمبی تاریخ ہے اور کوئی نقشہ نہیں ہے۔93~94کمپریشن کی ضرورت ہے۔ درمیانی ترکیب کی ضرورت ہے۔ اسے ڈھانچہ بنانے کی ضرورت ہے۔95~96"یہ سب کچھ ہوا" نہیں، لیکن:97~98- مقصد اب بھی درست ہے؛99- موجودہ مفروضہ؛100- فائلیں پہلے ہی چیک کی گئی ہیں۔101- فیصلے کیے؛102- کھلے خطرات؛103- اگلی کارروائی۔104~105یہ ایجنٹ کو کم تھیٹر اور زیادہ مددگار بناتا ہے۔ اس لیے نہیں کہ وہ زیادہ ہوشیار لگتا ہے، بلکہ اس لیے کہ وہ ایک صاف میز کے ساتھ کام کرتا ہے۔106~107## ٹیموں کے لیے سیاق و سباق کی انجینئرنگ، فوری فنکاروں کے لیے نہیں۔108~109اس موضوع میں میری دلچسپی کی وجہ یہ ہے کہ یہ فرد سے نظام کی ذمہ داری کو منتقل کرتا ہے۔110~111فوری انجینئرنگ میں، جو ماڈل سے بہترین بات کر سکتا ہے وہ اکثر جیت جاتا ہے۔ سیاق و سباق کی انجینئرنگ میں، وہ ٹیم جو اپنے کام کو بہترین طریقے سے منظم کرتی ہے جیت جاتی ہے: دستاویزات، کنونشنز، مسائل، لاگز، ٹیسٹ، ملکیت، نام، ذرائع۔112~113ایک صاف ذخیرہ ایک بہتر سیاق و سباق بن جاتا ہے۔ ایک اچھی طرح سے لکھا ہوا مسئلہ بہتر ایندھن بن جاتا ہے۔ ایک اپ ڈیٹ شدہ رن بک ٹوکن اور پریشانی کو بچاتی ہے۔ ایک واضح چینج لاگ ہیلوسینیشن کو کم کرتا ہے۔114~115یہ اچھی اور کسی حد تک تکلیف دہ خبر ہے۔ خوبصورت کیونکہ یہ اچھے طریقوں کا بدلہ دیتا ہے۔ تکلیف دہ ہے کیونکہ آپ ہوشیار اشارہ سے ہر چیز کو حل نہیں کرسکتے ہیں۔116~117ایجنٹس نظام کی حفظان صحت کو بڑھا دیتے ہیں جو انہیں ملتا ہے۔118~119## میں کل اسے کیسے اپلائی کروں گا۔120~121اگر میں ایک حقیقی پروجیکٹ میں سیاق و سباق کی انجینئرنگ کو متعارف کرانا چاہتا ہوں، تو میں چھوٹی چیزوں سے شروع کروں گا:122~123- ایک مختصر اور برقرار رکھے ہوئے پروجیکٹ انسٹرکشن فائل؛124- متوقع پیداوار کی اچھی مثالیں؛125- دستیاب ٹولز اور کیسز کی ایک فہرست جس میں انہیں استعمال کرنا ہے۔126- آرکیٹیکچرل فیصلے قابل ذکر انداز میں لکھے گئے ہیں؛127- کم از کم لازمی سیاق و سباق کے ساتھ مسئلہ؛128- نوشتہ جات اور ٹیسٹ بازیافت کرنے میں آسان؛129- مستقل میموری کو انسانوں کے ذریعہ تبدیل کیا جاسکتا ہے۔130~131پھر میں ایک سادہ چیز کی پیمائش کروں گا: ایجنٹ کو کتنی بار وضاحت طلب کرنی پڑتی ہے یا غلط سمت میں جاتا ہے؟132~133اگر یہ اکثر ہوتا ہے، تو میں ابھی ایک بڑا ماڈل شامل نہیں کروں گا۔ میں سیاق و سباق کو دیکھوں گا۔134~135## میرا پڑھنا136~137سیاق و سباق انجینئرنگ تھوڑا سا پھولا ہوا لفظ ہے، ہاں۔ لیکن تصور درست ہے۔138~139یہ ہمیں یاد دلاتا ہے کہ ایجنٹ کی ذہانت صرف ماڈل میں نہیں ہوتی۔ یہ اس ماحول میں مضمر ہے جسے ہم اس کے لیے تیار کرتے ہیں: وہ کیا دیکھتا ہے، کیا یاد رکھتا ہے، وہ کیا کرسکتا ہے، اسے کیا کرنے سے منع کیا گیا ہے، وہ کن ذرائع کو سچ تسلیم کرتا ہے۔140~141انسانی حصہ یہ ہے: سیاق و سباق کو اچھی طرح سے تیار کرنا دیکھ بھال کی ایک شکل ہے۔ یہ ایجنٹ بلکہ ٹیم کو بھی کہہ رہا ہے، "میں نہیں چاہتا کہ آپ اندازہ لگائیں، میں چاہتا ہوں کہ آپ کے پاس وہ ہو جس کی آپ کو ضرورت ہے۔"142~143کم جادو۔ صاف ستھرا کمرہ۔ ایجنٹوں کو اس کی اتنی ہی ضرورت ہے جتنی ہمیں ہے۔144~145## ذرائع146~147- [LangChain بلاگ: سیاق و سباق کی انجینئرنگ کا عروج](https://blog.langchain.com/the-rise-of-context-engineering/)148- [سائمن ولیسن: سیاق و سباق انجینئرنگ](https://simonwillison.net/2025/Jun/27/context-engineering/)149- [ماڈل سیاق و سباق پروٹوکول: تعارف](https://modelcontextprotocol.io/introduction)150- [انتھروپک: موثر ایجنٹس بنانا](https://www.anthropic.com/engineering/building-effective-agents)151- [OpenAI: عمارت کے ایجنٹوں کے لیے نئے ٹولز](https://openai.com/index/new-tools-for-building-agents/)152~
NORMAL · context-engineering-agents.md [readonly]152 lines · :q to close