Claude Managed Agent میموری اسٹور میں نوٹس سیشنز کے درمیان منتقل کر سکتا ہے، مگر وہ بار بار دہرائے یا پرانے ہو سکتے ہیں۔ Anthropic کا Dreams تحقیقی پیش منظر ایک اسٹور اور پچھلے سیشن پڑھ کر الگ مجوزہ اسٹور بنا سکتا ہے۔ یہ رہنما ضروری رسائی رکھنے والے ڈویلپر کو ایک دستی Dream چلانا، برقرار رکھی گئی معلومات جانچنا اور صرف منظور کردہ میموری بعد کے سیشن سے جوڑنا بتاتا ہے۔

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

بڑی تبدیلی

  • کیا بدلا: Dream موجودہ میموری اسٹور اور منتخب 1–100 سیشنز کے متن کو ان پٹ بدلے بغیر نئے میموری اسٹور میں یکجا کر سکتا ہے۔
  • یہ کیوں اہم ہے: الگ نتیجہ مالک کو نئے یا مختصر نوٹس اصل شواہد سے ملانے کا موقع دیتا ہے، اس سے پہلے کہ دوسرا سیشن انہیں پڑھے۔
  • کس بات پر نظر رکھیں: Dreams کے لیے تحقیقی پیش منظر کی الگ رسائی چاہیے۔ مکمل کام ایک ممکنہ اسٹور بناتا ہے، منظور شدہ حقائق یا ترجیحات کا مجموعہ نہیں۔

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

آپ کو Claude Console اکاؤنٹ اور API کلید، ایجنٹ ٹول سیٹ والا موجودہ Managed Agent، ایک ماحول اور فوری آغاز کے رہنما میں بیان کردہ Managed Agents بیٹا کی رسائی چاہیے۔ ساتھ Dreams تحقیقی پیش منظر کی الگ رسائی بھی چاہیے۔ صرف Managed Agents بیٹا یہ استحقاق ثابت نہیں کرتا۔ درخواست بھیجنے سے پہلے Dreams رسائی کے راستے سے اس کی تصدیق کریں۔

ایک موجودہ میموری اسٹور اور 1–100 حقیقی، متعلقہ، مکمل سیشن منتخب کریں جن کا مواد اکٹھا پراسیس کرنے کی آپ کو اجازت ہے۔ اگر سیشنز کا متن ہے مگر اسٹور نہیں، تو میموری رہنما خالی اسٹور بنانے کا طریقہ بتاتا ہے۔ اس کا نام اور وضاحت محدود دائرے کے مطابق رکھیں۔ منسلک اسٹور پڑھنے یا لکھنے کے لیے ایجنٹ کو دستاویزات میں دیا گیا ٹول سیٹ چاہیے۔ ان پٹ سیشن بناتے وقت اسٹور جوڑیں؛ چلتے سیشن میں اسے بعد میں نہیں بڑھا سکتے۔ read_write صرف اس وقت استعمال کریں جب ایجنٹ کو میموری محفوظ کرنی ہو۔ طے شدہ قدر read_write ہے، اس لیے صرف رجوع کرنے والے مواد کے لیے read_only واضح کریں۔ اندازہ لگانے کے بجائے واپس ملنے والے ریسورس کا mount_path دیکھیں۔

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

