🤖 تثبيت Letta — وكلاء ذكاء اصطناعي ذوو ذاكرة طويلة الأمد

انشر Letta على Ubuntu بـ Docker — سيرفر وكلاء ذكاء اصطناعي حالِيّ الحالة (Stateful) عُرف سابقاً باسم MemGPT، يمنح الوكلاء ذاكرة طويلة الأمد تدوم بين المحادثات، معتمداً على PostgreSQL، على المنفذ 8285.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر Letta مع PostgreSQL على المنفذ 8285. اربط بيئة تطوير الوكلاء (ADE) بالسيرفر واضبط مزوّد نموذج لغوي.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/ai/letta/letta-ubuntu.sh
chmod +x letta-ubuntu.sh
./letta-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/ai/letta/letta-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x letta-ubuntu.sh

3 تشغيل أداة التثبيت

./letta-ubuntu.sh

4 الاتصال وضبط مزوّد النموذج

http://your-server-ip:8285

المنافذ المستخدمة

المنفذالغرض
8285Letta server and Agent Development Environment (mapped from container port 8283)
5432PostgreSQL — internal to the Docker network, not exposed to the host

نظرة عامة

Letta، المعروف سابقاً باسم MemGPT، هو إطار عمل وسيرفر مفتوح المصدر لبناء وكلاء ذكاء اصطناعي حالِيّي الحالة (Stateful) يتمتعون بذاكرة طويلة الأمد. بخلاف التعامل مع المحادثة كنص عابر يختفي بمجرد امتلاء نافذة السياق، يمنح Letta كل وكيل نظام ذاكرة منظّماً مدعوماً بقاعدة بيانات PostgreSQL حقيقية، يفصل بين ما يجب أن يبقى في السياق النشط وما يجب أرشفته واستدعاؤه لاحقاً. الوكلاء المبنيون على Letta يتذكرون معلومات عنك، ومحادثات سابقة، ومعرفة تراكمت مع الوقت، وتبقى هذه الحالة محفوظة عبر إعادة التشغيل لأنها مخزنة في قاعدة البيانات لا في الذاكرة المؤقتة.

لماذا تستخدمه

معظم روبوتات المحادثة وأغلفة النماذج اللغوية تنسى كل شيء بمجرد انتهاء الجلسة أو فيضان نافذة السياق. يحل Letta هذه المشكلة بمنح الوكلاء بنية ذاكرة تدير نفسها: كتلة ذاكرة صغيرة داخل السياق يمكن للنموذج تعديلها بنفسه، بالإضافة إلى مخزن ذاكرة أرشيفية يستطيع الوكيل البحث فيه عند الحاجة لمعلومات أقدم. هذا يعني إمكانية بناء مساعدين أو روبوتات دعم أو وكلاء شخصيين يتحسنون بالفعل ويبقون متسقين عبر أسابيع أو شهور من الاستخدام، دون الحاجة لبناء خط أنابيب RAG يدوياً أو إدارة تاريخ المحادثة بنفسك. ولأن Letta مستقل عن النموذج، يمكنك ربطه بـ OpenAI أو Anthropic أو نماذج محلية عبر Ollama أو أي نقطة نهاية متوافقة مع OpenAI، مع الحفاظ على نفس طبقة الذاكرة تحتها.

متى تحتاجه

  • تبني وكيل ذكاء اصطناعي يجب أن يتذكر المستخدمين والحقائق والتفاعلات السابقة بين الجلسات بدلاً من البدء من الصفر كل مرة
  • تصادف حدود نافذة السياق في المحادثات الطويلة وتحتاج نظاماً يدير ما يبقى في السياق تلقائياً
  • تريد بديلاً ذاتي الاستضافة لمنصات ذاكرة الوكلاء المملوكة، مع تحكم كامل في مكان تخزين بيانات المحادثة والذاكرة
  • تُجرّب أنظمة وكلاء متعددة تحتاج حالة دائمة، وليس فقط استدعاء إكمال واحد بلا حالة
  • تحتاج ذاكرة وكلاء قابلة للاستعلام ومحفوظة في قاعدة بيانات حقيقية بدلاً من مخزن في الذاكرة أو ملف يختفي عند إعادة التشغيل

من يحتاجه

  • مطورو الذكاء الاصطناعي الذين يبنون مساعدين أو مساعدي برمجة أو روبوتات دعم تحتاج تذكر المستخدمين بين الجلسات
  • الباحثون والهواة الذين يجربون بنى ذاكرة الوكلاء والاستدلال طويل الأمد
  • الشركات الناشئة التي تبني منتجات ذكاء اصطناعي مخصصة وتريد بنية ذاكرة جاهزة دون بنائها من الصفر
  • عشاق الاستضافة الذاتية الذين يريدون الاحتفاظ ببيانات المحادثة والذاكرة الحساسة على بنيتهم التحتية الخاصة
  • الفرق التي تبني أدوات ذكاء اصطناعي داخلية — مساعدي معرفة، روبوتات تهيئة الموظفين — يجب أن تتراكم معرفتها التنظيمية مع الوقت
  • المطورون الذين يريدون تجربة عدة مزودي نماذج لغوية خلف طبقة وكيل وذاكرة واحدة متسقة

