Anthropic کے Managed Agents میموری اسٹور سیشنوں کے درمیان متن محفوظ رکھ سکتے ہیں۔ جس ایپ کو دو ایجنٹوں کو ایک ہی جانچی ہوئی حقیقت دینی ہو، اس کے لیے مستقل ذخیرہ صرف پہلا قدم ہے۔ ایپ کو ریکارڈ کا مالک طے کرنا، اصل ثبوت دیکھنا، محفوظ شدہ ایک نظرثانی چننا اور کسی بھی ایجنٹ کے دیکھنے سے پہلے اس کے عین بائٹس محفوظ کرنا ہوں گے۔ یہ رہنما ان ڈویلپرز کے لیے ہے جنہیں مجاز Managed Agents بیٹا رسائی اور ایپ کی توثیق، اسٹور انتخاب اور ایجنٹ ترتیب کا اختیار حاصل ہے۔ اس کی بنیاد Anthropic کی موجودہ میموری دستاویزات اور 20 اکتوبر 2026 کو جانچے گئے API حوالے ہیں؛ BIG CHANGE نے اکاؤنٹ یا ماڈل کا ٹیسٹ نہیں چلایا۔

بڑی تبدیلی

  • کیا بدلا: جانچی ہوئی، متعین اقسام والی JSON میموری Managed Agents اسٹور میں رہ سکتی ہے۔ ایپ اس کا ماخذ اور عین محفوظ بائٹس جانچ کر ایک نجی اسنیپ شاٹ منجمد کرتی ہے، پھر میموری اسٹور منسلک کیے بغیر وہی منظور شدہ بائٹس دو الگ مجاز سیشنوں کو بھیجتی ہے۔
  • یہ کیوں اہم ہے: اسٹور کی بعد کی ترمیم ان سیشنوں کے لیے پہلے سے بنے ان پٹ نہیں بدل سکتی۔
  • کن باتوں پر نظر رکھیں: ماخذ کی درستگی، صارف کی اجازت اور جواب کا معیار اب بھی الگ پڑتال چاہتے ہیں۔

شروع کرنے سے پہلے

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

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

1. ریکارڈ ماخذ سے ملا کر منظور کریں

یہ ساختی سانچہ استعمال کریں اور زاویائی قوسین کی ہر قدر حقیقی منظور شدہ ثبوت سے بدلیں۔ یہ نمونہ حقیقت یا دعویٰ کردہ نتیجہ نہیں۔ منظوری سے پہلے مکمل آبجیکٹ ایک عین UTF-8 JSON متن میں سیریلائز کریں۔ جانچنے والا صرف یہ فیلڈز اور اقسام قبول کرے، نامعلوم فیلڈ رد کرے، خالی یا صرف وقفوں والی سٹرنگ قبول نہ کرے، درست UTC وقت کی نشانیاں مانگے، اور kind کو fact، preference یا project_rule اور status کو active، disputed یا superseded تک محدود رکھے۔ صرف active ریکارڈ داخل کیے جا سکتے ہیں۔ منظور شدہ دعویٰ حوالہ کردہ اصل سے ملے، مؤثر تاریخ اور دائرے سمیت۔

JSON
{
  "schemaVersion": "memory-record/v1",
  "recordId": "<opaque stable record ID>",
  "ownerScopeId": "<trusted mapped scope ID>",
  "kind": "<fact | preference | project_rule>",
  "claim": "<precise source-supported claim>",
  "sourceId": "<private original-source ID>",
  "sourceRevision": "<original revision or exact source hash>",
  "sourceQuoteOrPointer": "<minimal permitted quote or stable pointer>",
  "validFrom": "<UTC timestamp>",
  "checkedAt": "<UTC timestamp>",
  "status": "active",
  "reviewerId": "<approved human reviewer ID>",
  "reviewedAt": "<UTC timestamp>"
}

