ایک جگہ جہاں نافذ حقیقت طے ہوتی ہے

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

فرض کریں کہ انوائس INV-2041 میں ادائیگی کی تاریخ 22 اکتوبر درج ہے، پھر سپلائر کی بعد میں آنے والی ای میل اسے 29 اکتوبر کر دیتی ہے۔ ایک ایجنٹ انوائس پڑھتا ہے، دوسرا ای میل پڑھتا ہے، اور تیسرا جو کچھ اسے ملتا ہے اس کی بنیاد پر ہفتے کی ادائیگیاں تیار کرتا ہے۔ پہلا 22 اکتوبر بتاتا ہے، دوسرا 29 اکتوبر، اور تیسرا وہ تاریخ بتاتا ہے جو اسے پہلے ملی۔ اس انتظام میں کوئی چیز یہ نہیں طے کرتی کہ کون سی تاریخ نافذ ہے، اس لیے ایجنٹوں کو چلانے والے شخص کو خود پڑتال کرنا پڑتی ہے۔

اس مخصوص انوائس کی مثال میں نے گھڑی ہے، لیکن اس کے پیچھے کا انتظام حقیقی ہے۔ میں ایک Neotoma انسٹینس کے ساتھ تین ٹولز میں ایجنٹ چلاتا ہوں۔ ای میل دیکھنے والا عمل آنے والے پیغامات کو ان کے ماخذ کے ساتھ محفوظ کرتا ہے اور جن پیغامات پر کارروائی درکار ہو انہیں کاموں میں بدل دیتا ہے؛ Claude Code، Codex اور Cursor کے سیشن وہی کام اور منصوبے اٹھاتے ہیں۔ یہی انتظام، اور Neotoma کو ایک جامع نظامِ ریکارڈ بنانے کا میرا کام، اس مضمون کا نقطۂ آغاز ہیں۔

یادداشت کسی اور کام میں اچھی ہے

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

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

اس سال کے آغاز میں میں نے Neotoma کو یادداشت کی تہہ اور سچائی کی تہہ کہا تھا۔ پھر میں نے یہ کہنا چھوڑ دیا، کیونکہ مجھے لگا کہ Neotoma کے لیے ”یادداشت“ غلط زمرہ ہے: یہ ابہام پیدا کرتی ہے، اور لوگ Neotoma کا موازنہ یادداشت کی مصنوعات سے کرتے رہے۔ مجھے چاہیے کہ ایجنٹ بہت سی قسم کی چیزوں کے بارے میں درست ڈیٹا، ایسی شکل میں، محفوظ رکھے جس کی جانچ ہو سکے۔ اسے محفوظ رکھنے کی جگہ کا سیدھا نام نظامِ ریکارڈ ہے۔

نظامِ ریکارڈ سے میری مراد وہ جگہ ہے جو بتاتی ہے کہ اب کیا نافذ ہے، وہ کہاں سے آیا اور اس نے کس چیز کی جگہ لی۔ مشابہت کی بنیاد پر تلاش ان سوالوں کا جواب نہیں دے سکتی، کیونکہ مشابہت نہ وقت بتاتی ہے نہ ماخذ۔

Neotoma آج کیا کرتا ہے

میں AI ایجنٹوں کے لیے نظامِ ریکارڈ Neotoma بناتا ہوں۔ یہ MIT لائسنس کے تحت کھلا ماخذ ہے اور آپ کی منتخب کردہ ڈیٹا ڈائریکٹری میں مقامی طور پر چلتا ہے۔ آگے وہ کچھ بیان ہے جو شائع شدہ پیکیج (npm پر 0.25.0) آج کرتا ہے۔

ہر تحریر کو ایک نئے مشاہدے کے طور پر محفوظ کیا جاتا ہے، جو اپنے ماخذ سے منسلک ہوتا ہے۔ نئی قدر پرانی قدر کو مٹانے کے بجائے اس کے ساتھ شامل کی جاتی ہے۔ Neotoma اصل PDF یا ای میل کو اس سے اخذ کردہ ساختہ اکائیوں کے ساتھ محفوظ کر سکتا ہے، اور مشاہدات کا اپنے ماخذ سے تعلق قائم رکھتا ہے۔

مشاہدات اکائیوں سے متعلق ہوتے ہیں۔ کسی اکائی کی ID اس کی قسم اور شناخت کرنے والے خانوں سے اخذ ہوتی ہے۔ ایک ہی انسٹینس میں اور شناخت کے ایک جیسے قواعد کے تحت، شناخت کی ایک جیسی قدریں متعین طریقے سے ایک ہی ID بناتی ہیں، لہٰذا ایک ہی انوائس محفوظ کرنے والے دو ایجنٹ ایک ہی اکائی میں لکھتے ہیں۔

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

