> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory

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

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                ميزة Beta. 
                <u>
                    <a href="/docs/beta-and-experimental-features#beta-features">
                        مزيد من المعلومات.
                    </a>
                </u>
            </span>
        </div>;
};

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

<div id="how-it-works">
  ## كيف تعمل Memory
</div>

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

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

<div id="manage-your-memories">
  ## إدارة عناصر Memory الخاصة بك
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/memories.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=e24e0bde7820f6de3632acee9cba07bc" alt="لوحة Memories تُظهر أيقونة الدماغ مميّزة في شريط التنقل الأيسر، وحقل تصفية، وزر Add، ومربع اختيار Use memory، وإدخال Memory مع عناصر تحكم للتحرير والحذف، وزر Admin Settings" size="sm" width="714" height="862" data-path="images/cloud/agent-builder/memory/memories.png" />

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

<div id="create-memory">
  ### إنشاء Memory
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/create.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=975cf2cda04c354a799d9910dff3061f" alt="لوحة Memory مع تمييز الزر + الخاص بإنشاء Memory" size="sm" width="782" height="862" data-path="images/cloud/agent-builder/memory/create.png" />

<div id="filter-memories">
  ### تصفية عناصر الذاكرة
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/filter.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=f3c702a4e60ed546975a84049d3c886d" alt="لوحة Memory مع تمييز حقل «تصفية عناصر الذاكرة» وكتابة 'demo' فيه" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/filter.png" />

<div id="edit-memory">
  ### تعديل Memory
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/edit.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=88a8cb385eb2f1591ad630cfe6312573" alt="عنصر Memory مع تمييز أيقونة قلم تعديل Memory" size="sm" width="718" height="884" data-path="images/cloud/agent-builder/memory/edit.png" />

<div id="delete-memory">
  ### حذف عنصر من Memory
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/delete.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=c10e6627d1db318f88ac39985d1271ee" alt="عنصر Memory مع تمييز أيقونة سلة المهملات الخاصة بحذف العنصر" size="sm" width="768" height="848" data-path="images/cloud/agent-builder/memory/delete.png" />

<div id="toggle-memory">
  ## تشغيل Memory أو إيقافها
</div>

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/TCLsdkFwl4CgDiNY/images/cloud/agent-builder/memory/toggle.png?fit=max&auto=format&n=TCLsdkFwl4CgDiNY&q=85&s=da7f9f89b461d3a7c08e128452582baa" alt="لوحة Memory مع تمييز مربع الاختيار استخدام Memory في الأعلى" size="sm" width="720" height="848" data-path="images/cloud/agent-builder/memory/toggle.png" />

<div id="memory-best-practices">
  ## أفضل ممارسات Memory
</div>

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

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

لم تُصمَّم Memory لتُستخدم كقاعدة بيانات. وليست أيضًا مكانًا لتكديس مواد مرجعية كبيرة، على سبيل المثال.
بدلًا من ذلك، ينبغي لك استخدام [مهارة](/ar/products/cloud/features/ai-ml/agents/builder/skills) أو تضمين هذه المواد في تعليمات الوكيل لهذا الغرض.
كما أنها ليست مخصّصة للاسترجاع عبر المحادثات السابقة؛ إذ يؤدّي سجل المحادثة نفسه هذا الدور.