ایپ کی نجی منظوری رسید میں حقیقی منظور کنندہ، مالک کی اجازت، اصل ماخذ اور نظرثانی، دائرہ اور مجاز ایجنٹ، تازگی کا قاعدہ اور ان عین UTF-8 JSON بائٹس کا SHA-256 ہونا چاہیے۔ یہ حقیقی دعوے پر انسانی فیصلہ لکھتی ہے۔ ریکارڈ کی reviewerId سٹرنگ توثیق نہیں۔ غیر حل شدہ تضاد یا غائب اجازت والا ریکارڈ محفوظ نہ کریں۔ Anthropic متن رکھتا ہے؛ اس اسکیما یا دعوے کی سچائی کی تصدیق نہیں کرتا۔

2. محفوظ کریں اور دوبارہ پڑھیں

مجاز ورک اسپیس میں محدود میموری اسٹور بنائیں یا منتخب کریں اور اس کی حقیقی memstore_... ID درج کریں۔ غیر حساس پاتھ استعمال کریں، مثلاً /records/{opaque-record-id}.json۔ درخواست سے پہلے عمل کرنے والا، UTC وقت، ماخذ نظرثانی، منظور شدہ بائٹس کا ہیش، اسٹور اور پاتھ اور pending حالت درج کریں۔ براہ راست میموری اسٹور کال میں agent-memory-2026-07-22 استعمال کریں؛ سیشن کال میں managed-agents-2026-04-01 استعمال ہوتا ہے۔ Anthropic کے مطابق اسٹور درخواست میں دونوں بیٹا ہیڈر ملانے پر HTTP 400 آتا ہے۔ تخلیق کا حوالہ اور میموری کتابچہ SDK کی یہ شکل دکھاتے ہیں؛ نصب SDK موجودہ حوالے سے ملائیں:

Python
mem = client.beta.memory_stores.memories.create(
    store.id,
    path="/records/<opaque-record-id>.json",
    content=approved_json_text,
)

تخلیق موجودہ پاتھ پر نہیں لکھتی۔ واپس آنے والی mem_... ID محفوظ کریں، پھر متعین اسٹور میں /records/ کی فہرست لیں اور ہر next_page کو اگلے page کے طور پر استعمال کریں۔ پہلے سے طے شدہ بنیادی فہرست میں مواد نہیں ہوتا۔ منتخب میموری حاصل کریں اور ID سے پورا متن لیں؛ اسٹور ID، میموری ID، پاتھ، مواد اور content_sha256 کو منظور شدہ بائٹس سے ملائیں۔ جواب اور براہ راست دوبارہ پڑھائی روزنامچے اور رجسٹری میں درج کریں۔ صرف تخلیق کا جواب تکمیل کی پڑتال نہیں۔ جواب غیر یقینی ہو تو نتیجہ طے کرنے سے پہلے عین پاتھ اور ریکارڈ براہ راست دیکھیں؛ تلاش میں نہ ملنا تنہا دوبارہ تخلیق کا جواز نہیں۔

3. منتخب نظرثانی منجمد کریں

ہر آئندہ رن میں کال کرنے والے کی توثیق کریں اور قابل اعتماد رجسٹری سے دائرہ، اسٹور اور منتخب ریکارڈ ID لیں۔ دریافت درکار ہو تو محدود سابقے کے تمام صفحات کی فہرست لیں، پھر منتخب mem_... براہ راست حاصل کریں۔ واپس آنے والے مواد کی UTF-8 انکوڈنگ کا SHA-256 نکالیں، اسے فراہم کنندہ کے content_sha256 اور انسان کے منظور کردہ عین بائٹ ہیش سے ملائیں، پھر JSON دوبارہ جانچیں۔ ریکارڈ ID، مالک کا دائرہ، ماخذ نظرثانی، active حالت، ماخذ کی موجودہ حیثیت اور پہلے سے طے شدہ تازگی حد دیکھیں۔ کوئی پڑتال ناکام ہو تو کچھ نہ بھیجیں۔

