ورک اسپیس میموری منظم کریں

یہ گائیڈ بتاتی ہے کہ ورک اسپیس کے علم کے اسٹور کے ساتھ کیسے کام کیا جائے۔

شروع کرنے سے پہلے ایک اہم بات جان لیں: میموری کا UI جائزے کی سطح ہے، تحریر کی نہیں۔ فیکٹس اور پالیسیاں ایجنٹس لکھتے ہیں — propose_fact اور propose_policy کے ذریعے، اور ان کی جگہ لینے کے لیے supersede_fact اور supersede_policy موجود ہیں۔ remember سیشن تک محدود ہاٹ ٹیئر آئٹم لکھتا ہے جسے consolidate_memory بعد میں فیکٹ کا درجہ دے سکتا ہے۔ ریکارڈ شدہ میٹنگ فیصلے decisions ڈومین میں اکٹھے کیے جاتے ہیں؛ مکمل ہو چکے ایجنٹ رنز پر کوئی اکٹھا کرنے کا عمل نہیں ہوتا۔ یہاں آپ جو کرتے ہیں وہ یہ ہے کہ اُن کی لکھی ہوئی بات پڑھیں، درست کریں، غیر فعال کریں یا حذف کریں۔

میموری ترتیبات → ورک اسپیس → میموری پر ہے (/workspaces/<id>/settings/memory)۔ یہ سائیڈ بار کی کوئی اعلیٰ سطح کی منزل نہیں ہے۔

تین ٹیبز

صفحے پر بالکل تین ٹیبز ہیں۔ فیکٹس اور پالیسیاں لائیو گنتی دکھاتے ہیں؛ گراف نہیں:

فیکٹس — ورک اسپیس کی ہر فیکٹ، ساتھ اُن کی گنتی جو منسوخ نہیں ہوئیں
پالیسیاں — ڈومین کے لحاظ سے گروپ شدہ معیاری قواعد، ساتھ ایکٹو پالیسیوں کی گنتی
نالج گراف — ڈومینز، موضوعات، فیکٹس اور پالیسیوں کا متعامل کینوس

ڈومینز کوئی ایسی چیز نہیں جو آپ بنائیں۔ کوئی ڈومین اُس وقت وجود میں آتا ہے جب کوئی ایجنٹ اس میں پہلی فیکٹ یا پالیسی لکھتا ہے؛ UI میں کہیں ڈومین بنانے کا کوئی کنٹرول نہیں ہے۔

کسی فیکٹ کا جائزہ لیں اور اسے درست کریں

فیکٹس ٹیب کھولیں۔
فہرست مختصر کرنے کے لیے تلاش کا باکس استعمال کریں۔ یہ ہر فیکٹ کے ڈومین، موضوع اور مواد پر ایک سادہ سب اسٹرنگ فلٹر ہے — نہ کوئی کلیدی لفظ انڈیکس، نہ درجہ بندی۔
دائرے کا فلٹر استعمال کریں تاکہ تمام دائرے، صرف پورے ورک اسپیس کی فیکٹس، یا کسی ایک ریپوزٹری کی فیکٹس دکھائی جائیں۔
ترتیب بدلنے والا ٹوگل استعمال کریں تاکہ تازگی یا اعتماد کے مطابق ترتیب دی جائے۔
کسی فیکٹ کے ترمیم کنٹرول پر کلک کریں۔

ترمیم کا ڈائلاگ آپ کو یہ تبدیلیاں کرنے دیتا ہے:

ڈومین — فیکٹ کو ایک ڈومین سے دوسرے میں منتقل کرنا
موضوع — اس کا مختصر لیبل
مواد — علم کا متن
اعتماد — 5% قدموں میں ایک سلائیڈر

لکھا ہوا واپس محفوظ کرنے کے لیے محفوظ کریں دبائیں۔ کوئی فیکٹ شامل کریں بٹن نہیں ہے؛ ڈائلاگ صرف کسی موجود قطار پر کھلتا ہے۔

منسوخ شدہ فیکٹس دیکھیں

فیکٹس ٹیب میں منسوخ شدہ دکھائیں سوئچ موجود ہے۔ منسوخ شدہ فیکٹس بطور ڈیفالٹ چھپی رہتی ہیں اور اسی سوئچ سے سامنے آتی ہیں، اور آڈٹ ٹریل یہیں رہتا ہے — منسوخ کرنا کبھی حذف نہیں کرتا۔

کسی فیکٹ کو حذف کریں

کسی فیکٹ کے حذف کنٹرول کا استعمال کریں اور تصدیق کریں۔ یہ حقیقی حذف ہے، منسوخی نہیں: اسے ایسی فیکٹس کے لیے استعمال کریں جو محض غلط ریکارڈ ہوئی تھیں، جبکہ ایسی فیکٹس جن کا مواد آگے بڑھ چکا ہو، انہیں ایجنٹس کے منسوخ کرنے پر چھوڑ دیں۔

پالیسیاں منظم کریں

