ما تفعله
- الحفظ —
POST /api/v1/memoriesيخزّن ملاحظة لمستخدم نهائي واحد. مُزال التكرار حسب المحتوى. استيراد دفعي حتى 100 في المرة مع/memories/batch. - البحث —
POST /api/v1/search: مطابقات مُرتَّبة بأقل من ثانية على ذاكرة مستخدم واحد. استخدمه عندما يقوم وكيلك بالتفكير ويحتاج فقط مادة خام ذات صلة. - الاستدعاء العميق —
POST /api/v1/recall: إجابة مُركَّبة مُدعَّمة بالاستشهادات (“ماذا نعرف عن هذا المستخدم فيما يتعلق بـ X”) مُصمَّمة لتُحقن في موجّه نظام عند بدء الجلسة. - الاقتراحات —
POST /api/v1/suggestions: بمعطى لحظة سياق، حتى 5 إجراءات ملموسة تالية، كل منها مُدعَّم بذاكرة محددة — لا نصائح عامة أبداً. تُعيد[]للمستخدمين الجدد، لذا اعرض بشكل شرطي واجلب بشكل غير متزامن. - استيعاب الموصلات — يوصّل المستخدمون النهائيون أدواتهم (التكاملات) وتملأ ذاكرتهم نفسها، مُنظَّمة في حاويات لكل مصدر.
الذكريات المملوكة للمصدر
إذا كنت تُزامن الذكريات من نظام سجل (صفوف CRM، حقول الملف الشخصي، التذاكر)، استخدم سطح دورة الحياة المُصدَّر: تحمل عمليات upsert والحذفversion، لذا فإن التسليمات خارج الترتيب وإعادات محاولة الأعطال آمنة بحكم البنية. اقرأ دليل الذكريات المملوكة للمصدر.
دورة الحياة والامتثال
DELETE /api/v1/memories/by-id/{memoryId}— إزالة ذاكرة واحدة.DELETE /api/v1/containers/{containerTag}— إسقاط ذكريات مصدر واحد لمستخدم.DELETE /api/v1/users/{endUserId}— مسح كامل بموجب GDPR لمستخدم نهائي.