حاصل شدہ عین بائٹس ہیش سے پتا پانے والے نجی ذخیرے میں صرف ایک بار لکھیں، خصوصی تخلیق کے ساتھ، مثلاً Python کا open(path, "xb")۔ فائل فوراً دوبارہ پڑھ کر ہیش کریں اور ہر ارسال سے پہلے بھی ایسا کریں۔ موجودہ اسنیپ شاٹ پر کبھی نہ لکھیں۔ جزوی فائل یا اسی پتے پر مختلف بائٹس والی فائل روک اور مطابقت کا تقاضا کرتی ہے۔ اصل منظوری، اسٹور ID، میموری ID، فراہم کنندہ ہیش، اسنیپ شاٹ ہیش اور دائرے کا فیصلہ نجی حصول رسید میں رکھیں۔ ایک بار لکھا اسنیپ شاٹ ایپ کا ڈیزائن ہے، کسی ورژن پر مقید Anthropic ماؤنٹ نہیں۔

4. ایک جیسے بائٹس دو نئے سیشنوں کو دیں

حقیقی مجاز ایجنٹ اور ماحول ID سے ایجنٹ A کا نیا سیشن بنائیں اور اس فیلڈ میں میموری اسٹور کی کوئی اندراج نہ رکھیں: resources۔ تصدیق کریں کہ واپس سیشن کے وسائل، ایجنٹ کے مؤثر آلات اور اسناد اسٹور کا کوئی متبادل راستہ نہ دیتے ہوں۔ Anthropic کی سیشن رہنمائی تخلیق اور user.message بھیجنا الگ بیان کرتی ہے:

Python
session = client.beta.sessions.create(
    agent=approved_agent_id,
    environment_id=approved_environment_id,
)
client.beta.sessions.events.send(
    session.id,
    events=[{"type": "user.message", "content": [{"type": "text", "text": message_text}]}],
)

اس کال events.send سے پہلے نجی اسنیپ شاٹ دوبارہ پڑھ کر ہیش کریں۔ message_text کو واضح «جانچا ہوا ڈیٹا» لیبل، ریکارڈ، ماخذ اور جائزے کی شناختوں، غیر تبدیل شدہ JSON متن اور SHA-256 اور آخر میں اصل سے جواب ملنے والے محدود سوال سے متعین طریقے سے بنائیں۔ دکھائی فیلڈز ایپ کے پیغام کا فارمیٹ ہیں، فراہم کنندہ کے جواب کی فیلڈز نہیں۔ بھیجنے سے پہلے پورے UTF-8 پیغام کے بائٹس اور ہیش، منتخب اسنیپ شاٹ ہیش، مجاز ایجنٹ ID، سیشن ID اور ارسال حالت درج کریں۔ نتیجہ اور حقیقی بھیجے ایونٹ ID یا دستیاب ہو تو ایونٹ فہرست کی دوبارہ پڑھائی رکھیں۔ نامعلوم ارسال نتیجے پر ایونٹ پڑھیں، اندھا دھند دوبارہ نہ بھیجیں۔

ایجنٹ B کے الگ منظور شدہ ID سے دوسرا نیا سیشن بنائیں، اسی طرح اسٹور رسائی کے بغیر۔ وہی ایک بار لکھا اسنیپ شاٹ دوبارہ پڑھیں، بائٹ ہیش جانچیں، B کا مکمل پیغام بنائیں، درج کریں اور بھیجیں۔ سوال یا وصول کنندہ میٹاڈیٹا مختلف ہو سکتا ہے؛ شامل JSON بائٹس اور منظور شدہ ریکارڈ ہیش ایک جیسے ہوں۔ ہر جواب اور آلے کے ایونٹ اصل ماخذ سے دیکھیں۔ معقول جواب یا حوالہ ماڈل کے اندر داخل کردہ متن پر انحصار کا ثبوت نہیں؛ پیغام اور فراہم کنندہ ایونٹ کی رسیدیں بتاتی ہیں کہ ایپ نے کیا دیا۔ کسی سیشن میں فعال ماؤنٹ یا اسٹور کا دوسرا راستہ ہو تو اسے نہ بھیجیں۔

