from letta import Client, Agent, Tool
client = Client(api_key=os.environ.
## استخدام Letta ADE (مسار بدون/قليل ترميز)
إذا كنت تفضّل النمذجة البصرية، يتيح لك ADE تركيب الوكلاء والذاكرة والأدوات دون كتابة رمز.
- ابدأ مشروع وكيل جديد في ADE.
- حدد دور الوكيل (موجه النظام)، النغمة، والحدود.
- ضبط استراتيجيات حفظ الذاكرة والاسترجاع.
- أضف أدوات باختيار موصلات أو تعريف إجراءات مخصصة.
- اختبر المحادثات ميدانيًا، راقب عمليات الكتابة في الذاكرة، وضبط العتبات.
- صدر أو سلم للمطورين بمجرد أن يصبح النموذج يعمل بشكل صحيح.
راجع إعلان وتوجيه ADE لمتابعة توضيحية وفيديو تعريفي سريع.
## تصميم وكلاء Letta ناجحين: أفضل الممارسات برأي
1) ابدأ بالوظيفة المطلوبة
- حدد نطاقًا ضيقًا (مثل "تصنيف تذاكر دعم أخطاء الويب"), وليس نطاقًا عامًا واسعاً.
2) ترميز إجراءات التشغيل
- ضع إجراءات التشغيل الموحدة (SOPs) في موجه النظام. مثال: "عندما يشير التصنيف إلى تأثير الإنتاج، صعّد واضبط الأولوية=عالية. دائمًا اضمّن خطوات إعادة الإنتاج إذا وجدت."
3) اجعل مخططات الأدوات صارمة
- طبق القيم المحددة والحقول المطلوبة. يقَلل هذا من إدخال معلمات خاطئة.
4) اعتبر الذاكرة كواجهة منتج
- قرّر ما يجب تذكره (جهات الاتصال، التفضيلات، الحلول السابقة) وما يجب أن يكون مؤقتًا (حسابات لمرة واحدة). راقب آثار الذاكرة بانتظام.
5) اختبر باستخدام بيانات حقيقية
- املأ الوكيل بتذاكر، مستندات، وأمثلة مجهولة الهوية. لاحظ حالات الفشل (فقدان السياق، أولوية خاطئة) وصحح الموجهات/الأدوات.
6) الحواجز الأمنية أفضل من التنظيف بعد الخطأ
- أضف تحققًا في الأدوات. إذا اقترح الوكيل مدخلات غير صحيحة، يجب على المعالج التقاطها والرد بإرشادات تصحيحية.
7) سجّل كل شيء
- سجل استدعاءات الأدوات، عمليات الكتابة في الذاكرة، وتيليمترية على مستوى الرسائل. أنشئ لوحات تحكم للمقاييس الرئيسية (معدل النجاح، وقت الحل).
8) سجل إصدارات وكلائك
- تعقب تعديلات الموجهات، الأدوات، وسياسات الذاكرة. ثبّت النسخ الجيدة للإنتاج، وكرر في البيئة التجريبية.
## سير العمل الشائعة التي يمكنك إطلاقها باستخدام Letta
- دعم العملاء
- تلخيص المحادثات، اقتراح الحلول، إنشاء التذاكر، إعلام الأطراف المعنية.
- مساعد البحث
- تخطيط الاستعلامات، البحث في المصادر، التوليف، تخزين ملاحظات المصدر في الذاكرة.
- عمليات المبيعات/خدمة العملاء
- تحليل ملاحظات المكالمات، استخراج الخطوات التالية، تحديث CRM عبر الأدوات، المتابعة برسائل بريد إلكتروني جاهزة.
- الأتمتة الداخلية
- مراقبة الطوابير، تشغيل الكتيبات التنفيذية، تحديثات الحالة، والحفاظ على السياق عبر الورديات.
## استكشاف الأخطاء وإصلاحها: عندما لا يعمل الوكيل كما هو متوقع
- نسيان الوكيل للأشياء
- تحقق من تمكين الذاكرة وتناسب عتبات الاسترجاع. تأكد من أن العناصر محفوظة بالفعل.
- استدعاءات الأدوات غير سليمة
- شدّد المخططات، أضف القيم المحددة، وارجع أخطاء منظمة مع تلميحات تصحيحية.
- الوكيل كثير الكلام أو مختصر للغاية
- عدّل دليل نمط موجه النظام وقدم 2–3 أمثلة ضمن النص.
- تعليمات متضاربة
- دمج قواعد التشغيل. استعمل الأولويات الصريحة: "افعل X دائمًا قبل Y."
- انحراف بعد التحديثات
- ثبت الإصدار في الإنتاج. نفذ التغييرات تدريجيًا باستخدام الإصدارات التجريبية.
## ملاحظات سريعة حول الأمان والامتثال
- اعتبر الأدوات كمسارات كود موثوقة—قم بالمصادقة وتحديد النطاق.
- احذف البيانات الحساسة قبل تسجيل أثر الذاكرة.
- اعتبر المعلومات الشخصية في الذاكرة: سياسات الاحتفاظ، ضوابط الوصول، التشفير.
## من النموذج الأولي إلى الإنتاج: قائمة تحقق قصيرة
- أهداف واضحة للوكيل (ما هو النجاح؟).
- نطاق ضيق وموجه نظام مدفوع بإجراءات التشغيل الموحدة.
- مخططات أدوات صارمة مع التحقق والاختبارات.
- استراتيجية ذاكرة موثقة ومختبرة بمهام حقيقية.
- قابلية الملاحظة (سجلات، مقاييس، تنبيهات) مفعلة.
- خطة لإصدارات والتراجع.
- فصل بيئات التجريب والإنتاج.
## مصادر تعلم إضافية
- فيديو تعريفي: إنشاء وكيل دائم أول.
- بداية سريعة (Python/TS) مع مقتطفات الشيفرة.
- معمارية الوكيل وأفضل الممارسات.
- إعلان ADE ودليل التشغيل.
- ملاحظات إعادة التسمية والتوافق للحزم.
- مستودع مفتوح المصدر وخلفية.
## بالمناسبة: تكرار أسرع باستخدام [Sider.AI](https://sider.ai)
إذا كنت توثق الموجهات، تختبر الأمثلة، أو تقارن المخرجات عبر نسخ الوكلاء، من المفيد أن تحتفظ بالعينات جنبًا إلى جنب وتكرر بسرعة. جدير بالذكر أن [Sider.AI](https://sider.ai) (https://sider.ai/) يمكن أن تساعد الفرق على التقاط الموجهات، الملاحظات، والفروقات أثناء بناء واختبار الوكلاء—مفيد عندما يعمل عدة أشخاص على تحسين SOP أو تقييم مخططات الأدوات.
## أهم النقاط
- تساعدك Letta في بناء وكلاء دائمين بذاكرة، أدوات، وحالة مستمرة.
- ابدأ بوظيفة ضيقة ومخططات صارمة لضمان الاستقرار.
- استخدم SDK لمسارات الترميز أولًا أو ADE للنمذجة المرئية.
- سجّل، قيّم، واختبر ببيانات حقيقية قبل الإطلاق.
- استفد من البداية السريعة والدلائل الرسمية للوكلاء للبقاء على أفضل الممارسات.
### الأسئلة الشائعة
س1: ما هي Letta وكيف تختلف عن دردشة روبوت عادية؟
Letta هي منصة لبناء وكلاء ذكاء اصطناعي دائمين بذاكرة مستمرة وتنظيم الأدوات، ليست مجرد غلاف دردشة عديم الحالة. تخزن حالة الوكيل، تفرض مخططات الأدوات، وتسمح بإدارة الذاكرة وسير العمل عبر الجلسات.
س2: كيف أبدأ بسرعة باستخدام Letta؟
اتبع بداية المطور السريعة لـ Python أو TypeScript لإنشاء وكيلك الأول وإضافة أدوات. وإذا كنت تفضل المسار البصري، استخدم ADE لضبط الذاكرة، الموجهات، والأدوات قبل تصدير الإعداد.
س3: هل يمكن لـ Letta تذكر تفضيلات المستخدم والمهام السابقة؟
نعم. تدعم Letta الذاكرة الدائمة بحيث يمكن للوكلاء تخزين التفضيلات والقرارات والنتائج، ثم استرجاعها سياقيًا في التفاعلات المستقبلية. قم بتكوين سياسات الذاكرة والتحقق بها عبر مهام حقيقية.
س4: كيف تعمل الأدوات في وكلاء Letta؟
تسجل الدوال بمخططات إدخال صارمة حتى يستطيع الوكيل استدعاؤها بثقة. أضف التحقق، استخدم القيم المحددة، وارجع أخطاء منظمة لتوجيه السلوك التصحيحي عند خطأ المدخلات.
س5: هل Letta هي نفسها MemGPT؟
تبني Letta على أبحاث ونظام MemGPT لكنها المنصة والحزمة الحالية التي يجب استخدامها. تشرح ملاحظات إعادة التسمية ومستودع المصدر المفتوح الانتقال وAPIs المحدثة.