حالات الاستخدام الشائعة

  • مساعدون شخصيون بالذكاء الاصطناعي يتذكرون تفضيلاتك ومشاريعك الجارية ومحادثاتك السابقة عبر شهور
  • وكلاء دعم عملاء يتذكرون تاريخ العميل وتذاكره السابقة دون إعادة شرح السياق كل جلسة
  • وكلاء بحث أو برمجة طويلة الأمد تتراكم معرفتهم حول قاعدة كود أو مشروع أثناء العمل
  • وكلاء رفقة أو تقمص أدوار يحتاجون شخصية متسقة وذاكرة للتفاعلات السابقة
  • مساعدو معرفة داخليون يبنون ذاكرة مؤسسية من تفاعلات الموظفين المتكررة
  • تنسيق وكلاء متعددين حيث يجب أن تبقى حالة كل وكيل وذاكرته مستقلة بين عمليات التشغيل

الميزات الرئيسية

  • كتل ذاكرة يعدّلها الوكيل نفسه، بحيث تبقى الحقائق الأساسية في السياق دون إدارة يدوية
  • ذاكرة أرشيفية مدعومة بـ PostgreSQL للتخزين طويل الأمد يمكن للوكيل البحث فيها واستدعاؤها عند الطلب
  • تصميم مستقل عن النموذج — يعمل مع OpenAI وAnthropic وGoogle والنماذج المحلية عبر Ollama أو أي واجهة برمجية متوافقة مع OpenAI
  • بيئة تطوير الوكلاء (ADE)، واجهة رسومية لبناء واختبار وفحص الوكلاء وذاكرتهم في الوقت الفعلي
  • واجهة REST API بالإضافة إلى حزم تطوير Python وTypeScript لتضمين وكلاء Letta مباشرة في تطبيقاتك
  • دعم استدعاء الأدوات المدمج بحيث يمكن للوكلاء تنفيذ دوال والتفاعل مع أنظمة خارجية
  • دعم وكلاء متعددين لبناء أنظمة يتشارك فيها عدة وكلاء الحالة أو يتبادلونها
  • مفتوح المصدر بالكامل برخصة Apache 2.0 دون حدود استخدام أو مستويات مدفوعة للنشر ذاتي الاستضافة

كيفية الاستخدام بعد التثبيت

  • افتح بيئة تطوير الوكلاء على http://your-server-ip:8285 بعد انتهاء تشغيل الحاويات
  • اضبط مزوّد نموذج لغوي من الإعدادات — أضف مفتاح OpenAI أو Anthropic، أو أشِر إلى نقطة نهاية Ollama محلية
  • أنشئ أول وكيل لك من بيئة التطوير وأعطه شخصية مبدئية وكتلة ذاكرة بشرية (human memory)
  • أرسل رسائل اختبار عبر لوحة المحادثة في بيئة التطوير وشاهد كتل الذاكرة تتحدث في اللوحة الجانبية مع تقدّم المحادثة
  • استخدم واجهة REST API أو حزمة Python/TypeScript لدمج الوكيل في تطبيقك الخاص بعد التأكد من سلوكه الصحيح
  • أنشئ وكلاء إضافيين لحالات استخدام مختلفة — يحتفظ كل وكيل بذاكرته المستقلة في قاعدة بيانات PostgreSQL المشتركة
  • راجع نتائج بحث الذاكرة الأرشيفية دورياً للتأكد من أن الوكيل يستدعي التاريخ ذا الصلة بشكل صحيح

أفضل ممارسات الأمان

  • احتفظ بالمنفذ 8285 بعيداً عن الإنترنت العام — ضعه خلف وكيل عكسي مع HTTPS ومصادقة إذا كان الوصول عن بُعد مطلوباً
  • عيّن كلمة مرور/مفتاح API قوياً لسيرفر Letta بدلاً من الاعتماد على القيم الافتراضية
  • خزّن مفاتيح API لمزودي النماذج اللغوية كمتغيرات بيئة أو أسرار، لا داخل ملفات إعداد الوكيل مباشرة
  • قصر PostgreSQL على شبكة Docker الداخلية فقط — يجب ألا يُكشف للمضيف أو الإنترنت أبداً
  • استخدم VPN مثل WireGuard للوصول عن بُعد لبيئة تطوير الوكلاء بدلاً من كشفها مباشرة
  • بدّل مفاتيح API لمزودي النماذج بشكل دوري وفوراً إذا اشتبهت بتسريب مفتاح
  • خذ نسخة احتياطية من حجم PostgreSQL بانتظام لأنه يحتوي كل ذاكرة الوكلاء وتاريخ المحادثات
  • حافظ على تحديث صورة Letta لـ Docker للحصول على إصلاحات أمنية وتكاملات نماذج جديدة