5. ماخذ کے نئے جائزے کے بعد ہی اپ ڈیٹ کریں

اصل بدلے تو موجودہ میموری براہ راست لیں اور مالک کے ساتھ پرانے اور نئے ثبوت ملائیں۔ انسان سے مستحکم ریکارڈ ID، درست دعوے یا ماخذ اشارے، نئی ماخذ نظرثانی اور پڑتال و جائزے کے وقت والے عین متبادل JSON بائٹس منظور کرائیں۔ پرانی رسید اور ہیش رکھیں۔ mem_... ID، موجودہ براہ راست پڑھا content_sha256، مطلوب متبادل ہیش، عمل کرنے والا، منظوری اور منتظر حالت لکھیں۔ دستاویز کردہ مشروط اپ ڈیٹ یوں ہے:

Python
client.beta.memory_stores.memories.update(
    memory_id=memory_id,
    memory_store_id=store_id,
    content=approved_replacement_json_text,
    precondition={"type": "content_sha256", "content_sha256": fresh_old_hash},
)

فراہم کنندہ عین UTF-8 مواد کا ہیش بغیر معمول بندی بناتا ہے۔ عدم مطابقت پر HTTP 409 memory_precondition_failed_error آتا ہے۔ اس جواب یا غیر یقینی نیٹ ورک نتیجے پر فعال میموری پھر لیں اور ضرورت کے مطابق ورژن تاریخ دیکھیں۔ متصادم ماخذ نظرثانیاں ملائیں اور مالک سے ملانے، رد کرنے یا نیا عین متبادل منظور کرنے کو کہیں؛ پرانی لکھائی اندھا دھند نہ دہرائیں۔ کامیابی پر براہ راست حصول سے پاتھ، پورا متبادل متن، ہیش اور میموری ورژن ID کی تصدیق ہو، تب روزنامچہ confirmed بنے۔

جانچی ہوئی نظرثانی سے نیا منظور شدہ اسنیپ شاٹ منجمد کریں۔ اسٹور ماؤنٹ کے بغیر نئے مجاز A اور B سیشن شروع کرکے دونوں ارسال اور ماخذ پڑتالیں دہرائیں۔ پرانے اسنیپ شاٹ نہ بدلیں اور نہ کہیں کہ بھیجے پیغام خود اپ ڈیٹ ہوتے ہیں۔ پچھلا اسنیپ شاٹ آئندہ داخل کرنے کے لیے نااہل نشان زد کریں۔ مالک ریکارڈ واپس لے تو نئے ارسال روکیں اور اس کی تحفظ اور ڈیٹا حذف کرنے کی پالیسی اپنائیں: موجودہ میموری حذف کرنے سے محفوظ ورژن لازماً نہیں مٹتے۔ پورا اسٹور آرکائیو یا حذف کرنا الگ فیصلہ ہے۔

کب کام مکمل مانا جائے

نجی رسیدیں اصل اجازت اور ماخذ نظرثانی کو عین منظور شدہ JSON ہیش سے جوڑیں؛ حقیقی ورک اسپیس، اسٹور، پاتھ اور mem_... شناخت اور تخلیق کی براہ راست دوبارہ پڑھائی؛ ایک ناقابل تبدیلی اسنیپ شاٹ؛ دو الگ مجاز، بغیر ماؤنٹ سیشن ID، ارسال پیغام ہیش اور ماخذ سے جانچے جواب کے ساتھ؛ منظور شدہ مشروط اپ ڈیٹ، نئی براہ راست پڑھائی اور نئے سیشنوں کی پڑتال۔ کوئی کڑی نامعلوم ہو تو پورا عمل نامکمل لکھ کر عین روک وجہ محفوظ کریں۔ چلائیں تو حقیقی سیشن اور آلے کا استعمال اور اکاؤنٹ کا خرچ لکھیں؛ اس دستاویزی رہنما نے بچت یا ماڈل کارکردگی نہیں ناپی۔

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