مخازن الذاكرة البسيطة (مفتاح-قيمة)
احفظ الحقائق التي يذكرها المستخدم، مثل الاسم والتفضيلات، في مخزن مفتاح-قيمة، وأدرجها في مطالبة النظام في كل دور.
مخازن الذاكرة البسيطة (مفتاح-قيمة) درس مجاني في AI Agents على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Agents، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Agents 4 دروس في المجموع.
أرخص ذاكرة طويلة الأمد
قبل قواعد بيانات المتجهات والتضمينات، هناك مخزن المفتاح والقيمة البسيط. ولتخزين الحقائق الخاصة بالمستخدم، مثل الاسم والتفضيلات والإعدادات، فهذا كل ما تحتاج إليه.
ما الذي ينبغي تخزينه
من المرشحين الجيدين لذاكرة المفتاح والقيمة:
- اسم المستخدم ولغته
- التفضيلات، مثل الوحدات والمنطقة الزمنية ونبرة الخطاب
- السياق الثابت، مثل المشروع الحالي والموضوع الحالي
- بيانات اعتماد الأدوات الحديثة أو رموز API
مخزن صغير في الذاكرة
بالنسبة إلى نموذج أولي يعمل ضمن عملية واحدة:
memory = {
'user_name': 'Alice',
'units': 'celsius',
'language': 'tr'
}
def remember(key, value):
memory[key] = value
def recall(key, default=None):
return memory.get(key, default)
remember('city', 'Istanbul')
print("Recalled user_name:", recall('user_name'))
print("Recalled city:", recall('city'))
print("Recalled missing key:", recall('country', 'unknown'))
إدخاله في prompt النظام
في كل جولة، اعرض مخزن المفتاح والقيمة داخل prompt النظام:
def build_system_prompt(user_id):
facts = load_facts(user_id)
rendered = '\n'.join(f'- {k}: {v}' for k, v in facts.items())
return f'''
You are AssistantBot.
Known facts about this user:
{rendered}
Use these to personalise replies.
'''استخدم Redis لعدة مستخدمين
بالنسبة إلى وكيل يعمل في بيئة الإنتاج، استخدم Redis:
import redis
r = redis.Redis()
def remember(user_id, key, value):
r.hset(f'mem:{user_id}', key, json.dumps(value))
def recall_all(user_id):
raw = r.hgetall(f'mem:{user_id}')
return {k.decode(): json.loads(v) for k, v in raw.items()}أو استخدم Postgres فحسب
يعمل Postgres أيضًا — باستخدام عمود JSON لكل مستخدم:
CREATE TABLE user_memory (
user_id TEXT PRIMARY KEY,
facts JSONB NOT NULL DEFAULT '{}'
);
-- Update one field:
UPDATE user_memory SET facts = facts || '{"units": "celsius"}' WHERE user_id = $1;الذاكرة بوصفها أداة
اعرض عمليات الذاكرة بوصفها أدوات حتى يتمكن الوكيل نفسه من الكتابة إلى الذاكرة:
tools = [
{'name': 'remember', 'description': 'Save a fact about the user', 'parameters': {...}},
{'name': 'forget', 'description': 'Remove a stored fact', 'parameters': {...}}
]
# The agent can call remember('user_name', 'Alice') itself.
for t in tools:
print(f"{t['name']}: {t['description']}")
منع تضخم الذاكرة
حدّد عدد المفاتيح المخزنة لكل مستخدم، مثلًا 50 أو 100. وإلا فسيستمر prompt النظام في النمو بلا حدود.
مدد TTL والتلاشي
بعض الذكريات قصيرة الأجل. استخدم مدد انتهاء الصلاحية في Redis:
r.hset(f'mem:{user_id}', 'last_topic', 'pricing')
r.expire(f'mem:{user_id}', 3600) # 1 hourذاكرة قابلة للتحرير من المستخدم
اسمح للمستخدمين برؤية ما يتذكره الوكيل عنهم وتعديله — تعمل ذاكرة ChatGPT بهذه الطريقة. فهذا يبني الثقة ويجنب الأخطاء المقلقة.
الخصوصية: التعامل مع PII
غالبًا ما تتضمن الحقائق المخزنة معلومات تعريف شخصية. شفّر الحقول الحساسة أثناء التخزين، واستخدم مفاتيح تشفير خاصة بكل مستخدم، واحذفها عند إغلاق الحساب.
من المفتاح والقيمة إلى المتجه
يُعد مخزن المفتاح والقيمة رائعًا للحقائق المنظّمة. أما الحقائق غير المنظّمة، مثل «يفضل المستخدم نبرة غير رسمية، ويحب الإشارات إلى الأنمي، ويكره الرموز التعبيرية»، فتناسبها مخازن المتجهات أكثر. سنتناول ذلك في الدورة التالية.
متى تُستخدم ذاكرة المفتاح والقيمة
لأي نوع من الذاكرة يكون مخزن المفتاح والقيمة العادي هو الأفضل؟
مراجعة
في 90% من حالات استخدام المساعد الشخصي، يكفي مخزن Redis أو Postgres للمفتاح والقيمة، مع عرضه داخل prompt النظام، لتوفير الذاكرة اللازمة.
الأسئلة الشائعة
هل درس «مخازن الذاكرة البسيطة (مفتاح-قيمة)» مجاني؟
نعم — نص درس «مخازن الذاكرة البسيطة (مفتاح-قيمة)» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Agents، انتقل إلى CoddyKit PRO. تتضمن دورة AI Agents 4 دروس في المجموع.
ماذا ستتعلم في «مخازن الذاكرة البسيطة (مفتاح-قيمة)»؟
احفظ الحقائق التي يذكرها المستخدم، مثل الاسم والتفضيلات، في مخزن مفتاح-قيمة، وأدرجها في مطالبة النظام في كل دور. تتمرن على AI Agents مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ AI Agents؟
لا تُشترط خبرة سابقة. AI Agents على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.
كم من الوقت يستغرق درس «مخازن الذاكرة البسيطة (مفتاح-قيمة)»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس AI Agents هذا؟
نعم. كل درس في AI Agents يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- الذاكرة قصيرة الأمد في نافذة السياق
- لماذا لا تتوسع السياقات الطويلة
- التلخيص بوصفه ضغطًا
- مخازن الذاكرة البسيطة (مفتاح-قيمة)