کمانڈ مثالیں Bash کے موافق شیل میں چلائیں۔ cURL کو --fail-with-body کی سہولت اور تصحیح و آخری سیشن جانچ کے لیے Python 3 چاہیے۔ PowerShell میں اقتباسی نشان اور ماحولیاتی متغیرات کی ترکیب مختلف ہے، اس لیے کمانڈز ڈھالنی ہوں گی۔ Anthropic کا Python SDK pip install anthropic سے نصب کریں، جیسا فوری آغاز کا رہنما دکھاتا ہے۔ مقرر کریں اور ایکسپورٹ کریں ANTHROPIC_API_KEY اپنے معمول کے راز سنبھالنے کے طریقے سے، تاکہ cURL اور Python SDK دونوں اسے استعمال کر سکیں۔ store_id، session_a، session_b، agent_id اور environment_id کو اپنے ذاتی ورک اسپیس سے ملنے والے ID پر مقرر کریں۔ مثالیں دو سیشن استعمال کرتی ہیں؛ ایک سے زیادہ سے زیادہ 100 حقیقی سیشن ID لیں۔ کلید کو مشترکہ لاگز اور مسودوں میں نہ رکھیں۔ درست بیٹا ہیڈرز اہم ہیں: براہِ راست میموری اسٹور کالز صرف agent-memory-2026-07-22 استعمال کرتی ہیں؛ سیشن کالز managed-agents-2026-04-01؛ Dream کالز managed-agents-2026-04-01 اور dreaming-2026-04-21 دونوں استعمال کرتی ہیں۔ موجودہ مخصوص میموری رہنما کے مطابق میموری اسٹور درخواست میں پہلے دو اکٹھے کرنے پر HTTP 400 ملتا ہے۔ Anthropic SDK متعلقہ ہیڈرز خود مقرر کرتا ہے۔

ایک Dream چلائیں اور اس کی نگرانی کریں

  1. پہلے ان پٹ اسٹور اور منتخب سیشن پڑھیں۔ ان کے حقیقی ID اور اپنے کام سے متعلق میموری کے راستے اور مواد درج کریں۔ ترتیب دینے کا محدود مقصد لکھیں، جیسے دستاویزی منصوبہ جاتی اصول رکھنا اور متروک نوٹس ہٹانا۔ کام ختم ہونے تک اسٹور اور سیشن دستیاب رکھیں۔ چلتے وقت ان پٹ اسٹور آرکائیو یا حذف ہو، یا ان پٹ سیشن حذف ہو، تو Dream ناکام ہو سکتا ہے۔
  2. موجودہ اسٹور اور سیشنز سے Dream بنائیں۔ اس مثال میں دستاویزی ماڈل claude-opus-5-5 ہے؛ Anthropic دوسرے معاون پیش منظر ماڈل بھی درج کرتا ہے۔ اختیاری instructions مجموعی یکجائی کو سمت دے سکتا ہے اور اس کی حد 4,096 حروف ہے۔ میموری میں کسی خاص جملے کی ترمیم کا یہ قابلِ اعتماد طریقہ نہیں۔
Terminal
curl -sS --fail-with-body https://api.anthropic.com/v1/dreams \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21" \
  -H "content-type: application/json" \
  --data '{
    "inputs": [
      {"type": "memory_store", "memory_store_id": "'"$store_id"'"},
      {"type": "sessions", "session_ids": ["'"$session_a"'", "'"$session_b"'"]}
    ],
    "model": "claude-opus-5-5",
    "instructions": "Preserve documented project conventions; drop superseded or one-off notes."
  }'
  1. واپس ملنے والا drm_... ID dream_id کے طور پر محفوظ کریں۔ pending جواب کا مطلب ہے کہ کام بن کر قطار میں چلا گیا ہے۔ اسی ID کو بار بار دیکھیں یہاں تک کہ حالت completed، failed یا canceled ہو:
Terminal
curl -sS --fail-with-body "https://api.anthropic.com/v1/dreams/$dream_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01,dreaming-2026-04-21"

جواب میں status، outputs، usage اور error پڑھیں۔ outputs انتظار کے دوران یا چلنے کے مختصر عرصے میں خالی ہو سکتا ہے؛ محض اسی وجہ سے نیا کام نہ بھیجیں۔ Anthropic کے مطابق کام میں منٹوں سے گھنٹوں تک لگ سکتے ہیں اور منتخب ماڈل کی عام API ٹوکن شرح لاگو ہوتی ہے۔ usage خانہ ٹوکن بتاتا ہے، مگر حتمی فیس اصل استعمال اور قیمتوں پر منحصر ہے۔ اس رہنما کے لیے لاگت یا مکمل ہونے کا وقت نہیں ناپا گیا۔

