תיעוד

שער תוכן

הגבילו נושאים ספציפיים מפני מבקרים אנונימיים (לא מאומתים) בווידג׳ט. משתמשים מאומתים עם זהות מאומתת רואים תשובות מלאות.

סקירה כללית#

שער תוכן מאפשר לכם להגדיר נושאים שיש לדון בהם רק עם משתמשים מאומתים. כשמבקר אנונימי שואל על נושא חסום, ה-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."
הגדרת שער תוכן דרך ה-APIbash
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."
    }
  }'

שער תוכן דורש גם זיהוי משתמש כדי להבחין בין מבקרים מאומתים לאנונימיים. עיינו בתיעוד זיהוי משתמשים לקבלת הוראות התקנה.

אל תתבלבלו עם מתג ה-Content gate בלשונית ה-Appearance של ערוץ הווידג׳ט — זו תכונה אחרת: היא מבקשת מהמבקרים אימייל לפני שהם יכולים לשוחח (לכידת לידים) ואינה חוסמת נושאים.

איך זה עובד#

כשמגיעה הודעה מהווידג׳ט, המערכת בודקת האם למשתמש יש זהות מאומתת:

סוג משתמששדות זהותנושאים חסומים
מאומתיש userId או email (מאומת HMAC כאשר identity_secret מוגדר)תשובות מלאות — ללא הגבלות
אנונימירק visitorId, או ללא זהות כללרואה את הודעת התגובה החסומה
HMAC נכשליש userId אך userHash לא תקיןמטופל כאנונימי — רואה את התגובה החסומה
ללא identity_secret מוגדר, כל userId/email שמועבר ל-identify() נחשב מאומת ללא בדיקה — מבקר יכול לזהות את עצמו מקונסולת הדפדפן ולפתוח נושאים חסומים. הגדירו identity_secret והעבירו userHash כדי להפוך את האימות לבר-אימות; ראו אימות זהות (HMAC). שורת "HMAC נכשל" שלמעלה חלה רק כאשר identity_secret מוגדר.
שער תוכן פועל ברמת ההנחיה ל-AI. כשמשתמש אנונימי שואל על נושא חסום, ה-AI מונחה להשיב בהודעה המותאמת אישית שלכם. נושאים שאינם חסומים נענים כרגיל לכולם.
שער תוכן הוא מאמץ מיטבי, לא בקרת גישה קריפטוגרפית. ה-AI עלול מדי פעם לספק תשובות חלקיות לשאלות קצה. עבור אבטחת נתונים קפדנית, שקלו להפריד את התוכן הרגיש לסוכן נפרד לחלוטין.

דרישת זהות#

כדי ששער תוכן יעבוד, עליכם להעביר זהות משתמש בעת אתחול הווידג׳ט. הנה דוגמה מינימלית:

אתחול הווידג׳ט עם זהותhtml
<!-- עבור משתמשים מאומתים -->
<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).

שער תוכן לעומת נושאים שיש להימנע מהם

נושאים שיש להימנע מהם חוסם נושאים עבור כל המשתמשים — גם מאומתים וגם אנונימיים. השתמשו בו לנושאים שהסוכן לעולם לא צריך לדון בהם (למשל, השוואות מתחרים, ייעוץ משפטי).

שער תוכן חוסם נושאים רק עבור משתמשים אנונימיים. משתמשים מאומתים רואים תשובות מלאות. השתמשו בו למידע שאתם רוצים לשתף עם לקוחות אך לא עם הציבור (למשל, תמחור, תכונות פנימיות).