---
read_when:
    - باید چیزی را پیدا کنید که در یک نشست قبلی درباره‌اش گفت‌وگو شده است
    - می‌خواهید حریم خصوصی یا نمایه‌سازی جست‌وجوی نشست‌ها را درک کنید
summary: متن نشست‌های گذشته را جست‌وجو کنید و زمینهٔ منطبق را دوباره باز کنید
title: جست‌وجوی نشست
x-i18n:
    generated_at: "2026-07-27T15:07:03Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 32
    provider: openai
    source_hash: 3e9cda6b656b689eef0636592914f4890a64dca5e955aa03908377903aaa29c9
    source_path: concepts/session-search.md
    workflow: 16
---

# جست‌وجوی نشست

`sessions_search` متن کاربر و دستیار را در نشست‌های گذشته خودتان جست‌وجو می‌کند. هر نتیجه
شامل یک `sessionKey`، برچسب زمانی، نقش و گزیده‌ای کوتاه و منطبق است. هنگامی که به
گفت‌وگوی پیرامونی نیاز دارید، `sessionKey` بازگردانده‌شده را به `sessions_history` بدهید.

## دامنه مشاهده و خروجی

جست‌وجو از همان قواعد دامنه مشاهده نشستِ `sessions_history` استفاده می‌کند. نتایجی که خارج از
درخت نشستِ قابل‌مشاهده برای فراخواننده باشند، پیش از اعمال محدودیت نتایج حذف می‌شوند. هنگامی که
دامنه مشاهده نشست‌های ایجادشده فعال باشد، عامل‌های سندباکس‌شده همچنان فقط به نشست‌هایی که خود ایجاد کرده‌اند محدود می‌مانند.

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

## چرخه عمر نمایه

OpenClaw یک نمایه تمام‌متن را در کنار ردیف‌های رونوشت در پایگاه داده SQLite هر عامل ذخیره می‌کند.
پیام‌های جدید کاربر و دستیار در همان تراکنشی نمایه‌سازی می‌شوند که آن‌ها را ماندگار می‌کند؛ بنابراین
نمایه هرگز از گفت‌وگوهای زنده عقب نمی‌ماند. نتایج ابزارها، بلوک‌های استدلال و تصاویر مستثنا هستند.
فقط شاخه فعال رونوشت قابل جست‌وجو است.

رونوشت‌هایی که به پیش از ایجاد نمایه مربوط‌اند (برای مثال، نشست‌های واردشده توسط `openclaw doctor`) و
نشست‌هایی که شاخه فعالشان به عقب بازگردانده شده است، از طریق یک تطبیق پس‌زمینه که با جست‌وجوی بعدی آغاز
می‌شود، دوباره نمایه‌سازی می‌شوند. بنابراین، پاسخی دارای `indexing: true` ممکن است ناقص باشد؛ پس از
پایان نمایه‌سازی دوباره تلاش کنید. حذف یک نشست، ورودی‌های نمایه آن را در همان تراکنش حذف می‌کند.

جست‌وجو در حال حاضر از توکن‌ساز واژه Unicode در SQLite همراه با حذف نشانه‌های اعراب استفاده می‌کند. توکن‌سازی
سه‌حرفی برای تطبیق زیررشته‌ای CJK، بهبودی برای آینده است.

## جست‌وجوی نشست در برابر جست‌وجوی حافظه

برای واژه‌ها یا عبارت‌های دقیق در رونوشت‌های خام نشست، از `sessions_search` استفاده کنید. برای
فایل‌های حافظه پایدار و بازیابی معنایی، از [`memory_search`](/fa/concepts/memory-search) استفاده کنید. پیکره
آزمایشی حافظه نشست، مکمل معنایی این جست‌وجوی دقیق رونوشت است.