الگ اسٹور جانچیں اور درست کریں

  1. جب status کی حالت completed ہو جائے، تو memory_store_id لیں، جو memory_store اندراج میں ہے، اور یہ اندراج outputs میں ہوتا ہے۔ اسے output_store_id کے طور پر مقرر کریں۔ اس اسٹور کی میموری فہرست کے لیے میموری بیٹا ہیڈر لگائیں، پھر الگ الگ میموری حاصل کریں جسے جانچنا ہے۔ فہرست کے تمام صفحات دیکھیں اور راستوں و ہیش سمیت پورا مواد پڑھیں۔ Console میں بھی اسٹور دیکھا جا سکتا ہے۔
Terminal
curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories?path_prefix=/" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22"

curl -sS --fail-with-body "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22"
  1. ہر برقرار یا یکجا کردہ دعوے کو متعلقہ ماخذ سیشن اور پرانے اسٹور سے ملائیں۔ دیکھیں کہ واقعی تائید موجود ہے، صحیح صارف یا منصوبے سے تعلق ہے، اور کوئی نیا حکم اسے رد تو نہیں کرتا۔ راز، ذاتی ڈیٹا اور ناقابلِ اعتماد مواد سے داخل کیے گئے احکامات تلاش کریں۔ ہر اہم میموری کے لیے رکھنے، درست کرنے یا ہٹانے کا فیصلہ درج کریں۔ Dream دونوں میں سے کسی کو نہیں بدلتا : نہ ان پٹ اسٹور کو، نہ ماخذ سیشنز کو؛ صرف جائزہ شدہ نتیجہ آگے جانا چاہیے۔

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

Terminal
python3 -c 'import json,os; print(json.dumps({"content": os.environ["corrected_content"], "precondition": {"type": "content_sha256", "content_sha256": os.environ["mem_sha"]}}))' > correction.json

curl -sS --fail-with-body -X POST "https://api.anthropic.com/v1/memory_stores/$output_store_id/memories/$mem_id" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: agent-memory-2026-07-22" \
  -H "content-type: application/json" \
  --data-binary @correction.json

انکوڈ کرنے سے پہلے مقرر اور ایکسپورٹ کریں corrected_content اور mem_sha ، جانچیں correction.json، اور اسے میموری ہی کی نجی ڈیٹا حد میں رکھیں۔ واپس پڑھ کر تصدیق کے بعد اپنی برقرار رکھنے کی پالیسی کے مطابق مقامی نقل ہٹائیں۔ ہر ترمیم شدہ میموری دوبارہ پڑھیں۔ اسٹور میں زیادہ سے زیادہ 10,000 میموری ہو سکتی ہیں، ہر ایک زیادہ سے زیادہ 100 kB۔ حد پر نئی میموری لکھنا ناکام ہوتا ہے، لیکن موجودہ میموری پڑھی اور بدلی جا سکتی ہے۔ نئی تحریر پر انحصار سے پہلے دائرہ محدود کریں یا بھرے اسٹور کو محفوظ طور پر کم کریں۔

صرف منظور کردہ میموری بعد کے سیشن سے جوڑیں

  1. نتیجہ جائزے سے گزر جائے تو اس اسٹور کے ساتھ نیا سیشن بنائیں۔ یہ مثال اسے read_only کے طور پر جوڑتی ہے، جو ایسی جانچ کے لیے مناسب ہے جس میں جائزہ شدہ ریکارڈ نہ بدلے۔ بعد میں ایجنٹ کو میموری بڑھانی ہو تو شعوری طور پر read_write دیں اور بعد کی تحریروں کا بھی جائزہ لیں۔
Terminal
curl -sS --fail-with-body https://api.anthropic.com/v1/sessions \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -H "content-type: application/json" \
  --data '{
    "agent": "'"$agent_id"'",
    "environment_id": "'"$environment_id"'",
    "resources": [
      {"type": "memory_store", "memory_store_id": "'"$output_store_id"'", "access": "read_only"}
    ]
  }'

