حافظهٔ ایجنت چیه و چرا نباید همه‌چی رو یادش بمونه؟

اول یه مرور سی‌ثانیه‌ای

این مقاله روی چندتا چیزی که قبلاً ساختیم سوار می‌شه. اگر تازه رسیدی، لازم نیست همه رو یک‌جا بخونی؛ هرکدوم برات ناآشناست بازش کن.

حافظه یعنی مدل واقعاً تو رو «می‌شناسه»؟

نه دقیقاً. مدل مثل آدم خاطره رو داخل مغزش نگه نمی‌داره. اپلیکیشن یه سری اطلاعات رو جایی ذخیره می‌کنه و هر وقت لازم شد، بخش مرتبطش رو دوباره جلوی مدل می‌ذاره. مدل هم براساس همون چیزی که الان می‌بینه جواب می‌ده.

پس زیادبودن حافظه لزوماً ایجنت رو باهوش‌تر نمی‌کنه. اگر بازیابی بد باشه، پروندهٔ اشتباه میاد روی میز و مدل با اعتمادبه‌نفس جواب اشتباه می‌ده.

این پنج‌تا رو با هم قاطی نکن

توی لنگ‌گراف، حافظه معمولاً دو لایه داره

سه جور چیزی که ایجنت ممکنه یاد بگیره

این دسته‌بندی کمک می‌کنه بفهمی دقیقاً چی داری ذخیره می‌کنی. ولی هر سه یه سطح ریسک ندارن. سلیقهٔ رنگ پوشه حساس نیست؛ قانون اجرای تراکنش یا دستور امنیتی چرا.

مثال واقعی: ایجنت مرتب‌کنندهٔ دسکتاپ

فرض کن همون ایجنت سادهٔ قبلی رو ارتقا دادیم. فایل‌ها رو می‌بینه، پیشنهاد می‌ده کجا برن و بعد از تأیید تو جابه‌جاشون می‌کنه. هر نوع اطلاعات باید جای درست خودش بره:

دفعهٔ بعد، ایجنت سلیقهٔ ذخیره‌شده رو پیدا می‌کنه و از اول پیشنهاد بهتری می‌ده. اما هنوز حق جابه‌جایی نداره؛ حافظه فقط پیشنهاد رو بهتر کرده، نه اینکه اجازهٔ اجرا داده باشه.

ایجنت نباید هر جمله‌ای رو مستقیم حفظ کنه

نوشتن در حافظه باید خودش یک مسیر کنترل‌شده داشته باشه:

یک نمونهٔ خیلی کوچک در لنگ‌گراف

لازم نیست با دیدن کد پایین همهٔ خط‌ها رو بفهمی. اول فقط کاری که انجام می‌ده رو ببین؛ بعد اگر خواستی هر نمونه رو باز کن.

from langgraph.checkpoint.memory import InMemorySaver
from langgraph.store.memory import InMemoryStore

checkpointer = InMemorySaver()
store = InMemoryStore()

graph = builder.compile(
    checkpointer=checkpointer,
    store=store,
)

config = {
    "configurable": {"thread_id": "desktop-001"}
}

user_id = "user-123"
namespace = (user_id, "desktop_preferences")

store.put(
    namespace,
    "sorting_rules",
    {
        "screenshots_folder": "Screenshots",
        "never_move": ["Invoices"],
    },
)

شش اشتباه رایج که حافظه رو خراب می‌کنه

حافظه به ایجنت اختیار نمی‌ده

این مهم‌ترین بخش مقاله‌ست. ایجنت ممکنه یادش باشه که تو معمولاً جواب کوتاه دوست داری؛ مشکلی نیست. ولی جمله‌ای مثل «کاربر قبلاً اجازهٔ خرج نامحدود داده» نباید از حافظه تبدیل به مجوز واقعی بشه.

قبل از روشن‌کردن حافظه این چک‌لیست رو رد کن