Pembatas Konten

Batasi topik tertentu dari pengunjung widget anonim (tidak terautentikasi). Pengguna terautentikasi dengan identitas terverifikasi melihat jawaban penuh.

Ikhtisar#

Pembatas Konten memungkinkan Anda mendefinisikan topik yang hanya boleh dibahas dengan pengguna terautentikasi. Ketika pengunjung anonim menanyakan topik yang dibatasi, AI merespons dengan pesan khusus alih-alih jawaban yang sebenarnya.

Ini berguna untuk melindungi informasi sensitif seperti:

Detail harga dan struktur diskon
Fitur enterprise atau roadmap internal
Dokumentasi API atau spesifikasi teknis
Informasi khusus mitra

Penyiapan#

Pembatasan topik saat ini dikonfigurasi melalui API pengaturan agen. Perbarui agen Anda dengan tiga key pengaturan:

gated_enabled (boolean) — menghidupkan atau mematikan pembatasan topik
gated_topics (larik string) — topik yang akan dibatasi. Bersikaplah spesifik — misalnya, gunakan "enterprise pricing tiers" alih-alih hanya "pricing" untuk menghindari positif palsu.
gated_message (string) — pesan yang dilihat pengguna anonim ketika menanyakan topik yang dibatasi. Jika kosong, default-nya: "This information is available to registered users. Please sign in or contact us for details."

Konfigurasikan Pembatas Konten melalui 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."
    }
  }'

Pembatas Konten juga memerlukan identifikasi pengguna untuk membedakan pengunjung terautentikasi dari yang anonim. Lihat dokumen Identifikasi Pengguna untuk instruksi penyiapan.

Jangan keliru dengan toggle Content gate pada tab Appearance channel widget — itu fitur yang berbeda: ia meminta email pengunjung sebelum mereka dapat mengobrol (lead capture) dan tidak membatasi topik.

Cara Kerjanya#

Ketika pesan tiba dari widget, sistem memeriksa apakah pengguna memiliki identitas terverifikasi:

Tipe Pengguna	Field Identitas	Topik yang Dibatasi
Terautentikasi	Memiliki `userId` atau `email` (diverifikasi HMAC ketika `identity_secret` dikonfigurasi)	Jawaban penuh — tanpa pembatasan
Anonim	Hanya `visitorId`, atau tanpa identitas sama sekali	Melihat pesan respons yang dibatasi
HMAC Gagal	Memiliki `userId` tetapi `userHash` tidak valid	Diperlakukan sebagai anonim — melihat respons yang dibatasi

Tanpa identity_secret yang dikonfigurasi, userId/email apa pun yang diteruskan ke identify() dihitung sebagai terautentikasi tanpa verifikasi — pengunjung dapat mengidentifikasi dirinya sendiri dari konsol browser dan membuka topik yang dibatasi. Setel identity_secret dan teruskan userHash agar autentikasi dapat diverifikasi; lihat Verifikasi Identitas (HMAC). Baris "HMAC Gagal" di atas hanya berlaku ketika identity_secret disetel.

Pembatas Konten bekerja pada tingkat instruksi AI. Ketika pengguna anonim menanyakan topik yang dibatasi, AI diinstruksikan untuk merespons dengan pesan khusus Anda. Topik yang tidak dibatasi dijawab secara normal untuk semua orang.

Pembatas Konten bersifat upaya terbaik, bukan kontrol akses kriptografis. AI mungkin sesekali memberikan jawaban parsial untuk pertanyaan kasus khusus. Untuk keamanan data yang ketat, pertimbangkan untuk memisahkan konten sensitif ke agen yang berbeda sepenuhnya.

Persyaratan Identitas#

Agar Pembatas Konten berfungsi, Anda perlu meneruskan identitas pengguna saat menginisialisasi widget. Berikut contoh minimal:

Inisialisasi widget dengan identitashtml

<!-- Untuk pengguna terautentikasi -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Wajib jika identity_secret disetel
  });
</script>

<!-- Untuk pengunjung anonim — cukup init tanpa identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Tanpa panggilan identify() — pengguna anonim, topik yang dibatasi akan direstriksi
</script>

Untuk penyiapan verifikasi HMAC, lihat Verifikasi Identitas (HMAC).

Pembatas Konten vs Topik yang Dihindari

Topik yang Dihindari memblokir topik untuk semua pengguna — baik terautentikasi maupun anonim. Gunakan untuk topik yang tidak boleh dibahas agen (misalnya, perbandingan pesaing, nasihat hukum).

Pembatas Konten memblokir topik hanya untuk pengguna anonim. Pengguna terautentikasi melihat jawaban penuh. Gunakan untuk informasi yang ingin Anda bagikan dengan pelanggan tetapi tidak dengan publik (misalnya, harga, fitur internal).