---
read_when:
    - باید چیزی را پیدا کنید که در یک نشست قبلی درباره‌اش گفت‌وگو شده است
    - می‌خواهید حریم خصوصی یا نمایه‌سازی جست‌وجوی نشست را درک کنید
summary: رونوشت‌های نشست‌های گذشته را جست‌وجو کنید و زمینهٔ منطبق را دوباره باز کنید
title: جست‌وجوی نشست
x-i18n:
    generated_at: "2026-07-16T15:59:45Z"
    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) استفاده کنید.
پیکره آزمایشی حافظه نشست، مکمل معنایی این جست‌وجوی دقیق در رونوشت است.