بوابة المحتوى
قيّد مواضيع محددة عن زوار الأداة المجهولين (غير المصادَق عليهم). يرى المستخدمون المصادَق عليهم بهوية مؤكدة الإجابات الكاملة.
نظرة عامة#
تتيح لك بوابة المحتوى تعريف مواضيع ينبغي مناقشتها فقط مع المستخدمين المصادَق عليهم. عندما يسأل زائر مجهول عن موضوع مقيَّد، يرد الذكاء الاصطناعي برسالة مخصصة بدلاً من الإجابة الفعلية.
هذا مفيد لحماية المعلومات الحساسة مثل:
- تفاصيل التسعير وهياكل الخصومات
- ميزات المؤسسات أو خارطة الطريق الداخلية
- وثائق API أو المواصفات التقنية
- معلومات خاصة بالشركاء
الإعداد#
يُضبط تقييد المواضيع حالياً عبر واجهة API لإعدادات الوكيل. حدّث وكيلك بثلاثة مفاتيح إعدادات:
gated_enabled(boolean) — يشغّل تقييد المواضيع أو يوقفهgated_topics(مصفوفة نصوص) — المواضيع المراد تقييدها. كن محدداً — على سبيل المثال، استخدم "باقات تسعير المؤسسات" بدلاً من مجرد "التسعير" لتجنّب الإيجابيات الخاطئة.gated_message(string) — الرسالة التي يراها المستخدمون المجهولون عند السؤال عن موضوع مقيَّد. عندما تكون فارغة، تكون القيمة الافتراضية: "This information is available to registered users. Please sign in or contact us for details."
curl -X PATCH https://api.respondo.ai/api/v1/agents/<agent-uuid> \
-H "Authorization: Bearer <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"settings": {
"gated_enabled": true,
"gated_topics": ["enterprise pricing tiers", "internal roadmap"],
"gated_message": "This information is available to registered users. Please sign in or contact our sales team for details."
}
}'تتطلب بوابة المحتوى أيضاً تحديد هوية المستخدم للتمييز بين الزوار المصادَق عليهم والمجهولين. راجع وثائق تحديد هوية المستخدم للحصول على تعليمات الإعداد.
كيف يعمل#
عند وصول رسالة من الأداة، يتحقق النظام مما إذا كان لدى المستخدم هوية مؤكدة:
| نوع المستخدم | حقول الهوية | المواضيع المقيَّدة |
|---|---|---|
| مصادَق عليه | لديه userId أو email (مُتحقَّق منه عبر HMAC عندما يكون identity_secret مضبوطاً) | إجابات كاملة — لا قيود |
| مجهول | فقط visitorId، أو لا هوية على الإطلاق | يرى رسالة الرد المقيَّد |
| فشل HMAC | لديه userId لكن userHash غير صالح | يُعامَل كمجهول — يرى الرد المقيَّد |
identity_secret، يُحتسب أي userId/بريد إلكتروني يُمرَّر إلى identify() مصادَقاً عليه دون تحقق — يمكن للزائر أن يعرّف نفسه من وحدة تحكم المتصفح ويفتح المواضيع المقيَّدة. اضبط identity_secret ومرّر userHash لجعل المصادقة قابلة للتحقق؛ راجع التحقق من الهوية (HMAC). لا ينطبق صف "فشل HMAC" أعلاه إلا عندما يكون identity_secret مضبوطاً.متطلب الهوية#
لكي تعمل بوابة المحتوى، تحتاج إلى تمرير هوية المستخدم عند تهيئة الأداة. إليك مثالاً بسيطاً:
<!-- للمستخدمين المصادَق عليهم -->
<script>
Respondo.init({ agentId: 'YOUR_AGENT_ID' });
Respondo.identify({
userId: 'user-123',
email: 'user@example.com',
userHash: 'HMAC_SHA256_HASH' // مطلوب إذا كان identity_secret مضبوطاً
});
</script>
<!-- للزوار المجهولين — فقط init دون identify -->
<script>
Respondo.init({ agentId: 'YOUR_AGENT_ID' });
// لا استدعاء لـ identify() — المستخدم مجهول، وستُقيَّد المواضيع المقيَّدة
</script>لإعداد التحقق عبر HMAC، راجع التحقق من الهوية (HMAC).
بوابة المحتوى مقابل المواضيع المحظورة
تحظر المواضيع المحظورة مواضيع لدى جميع المستخدمين — المصادَق عليهم والمجهولين على حد سواء. استخدمها للمواضيع التي ينبغي ألا يناقشها الوكيل أبداً (مثل مقارنات المنافسين، الاستشارات القانونية).
تحظر بوابة المحتوى المواضيع لدى المستخدمين المجهولين فقط. يرى المستخدمون المصادَق عليهم الإجابات الكاملة. استخدمها للمعلومات التي تريد مشاركتها مع العملاء دون العامة (مثل التسعير، الميزات الداخلية).