שער תוכן
הגבילו נושאים ספציפיים מפני מבקרים אנונימיים (לא מאומתים) בווידג׳ט. משתמשים מאומתים עם זהות מאומתת רואים תשובות מלאות.
סקירה כללית#
שער תוכן מאפשר לכם להגדיר נושאים שיש לדון בהם רק עם משתמשים מאומתים. כשמבקר אנונימי שואל על נושא חסום, ה-AI משיב בהודעה מותאמת אישית במקום בתשובה האמיתית.
זה שימושי להגנה על מידע רגיש כמו:
- פרטי תמחור ומבני הנחות
- תכונות ארגוניות או מפת דרכים פנימית
- תיעוד API או מפרטים טכניים
- מידע ספציפי לשותפים
התקנה#
חסימת נושאים מוגדרת כרגע דרך ה-API של הגדרות הסוכן. עדכנו את הסוכן שלכם עם שלושה מפתחות הגדרות:
gated_enabled(boolean) — מפעיל או מכבה את חסימת הנושאיםgated_topics(מערך מחרוזות) — הנושאים שיש להגביל. היו ספציפיים — למשל, השתמשו ב-"דרגות תמחור ארגוניות" במקום סתם "תמחור" כדי להימנע מזיהוי שגוי חיובי.gated_message(מחרוזת) — ההודעה שמשתמשים אנונימיים רואים כששואלים על נושא חסום. כשהיא ריקה, ברירת המחדל היא: "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/email שמועבר ל-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>
<!-- עבור מבקרים אנונימיים — פשוט אתחלו ללא identify -->
<script>
Respondo.init({ agentId: 'YOUR_AGENT_ID' });
// ללא קריאה ל-identify() — המשתמש אנונימי, נושאים חסומים יוגבלו
</script>להגדרת אימות HMAC, עיינו ב- אימות זהות (HMAC).
שער תוכן לעומת נושאים שיש להימנע מהם
נושאים שיש להימנע מהם חוסם נושאים עבור כל המשתמשים — גם מאומתים וגם אנונימיים. השתמשו בו לנושאים שהסוכן לעולם לא צריך לדון בהם (למשל, השוואות מתחרים, ייעוץ משפטי).
שער תוכן חוסם נושאים רק עבור משתמשים אנונימיים. משתמשים מאומתים רואים תשובות מלאות. השתמשו בו למידע שאתם רוצים לשתף עם לקוחות אך לא עם הציבור (למשל, תמחור, תכונות פנימיות).