المنافذ وإعدادات جدار الحماية

يربط هذا النشر سيرفر Letta وبيئة تطوير الوكلاء بالمنفذ 8285 على المضيف (تستمع الحاوية داخلياً على المنفذ 8283). يعمل PostgreSQL على المنفذ 5432 لكنه يبقى داخل شبكة Docker ولا يُنشر أبداً للمضيف، لذا لا يمكن الوصول إليه من خارج شبكة الحاوية افتراضياً. لا يجب كشف المنفذ 8285 مباشرة للإنترنت العام لأن ذاكرة الوكلاء قد تحتوي بيانات شخصية أو تجارية حساسة — ضعه خلف وكيل عكسي مع TLS، أو قيّد الوصول بقاعدة جدار حماية أو VPN مثل WireGuard. إذا كشفت بيئة تطوير الوكلاء عن بُعد، اجمعها دائماً مع مصادقة كلمة المرور/مفتاح API للسيرفر.

النسخ الاحتياطي والصيانة

  • خذ نسخة احتياطية من حجم بيانات PostgreSQL بانتظام — يحتوي كتل ذاكرة كل وكيل والذاكرة الأرشيفية وتاريخ المحادثات
  • استخدم pg_dump لإنشاء نسخ SQL قابلة للنقل من قاعدة بيانات Letta بالإضافة إلى لقطات الحجم الخام
  • خذ نسخة احتياطية من docker-compose.yml وأي ملفات بيئة حتى يمكن إعادة إنشاء النشر بنفس الإعدادات على مضيف جديد
  • خزّن النسخ الاحتياطية على قرص مختلف عن قاعدة البيانات العاملة للحماية من تعطل القرص
  • اختبر استعادة نسخة احتياطية على نسخة منفصلة بشكل دوري للتأكد من رجوع الوكلاء وذاكرتهم سليمة
  • وثّق مزودي النماذج اللغوية ومفاتيح API التي ضبطتها، لأنها موجودة خارج قاعدة البيانات في متغيرات البيئة

الأخطاء الشائعة

  • كشف المنفذ 8285 مباشرة للإنترنت دون وكيل عكسي أو مصادقة أمامه
  • نسيان ضبط مزوّد نموذج لغوي قبل إنشاء وكيل، مما يجعل الوكيل عاجزاً عن الرد
  • التعامل مع Letta كمخزن مستندات RAG — فهو يدير ذاكرة المحادثة والوكلاء، لا فهرس مستندات عام
  • عدم أخذ نسخة احتياطية من حجم PostgreSQL، ثم فقدان كل ذاكرة الوكلاء عند ترحيل السيرفر أو تعطله
  • تشغيل وكلاء كثيرين على جهاز غير كافٍ والاستغراب من بطء الاستجابة، لأن كل طلب لا يزال يستدعي مزوّد نموذج لغوي خارجي
  • خلط وكلاء غير مرتبطين في نفس كتل الذاكرة بدلاً من إنشاء وكلاء منفصلين لحالات استخدام منفصلة
  • تجاهل نتائج بحث الذاكرة الأرشيفية، مما يجعل الوكلاء يبدون كأنهم 'نسوا' تفاصيل مخزّنة فعلياً لكنها لا تُستدعى بشكل صحيح

استكشاف الأخطاء وإصلاحها

  • بيئة تطوير الوكلاء لا تُحمّل — تأكد من تشغيل الحاوية بـ docker ps وتحقق أن المنفذ 8285 غير محظور بجدار حماية المضيف
  • الوكيل لا يستجيب — تحقق من ضبط مفتاح API لمزوّد النموذج بشكل صحيح تحت الإعدادات وأن نقطة نهاية المزوّد قابلة للوصول من السيرفر
  • الوكيل يبدو أنه ينسى السياق — تحقق أن حاوية PostgreSQL سليمة وأن كتل الذاكرة تُكتب فعلياً لا فقط تُقرأ
  • أخطاء اتصال بقاعدة البيانات عند التشغيل — تأكد من أن حاوية PostgreSQL بدأت قبل حاوية سيرفر Letta وأن بيانات الاعتماد في ملف compose متطابقة
  • استجابة بطيئة — هذا غالباً تأخير من مزوّد النموذج اللغوي وليس Letta نفسه؛ اختبر النموذج مباشرة مع المزوّد للمقارنة
  • لا يمكن الوصول للسيرفر عن بُعد — تأكد أن الوكيل العكسي أو قاعدة جدار الحماية تحوّل إلى المنفذ 8285 وأن رابط السيرفر المضبوط في بيئة التطوير يطابق عنوانك العام
  • فشل استدعاء الأدوات — تحقق أن مخطط الدالة المسجّل مع الوكيل يطابق توقيع الدالة الفعلي تماماً

