> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory

> Memory والتخصيص في ClickHouse Agents

[ميزة Beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

هو مخزن خاص بكل مستخدم يمكن للوكيل الرجوع إليه عبر المحادثات. ويتكوّن من عدة إدخالات، كلٌّ منها زوج مفتاح-قيمة - مثل
تنسيق التاريخ المفضّل لديك، أو قاعدة البيانات التي تستعلم عنها عادةً، أو مدى الإيجاز الذي تريده في الردود. ويستحضر الوكيل هذه ضمن السياق عند الحاجة إليها.

## كيف تعمل Memory

يعمل وكيل Memory صغير إلى جانب المحادثة الرئيسية. يقرأ الرسائل الأخيرة، ويقرر ما يستحق التذكّر، ثم يكتب عناصر في مخزن خاص بكل مستخدم.
في المحادثة التالية، تصبح هذه العناصر متاحة كسياق يمكن للوكيل الرئيسي الرجوع إليه من دون أن تضطر إلى تكرار ما قلته.

ستلاحظ ذلك على شكل استمرارية: يكفي أن تخبر الوكيل مرة واحدة أنك تفضّل مخرجات SQL بأحرف صغيرة وأن سنتك المالية تنتهي في مارس، وستجري المحادثات اللاحقة على هذا الأساس.

## إدارة عناصر Memory الخاصة بك

افتح لوحة Memory من أيقونة **Memories** (الدماغ) في شريط التنقل الأيسر. تعرض اللوحة عناصر Memory المخزّنة لديك، مع عناصر تحكم لإنشاء الإدخالات وتحريرها وحذفها وتصفيتها.

![لوحة Memories تُظهر أيقونة الدماغ مميّزة في شريط التنقل الأيسر، وحقل تصفية، وزر Add، ومربع اختيار Use memory، وإدخال Memory مع عناصر تحكم للتحرير والحذف، وزر Admin Settings](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/memories.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=be40fec929722ddd7b6ea9f16d916d53)

ميزة Memory خاصة بحسابك. لا يمكن لوكلاء الآخرين رؤية إدخالاتك مطلقًا، كما لا يمكن لوكلائك رؤية إدخالاتهم.

### إنشاء Memory

انقر على الزر **+** في أعلى اللوحة لفتح مربع الحوار **إنشاء Memory**. أدخل **مفتاحًا** (أحرفًا صغيرة وشرطات سفلية فقط) و**قيمة**، ثم انقر على **إنشاء**.

![لوحة Memory مع تمييز الزر + الخاص بإنشاء Memory](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/create.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=e269376c2af8fc0977bc3480b95d26c5)

### تصفية عناصر Memory

استخدم حقل **تصفية عناصر Memory** أعلى اللوحة للعثور على إدخال حسب المفتاح.

![لوحة Memory مع تمييز حقل «تصفية عناصر Memory» وكتابة 'demo' فيه](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/filter.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=645845ce90fb230bc74cb7bd549dbe91)

### تعديل Memory

انقر على أيقونة القلم في أحد عناصر Memory لفتح مربع الحوار **تعديل Memory**. عدّل المفتاح أو القيمة، ثم انقر على **حفظ**.

![عنصر Memory مع تمييز أيقونة قلم تعديل Memory](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/edit.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=66cdf10cec6a546d064159f4c0856ce9)

### حذف عنصر من Memory

انقر على أيقونة سلة المهملات في عنصر Memory لإزالته.

![عنصر Memory مع تمييز أيقونة سلة المهملات الخاصة بحذف العنصر](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/delete.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=5b5119248aef464b26d0549cb68a8187)

## تشغيل Memory أو إيقافها

شغِّل Memory أو أوقفها باستخدام مربع الاختيار **استخدام Memory** أعلى لوحة Memory. عطِّلها للموضوعات الحساسة التي لا تريد تخزينها، أو للمحادثات العابرة التي لا يكون فيها التخصيص مفيدًا.

عند إيقاف Memory، لا يقرأ الوكيل من مخزن Memory لديك ولا يكتب إليه.

![لوحة Memory مع تمييز مربع الاختيار استخدام Memory في الأعلى](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/memory/toggle.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=9944cd3c5a5afe64aa936198bbb6d118)

## أفضل ممارسات Memory

يمكن أن تساعد Memory في الحالات التالية:

* الاصطلاحات المتكررة: تنسيقات التاريخ المفضلة، وتعريفات الأعمال، وأنماط التسمية.
* سياق المشروع: الخدمة أو قاعدة البيانات التي تستعلم عنها عادةً، ولوحات المعلومات التي تهمك.
* أسلوب التواصل: الردود المقتضبة مقابل المطوّلة، أو التي تركز على الشيفرة مقابل تلك التي تركز على النص.

لم تُصمَّم Memory لتُستخدم كقاعدة بيانات. وليست أيضًا مكانًا لتكديس مواد مرجعية كبيرة، على سبيل المثال.
بدلًا من ذلك، ينبغي لك استخدام [مهارة](https://clickhouse.com/docs/ar/agents/builder/skills.md) أو تضمين هذه المواد في تعليمات الوكيل لهذا الغرض.
كما أنها ليست مخصّصة للاسترجاع عبر المحادثات السابقة؛ إذ يؤدّي سجل المحادثة نفسه هذا الدور.