Neotoma ہر خانے کے لیے اسکیما کے ادغام کا قاعدہ خود لاگو کرتا ہے تاکہ مشاہدات سے اس کی موجودہ قدر نکالے۔ زیادہ تر خانوں میں تازہ ترین مشاہدہ غالب آتا ہے۔ اگر مشاہدات اور ادغام کے قواعد ایک جیسے ہوں تو یکجائی کا عمل ایک ہی اسنیپ شاٹ بناتا ہے؛ ہر بار پڑھتے وقت ماڈل سے دوبارہ انتخاب نہیں کرانا پڑتا۔

ہر موجودہ خانہ اس مشاہدے کی نشاندہی کرتا ہے جس نے اس کی قدر مقرر کی، اور محفوظ شدہ مشاہدہ اپنا ماخذ بتاتا ہے۔ یہ ثبوت تک پہنچنے کی راہ ہے، اس بات کا ثبوت نہیں کہ ایجنٹ نے اسے درست پڑھا تھا۔ تصحیح ایک اور مشاہدہ ہے، ترمیم نہیں؛ پرانی قدر فہرست میں رہتی ہے۔ آپ کسی اکائی کو اس شکل میں بھی پڑھ سکتے ہیں جس میں Neotoma نے اسے پہلے کسی وقت درج کیا تھا۔

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

ایجنٹ MCP سرور، REST API اور CLI کے ذریعے Neotoma تک پہنچتے ہیں۔ تنصیب کی رہنمائی بتاتی ہے کہ معاونت یافتہ ٹولز اور ماحول کیسے جوڑے جائیں۔ ریکارڈ بانٹنے کے لیے ہر ٹول کو ایک ہی انسٹینس اور ڈیٹا پروفائل، یا ایک ہی MCP داخلے، کی طرف موڑیں؛ الگ داخلے الگ ڈیٹابیس استعمال کر سکتے ہیں۔

لوگ ساتھ آنے والی Neotoma ایپ میں اپنے ریکارڈ دیکھ سکتے ہیں۔

ایک منظور شدہ دستخط شدہ درخواست تصدیق شدہ ایجنٹ شناخت قائم کر سکتی ہے۔ فعال اور محدود دائرے کی اجازتیں طے کرتی ہیں کہ کون سے اقدامات جائز ہیں؛ صرف دستخط اجازت نہیں ہیں۔

آگے کا رخ

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

• ہر شعبے کے لیے واضح ذمہ دار مقرر کرنا، جسے اسی شعبے کے ریکارڈ درست کرنے کا محدود اختیار ہو۔
• متقابل دعووں، حل طلب اختلافات اور سرکاری مؤقف کو واضح طور پر ظاہر کرنا۔
• دکھانا کہ کوئی قدر کیوں نافذ ہے، وہ کس کے اختیار کی پیروی کرتی ہے اور تبدیلی کا اثر کہاں پڑے گا۔

Ateles اس رخ کو عملی پہلو سے آگے بڑھاتا ہے۔ Ateles کے اڈاپٹر ڈیزائن میں اڈاپٹر ای میل، کیلنڈر اور کوڈ ہوسٹس جیسے نظاموں سے معلومات Neotoma میں لاتے ہیں، اور مجاز اقدامات واپس انہی نظاموں تک لے جاتے ہیں۔ Neotoma ریکارڈ محفوظ کرتا ہے؛ منسلک ٹولز کام انجام دیتے ہیں۔

مکمل تصور اور اس کے ہر حصے کی آج کی حالت README میں موجود ہے۔

نظامِ ریکارڈ، صرف بازیافت نہیں

جواب بہتر انڈیکس نہیں ہے۔ بازیافت ایجنٹ کو پہلے کہی گئی بات ڈھونڈنے میں مدد دیتی ہے۔ نظامِ ریکارڈ اسے بتاتا ہے کہ اس وقت کیا نافذ ہے۔ کئی ٹولز میں کام کرنے والے ایجنٹوں کو دوسری چیز چاہیے، ایسی جگہ جہاں سب پہنچ سکیں۔ اور نظامِ ریکارڈ تبھی مدد دیتا ہے جب ایجنٹ اس میں لکھیں اور اس سے پڑھیں۔

اگر آپ ایک سے زیادہ ٹول یا ماحول میں ایجنٹ چلاتے ہیں تو ایسے کام کے سلسلے سے شروع کریں جس کے حقائق اور اکائیاں آپس میں متعلق ہوں:

npm install -g neotoma
neotoma init
neotoma setup --tool claude-code

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

تنصیب کی رہنمائی neotoma.io/install پر ہے۔ کوڈ اور مسئلہ ٹریکر GitHub پر github.com/markmhendrickson/neotoma میں ہیں۔