نئے سیشن سے ملنے والے ریسورسز میں مطلوبہ اسٹور ID اور اس کا حقیقی mount_path دیکھیں۔ واپس ملنے والا سیشن ID new_session_id کے طور پر رکھیں اور شیل متغیر ایکسپورٹ کریں تاکہ Python پڑھ سکے۔ کسی برقرار حقیقت کے بارے میں عام زبان میں سوال لکھیں جس کا ماخذ آپ نے جانچا ہے، پھر اسے memory_question کے طور پر مقرر اور ایکسپورٹ کریں۔ Anthropic کا فوری آغاز کا پیغام بہاؤ ایونٹ اسٹریم کھولتا ہے، user.message بھیجتا ہے، agent.message کا متن چھاپتا ہے اور session.status_idle پر رکتا ہے۔ اسی دستاویزی انٹرفیس سے سوال بھیج کر جواب پڑھیں:

Terminal
python3 - <<'PY'
import os
from anthropic import Anthropic

client = Anthropic()
session_id = os.environ["new_session_id"]
question = os.environ["memory_question"]

with client.beta.sessions.events.stream(session_id) as stream:
    client.beta.sessions.events.send(
        session_id,
        events=[{"type": "user.message", "content": [{"type": "text", "text": question}]}],
    )
    for event in stream:
        if event.type == "agent.message":
            for block in event.content:
                if block.type == "text":
                    print(block.text, end="")
        elif event.type == "session.status_idle":
            print()
            break
PY

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

اگر بنانے پر رسائی یا توثیق کی خرابی ملے تو درخواست بدلنے سے پہلے تحقیقی پیش منظر کا استحقاق، درست ان پٹ ID اور سیشنز کی تعداد دیکھیں۔ اگر کام منتظر یا جاری ہے تو اسی ID کی جانچ جاری رکھیں۔ failed یا canceled کام جزوی آؤٹ پٹ اسٹور چھوڑ سکتا ہے؛ خرابی دیکھیں اور اسے منظور شدہ میموری کے طور پر نہ جوڑیں۔ اگر بعد کا سیشن منظور کردہ میموری استعمال نہ کر سکے تو ریسورسز اور ماؤنٹ راستہ دیکھنے کا سیشن ہے وہی سیشن۔ پہلے سے چلتے سیشن میں اسٹور نہیں بڑھایا جا سکتا۔

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

Managed Agents کے پہلے، الگ کام کے لیے دیکھیں ہماری متوازی دستاویزی جائزے کی رہنمائی۔ ہماری Hy Memory 2.0 رپورٹ الگ میموری SDK اور اس کے محدود دائرے والے یادآوری طریقے کے متعلق ہے۔

ماخذ اور مزید مطالعہ

  • Anthropic کی Dreams رہنمائی تحقیقی پیش منظر کی رسائی، ان پٹ، بنانے اور حالت جاننے کی درخواستیں، حالتیں، الگ نتیجہ، بل اور ناکامی کا رویہ بیان کرتی ہے۔ میموری اسٹور بیٹا ہیڈرز پر اس کا عام بیان موجودہ مخصوص میموری رہنما سے متصادم ہے؛ براہِ راست کالز میں دوسرے کو اپنائیں۔
  • Anthropic کی میموری رہنمائی اسٹور بنانا، سیشن سے جوڑنا، مخصوص میموری ہیڈر، فہرست، ہیش سے محفوظ ترمیم، ورژن اور برقرار رکھنا بیان کرتی ہے۔ یہ قابلِ تحریر اسٹور کی آلودگی اور ناقابلِ واپسی آرکائیو و حذف کی تنبیہ کرتی ہے۔
  • Anthropic کی Managed Agents فوری آغاز رہنمائی اکاؤنٹ، API کلید، ایجنٹ، ماحول اور سیشن کے تقاضے بتاتی ہے۔ کوئی صفحہ اس رہنما کے لیے مشاہدہ شدہ اجرا یا معیار میں فائدہ ثابت نہیں کرتا۔