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

أسئلة شائعة حول Seizn Memory API، من البداية إلى العمليات المتقدمة.

Q1ما هو Seizn Memory وما المشكلة التي يحلها؟
Seizn Memory هي بنية تحتية لذاكرة الذكاء الاصطناعي توفر ذاكرة دائمة وقابلة للبحث لتطبيقات الذكاء الاصطناعي. على عكس قواعد البيانات المتجهة التي تخزن/تبحث فقط في المتجهات، يتضمن Seizn طبقة المنتج الكاملة: استخراج الذاكرة، إدارة السياسات، إدارة المفاتيح، الحذف، سجلات التدقيق، وأدوات التطوير. يحل مشكلة الحفاظ على السياق عبر جلسات الذكاء الاصطناعي وتمكين تجارب ذكاء اصطناعي مخصصة.
البدء
Q2كيف يختلف Seizn عن قواعد البيانات المتجهة مثل Pinecone أو Weaviate؟
قواعد البيانات المتجهة هي بنية تحتية للتخزين/البحث للمتجهات. Seizn هو نظام ذاكرة كامل مبني فوق ذلك، يوفر: استخراج الذاكرة التلقائي من المحادثات، تصنيف أنواع الذاكرة، إدارة النطاق/النطاق، تدوير مفاتيح API، سجلات التدقيق، أدوات التطوير، وميزات الحوكمة. فكر فيها كـ 'بنية تحتية للذاكرة' مقابل 'بنية تحتية للبحث'.
البدء
Q3هل أحتاج RAG لاستخدام Seizn؟
لا. نقطة البداية الأكثر شيوعاً هي: تخزين الذاكرة -> البحث -> الحقن في الموجه. RAG (تركيب السياق التلقائي + توليد الاستجابة) هو الخطوة التالية. يمكنك البدء ببساطة وإضافة التعقيد حسب الحاجة.
البدء
Q4ما هي أسرع طريقة لبناء PoC؟
1) POST /api/memories لتخزين تفضيل المستخدم. 2) GET /api/memories للبحث. 3) حقن النتائج في موجه LLM الخاص بك. 4) لاحقاً، أضف /api/extract للاستخراج التلقائي و/api/query للاستجابات المعززة بالذاكرة.
البدء
Q5ماذا يجب أن أخزن في /api/memories؟
خزّن المعلومات التي تبقى صالحة عبر المحادثات: التفضيلات (النبرة، اللغة، التنسيق)، الحقائق (العمل، الأدوات، هيكل المشروع)، التعليمات ("دائماً لخص في جداول")، العلاقات ("أليس هي قائدة الفريق"). تجنب تخزين البيانات المؤقتة أو الخاصة بالجلسة إلا إذا كنت تستخدم نطاق الجلسة.
المفاهيم الأساسية
Q6ما البيانات التي يجب ألا أخزنها؟
لا تخزن أبداً: كلمات المرور، مفاتيح API، الرموز، ملفات تعريف الارتباط للجلسة (معلومات المصادقة)، SSN، أرقام جوازات السفر، الحسابات المصرفية (PII)، معلومات بطاقة الائتمان (بيانات الدفع). للبيانات المؤقتة، استخدم نطاق الجلسة مع TTL إذا لزم الأمر.
المفاهيم الأساسية
Q7لماذا النطاق مهم؟
النطاق يفصل الذكريات حسب المشروع/المستأجر/البيئة. بدونه، تختلط البيانات، وتنخفض جودة البحث، ويصبح الحذف/التصدير صعباً. موصى به: 'org:acme/app:chat/env:prod' أو 'project:myapp/env:staging'. لا تستخدم أبداً 'default' فقط في الإنتاج.
المفاهيم الأساسية
Q8متى يجب استخدام النطاق (user/session/agent)؟
user: التفضيلات التي تنطبق على المستخدم عالمياً. session: الأهداف أو السياق الصالح فقط لهذه المحادثة. agent: القواعد الخاصة بوكيل واحد في نظام متعدد الوكلاء. الاستخدام الصحيح للنطاق يقلل من طول الموجه ويحسن اتساق الاستجابة.
المفاهيم الأساسية
Q9ما هي memory_types ولماذا هي مهمة؟
memory_type تصنف الذكريات: fact (معلومات ثابتة)، preference (اختيارات المستخدم)، instruction (قواعد للاتباع)، relationship (روابط الأشخاص/المنظمات)، experience (أحداث ماضية). هذا هو المحور الأقوى للتصفية والحذف وتطبيق السياسات.
المفاهيم الأساسية
Q10كيف يعمل threshold و limit؟
limit: عدد ذكريات المرشحين للاسترجاع (منخفض جداً = فقدان ذات الصلة، مرتفع جداً = سياق صاخب). threshold: قطع التشابه 0-1 (أعلى = أكثر صرامة). ابدأ بـ limit=10، threshold=0.7. إذا فقدت ذكريات، خفض threshold إلى 0.6 وارفع limit إلى 20. إذا حصلت على نتائج غير ذات صلة، ارفع threshold إلى 0.75-0.8.
البحث والاسترجاع
Q11لماذا نتائج البحث الخاصة بي غير ذات صلة؟
عادة واحدة من: 1) النطاقات مختلطة، 2) ذكريات كثيرة مخزنة (ضوضاء)، 3) threshold منخفض جداً، 4) المحتوى مجرد جداً ('يحب الأشياء' مقابل حقائق محددة). الحل: فصل النطاقات، جعل المحتوى محدداً، رفع threshold.
البحث والاسترجاع
Q12انخفضت جودة البحث مع نمو الذكريات. ماذا أفعل؟
أضف تسجيل الأهمية واحتفظ فقط بالذكريات عالية الأهمية. استخدم TTL لانتهاء صلاحية الذكريات القديمة تلقائياً. دمج الذكريات المتشابهة بشكل دوري في ملخصات. افصل النطاقات لتقليل نطاق البحث.
البحث والاسترجاع
Q13كيف يجب استخدام /api/extract؟
التدفق الموصى به: 1) استدعاء مع auto_store=false لمعاينة الذكريات المستخرجة. 2) عرض النتائج للمستخدم للتأكيد. 3) تخزين الذكريات المعتمدة فقط. 4) بمجرد إثبات جودة الاستخراج، انتقل إلى auto_store=true للأتمتة.
الاستخراج
Q14ما الفرق بين model=haiku و model=sonnet؟
haiku: أسرع، أرخص، جيد لمعظم الحالات. sonnet: أكثر دقة، أفضل للاستخراجات المهمة (التأهيل، العقود، السياسات). استخدم haiku للاستخراج بالجملة/الأولي، sonnet للسيناريوهات عالية المخاطر.
الاستخراج
Q15هل يمكنني تعديل ذاكرة بعد تخزينها؟
نعم، لكن النمط الموصى به هو: إنشاء ذاكرة جديدة + حذف/أرشفة القديمة. هذا النهج أفضل لمسارات التدقيق ويمنع مشاكل التراجع.
العمليات
Q16كيف أحذف الذكريات؟
نهجان: 1) الحذف بـ ID (دقيق)، 2) الحذف بالنطاق (تنظيف جماعي). للمؤسسات/الامتثال، تأكد من 'الحذف الكامل + سجل التدقيق'. وثّق سياسة الحذف الخاصة بك بوضوح.
العمليات
Q17أحصل على 429 Too Many Requests. ماذا أفعل؟
لقد وصلت إلى حد المعدل. الحلول: 1) تنفيذ التراجع الأسي (1ث -> 2ث -> 4ث). 2) وضع الطلبات في قائمة انتظار من جانب الخادم. 3) تقليل تكرار الطلبات: تخزين الاستعلامات المكررة مؤقتاً، العمليات الدفعية، تقليل تكرار الاستخراج.
العمليات
Q18كيف أقلل التكاليف؟
أكبر محركات التكلفة: 1) تكرار الاستخراج - قلل الاستدعاءات. 2) نطاق البحث - استخدم النطاق للتضييق. 3) اختيار النموذج - استخدم haiku للروتين، sonnet للمهم. 4) التخزين المؤقت - خزّن الاستعلامات المتكررة مؤقتاً. 5) العمليات الدفعية عند الإمكان.
العمليات
Q19هل يمكنني استخدام مفتاح API في المتصفح (الواجهة الأمامية)؟
غير موصى به - خطر عالٍ لكشف المفتاح. استدعِ Seizn من خادمك (Next.js Route Handler، Cloudflare Worker، دالة serverless) واجعل المتصفح يستدعي خادمك. لا تكشف أبداً مفاتيح API للكود من جانب العميل.
الأمان والامتثال
Q20ما الوثائق التي يحتاجها فريق الأمان/القانون؟
سيريدون: 1) نطاق البيانات (ما يتم تخزينه/لا يتم تخزينه)، 2) التشفير (في السكون: AES-256، في النقل: TLS)، 3) طريقة عزل المستأجر، 4) سياسة الحذف/الاحتفاظ، 5) الوصول إلى سجلات التدقيق، 6) سياسة تدوير/انتهاء صلاحية المفتاح. احتفظ بصفحة الأمان والحوكمة في وثائقك.
الأمان والامتثال

لا تزال لديك أسئلة؟

راجع وثائقنا أو تواصل مع فريق الدعم لدينا.