البدائل

Mem0 مكتبة طبقة ذاكرة أخف تركز فقط على إضافة الذاكرة لتطبيقات النماذج اللغوية القائمة بدلاً من تقديم سيرفر وكلاء كامل وبيئة تطوير رسومية. Zep سيرفر ذاكرة مفتوح المصدر آخر موجّه للذكاء الاصطناعي المحادثي، بهدف مشابه لكن ببنية مختلفة وتركيز أقل على واجهة بناء وكلاء رسومية. LangChain وLangGraph يقدمان الذاكرة وتنسيق الوكلاء كجزء من إطار عمل أكبر بكثير، وهذا يمنح مرونة أكبر لكنه يتطلب كوداً مخصصاً أكثر بكثير للوصول لنفس سلوك الذاكرة الدائمة التي يقدمها Letta جاهزاً. AutoGen وCrewAI يركزان أكثر على تنسيق الوكلاء المتعددين وتفويض المهام بدلاً من الذاكرة المنظّمة طويلة الأمد. للفرق التي تريد تحديداً سيرفر وكلاء حالِيّ الحالة مخصصاً مع بيئة تطوير رسومية وذاكرة مدعومة بقاعدة بيانات، يبقى Letta الخيار الذاتي الاستضافة الأكثر اكتمالاً.

متى لا تستخدمه

Letta ليس خياراً جيداً إذا كنت تحتاج فقط روبوت محادثة بسيطاً بلا حالة لأسئلة منفردة — بنية الذاكرة تضيف تكلفة لا تحتاجها. وليس أيضاً منصة بحث مستندات أو RAG؛ إذا كان هدفك الإجابة على أسئلة حول مجموعة ثابتة كبيرة من ملفات PDF أو صفحات الويكي، فأداة RAG مخصصة أو قاعدة بيانات متجهات مع واجهة محادثة أبسط ستخدمك أفضل. لا يزال Letta معتمداً كلياً على مزوّد نموذج لغوي خارجي للاستدلال الفعلي، فهو لا يقلل اعتمادك على OpenAI أو Anthropic أو نموذج محلي — هو فقط يدير ما يتذكره ذلك النموذج. إذا لم تكن لديك خبرة بـ PostgreSQL وتشعر بعدم الارتياح لصيانة قاعدة بيانات، فقد يتجاوز العبء التشغيلي الفائدة لمشروع هواية صغير.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما هو Letta؟

Letta، المعروف سابقاً باسم MemGPT، هو سيرفر لبناء وكلاء ذكاء اصطناعي ذوي ذاكرة طويلة الأمد. بخلاف روبوت المحادثة العادي الذي ينسى كل شيء عند انتهاء المحادثة، يدير Letta ذاكرة منظّمة في قاعدة بيانات PostgreSQL بحيث يتذكر الوكلاء الحقائق والمحادثات السابقة والمعرفة المتراكمة عبر الجلسات.

ما المنفذ الذي يستخدمه؟

يشغّل هذا النشر Letta على المنفذ 8285 على المضيف، المطابق للمنفذ 8283 داخل الحاوية. تبني وتدير الوكلاء عبر بيئة تطوير الوكلاء (ADE)، التي توجّهها إلى رابط سيرفرك على هذا المنفذ.

هل أحتاج مفتاح OpenAI، أم يمكن تشغيله محلياً؟

كلاهما ممكن. Letta مستقل عن النموذج — يدير الذاكرة ومنطق الوكيل لكنه يفوّض التفكير الفعلي لمزوّد نموذج لغوي تضبطه أنت، سواء كان OpenAI أو Anthropic أو نموذجاً محلياً عبر Ollama.

كيف تختلف ذاكرته عن RAG؟

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

أين تُخزَّن ذاكرة الوكيل، وهل هي خاصة؟

في قاعدة بيانات PostgreSQL التي يشغّلها هذا النشر، على سيرفرك الخاص — وهذا ما يجعل حالة الوكيل تبقى محفوظة عبر إعادة التشغيل. قد تكون هذه الذاكرة شخصية للغاية، لذا احتفظ بالمنفذ داخلياً وخذ نسخة احتياطية من قاعدة البيانات.