ما تفعله
- الحفظ —
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 كامل لمستخدم نهائي.