پالیسیاں ٹیب ایکٹو پالیسیوں کو ڈومین کے لحاظ سے گروپ کرتا ہے اور غیر فعال پالیسیوں کو آخر میں ایک الگ سیکشن میں ڈال دیتا ہے۔ ہر پالیسی کے لیے آپ یہ کر سکتے ہیں:

اس کی ترمیم
اسے حذف کریں
اسے غیر فعال کریں / فعال کریں — یہ واپس پلٹائی جا سکنے والی صورت ہے اور عموماً درست بھی۔ ایجنٹ کے پرامپٹ تک صرف ایکٹو پالیسیاں پہنچتی ہیں۔

فیکٹس کی طرح یہاں بھی بنانے کا کوئی کنٹرول نہیں ہے۔

نالج گراف دریافت کریں

نالج گراف ٹیب ڈومینز، موضوعات، فیکٹس اور پالیسیوں کو نیویگیٹ ہونے والے نوڈ کینوس کی صورت میں بچھا دیتا ہے — پین کریں، زوم کریں، نوڈز گھسیٹیں۔ کسی نوڈ پر ٹیپ کرنے سے اس کی تفصیلی شیٹ کھلتی ہے، جہاں سے وہی ترمیم والے ڈائلاگ قابلِ رسائی ہوتے ہیں۔ یہ دیکھنے کا سب سے تیز طریقہ ہے کہ کون سے ڈومینز واقعی بھرے ہوئے ہیں۔

ایجنٹ کی ورکنگ میموری میں ترمیم کریں

ورکنگ میموری ہر ایجنٹ کا نجی اسکریچ پیڈ ہوتا ہے، جو ڈسپیچ کے وقت اس کے پرامپٹ میں شامل کیا جاتا ہے۔ ایجنٹس اسے خود record_observation اور update_my_notes کے ذریعے لکھتے ہیں، مگر آپ اسے براہِ راست پڑھ اور ترمیم کر سکتے ہیں:

ترتیبات → ورک اسپیس → ایجنٹس → ایجنٹ منتخب کریں → میموری ٹیب۔

رسائی گرانٹس

میموری رسائی گرانٹس ایجنٹ کے کردار کو فی ڈومین ایک اجازت (none، read، write) سے جوڑتی ہیں۔ انہیں memory_access_grant.* اوپریشنز سے لکھیں۔

ان کے لاگو ہونے کے بارے میں دو باتیں سمجھ لینا ضروری ہیں:

ریڈز فیل اوپن ہوتی ہیں۔ کسی (کردار، ڈومین) جوڑے کے لیے کوئی گرانٹ قطار نہ ہونے پر موثر اجازت read ہوتی ہے۔ write کے بغیر استثنا پھینکنے والی واحد رائٹ propose_policy ہے۔ فیکٹ کی رائٹس گرانٹ سے مشروط نہیں ہیں۔
گرانٹس کی کلید ایجنٹ کے کردار پر ہوتی ہے۔ پروپوز کرنے والے ٹولز غائب agent_role کو ڈیفالٹ میں general مانتے ہیں۔ کسی دوسرے کردار کے لیے لکھی گئی گرانٹ اُن ایجنٹس پر لاگو نہیں ہوتی؛ general کی گرانٹ لاگو ہوتی ہے۔

تلاش ہر جگہ ایک جیسی نہیں

تین مختلف چیزوں کو “میموری تلاش” کہا جاتا ہے اور وہ ایک دوسرے سے متفق نہیں:

کہاں	یہ کیا کرتا ہے
فیکٹس ٹیب کا تلاش باکس	کلائنٹ میں پہلے سے لوڈ شدہ فیکٹس پر سب اسٹرنگ فلٹر
`memory_fact.search` RPC اوپ	صرف FTS5 کلیدی لفظ تلاش — ایک ہلکا کلائنٹ کوئری کی ایمبیڈنگ نہیں بھیج سکتا، اس لیے ہائبرڈ تلاش ہوسٹ کے اندر ہی رہتی ہے
ایجنٹ کی طرف کا `search_memory` ٹول	`keyword`، `semantic` یا `hybrid` (ڈیفالٹ)۔ ہائبرڈ چار آوازیں ملاتا ہے: لغوی، معنوی، زمانی اور گراف

چنانچہ ایک ایجنٹ اور میموری کا صفحہ ایک ہی کوئری کو ایک ہی طرح درجہ بند نہیں کریں گے۔ جب آپ یہ جانچ رہے ہوں کہ کوئی ایجنٹ واقعی کیا یاد کر سکتا ہے، تو ایجنٹ سے ہی پوچھیں۔

ایمبیڈنگز

فیکٹس لکھنے کے وقت ایمبیڈ کی جاتی ہیں اور صرف اُس وقت جب ڈیوائس پر موجود ایمبیڈنگ ماڈل انسٹال ہو۔ اس کی اسٹیٹس ترتیبات → سرور → تشخیص اور پرائیویسی → سیمانٹک تلاش کے تحت دیکھیں۔ اگر آپ معنوی ری کال چاہتے ہیں تو ایجنٹس کے میموری لکھنا شروع کرنے سے پہلے ماڈل انسٹال کر لیں۔