Dokumentacja

Bramka treści

Ograniczaj określone tematy dla anonimowych (nieuwierzytelnionych) odwiedzających widget. Uwierzytelnieni użytkownicy o zweryfikowanej tożsamości widzą pełne odpowiedzi.

Przegląd

Bramka treści pozwala zdefiniować tematy, które powinny być omawiane wyłącznie z uwierzytelnionymi użytkownikami. Gdy anonimowy odwiedzający zapyta o temat objęty bramką, AI odpowiada niestandardowym komunikatem zamiast rzeczywistej odpowiedzi.

Przydaje się to do ochrony wrażliwych informacji, takich jak:

  • Szczegóły cenowe i struktury rabatów
  • Funkcje dla przedsiębiorstw lub wewnętrzny plan rozwoju
  • Dokumentacja API lub specyfikacje techniczne
  • Informacje specyficzne dla partnerów

Konfiguracja

Bramkowanie tematów konfiguruje się obecnie przez API ustawień agenta. Zaktualizuj swojego agenta trzema kluczami ustawień:

  • gated_enabled (boolean) — włącza lub wyłącza bramkowanie tematów
  • gated_topics (tablica ciągów znaków) — tematy do ograniczenia. Bądź konkretny — na przykład użyj "poziomy cenowe dla przedsiębiorstw" zamiast po prostu "ceny", aby uniknąć fałszywych trafień.
  • gated_message (string) — komunikat, który anonimowi użytkownicy widzą, pytając o temat objęty bramką. Gdy jest pusty, domyślnie brzmi: "This information is available to registered users. Please sign in or contact us for details."
Konfiguracja Bramki treści przez 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."
    }
  }'

Bramka treści wymaga też identyfikacji użytkownika, aby odróżnić uwierzytelnionych od anonimowych odwiedzających. Instrukcje konfiguracji znajdziesz w dokumentacji Identyfikacja użytkownika.

Nie myl tego z przełącznikiem Content gate na karcie Wygląd kanału widgetu — to inna funkcja: prosi odwiedzających o e-mail, zanim będą mogli czatować (pozyskiwanie leadów), i nie bramkuje tematów.

Jak to działa

Gdy z widgetu nadejdzie wiadomość, system sprawdza, czy użytkownik ma zweryfikowaną tożsamość:

Typ użytkownikaPola tożsamościTematy objęte bramką
UwierzytelnionyMa userId lub email (weryfikowane HMAC, gdy skonfigurowano identity_secret)Pełne odpowiedzi — bez ograniczeń
AnonimowyTylko visitorId lub brak tożsamości w ogóleWidzi komunikat odpowiedzi bramki
Nieudany HMACMa userId, ale nieprawidłowy userHashTraktowany jako anonimowy — widzi odpowiedź bramki
Bez skonfigurowanego identity_secret dowolny userId/email przekazany do identify() liczy się jako uwierzytelniony bez weryfikacji — odwiedzający może zidentyfikować się samodzielnie z konsoli przeglądarki i odblokować tematy objęte bramką. Ustaw identity_secret i przekazuj userHash, aby uwierzytelnienie było weryfikowalne; zobacz Weryfikacja tożsamości (HMAC). Wiersz "Nieudany HMAC" powyżej dotyczy tylko sytuacji, gdy identity_secret jest ustawiony.
Bramka treści działa na poziomie instrukcji AI. Gdy anonimowy użytkownik zapyta o temat objęty bramką, AI otrzymuje instrukcję, aby odpowiedzieć Twoim niestandardowym komunikatem. Tematy nieobjęte bramką są dla wszystkich odpowiadane normalnie.
Bramka treści działa na zasadzie największej staranności, a nie kryptograficznej kontroli dostępu. AI może czasami udzielić częściowych odpowiedzi na pytania graniczne. Dla ścisłej ochrony danych rozważ całkowite wydzielenie wrażliwej treści do osobnego agenta.

Wymóg tożsamości

Aby Bramka treści działała, musisz przekazać tożsamość użytkownika podczas inicjalizacji widgetu. Oto minimalny przykład:

Inicjalizacja widgetu z tożsamościąhtml
<!-- Dla uwierzytelnionych użytkowników -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Wymagane, jeśli ustawiono identity_secret
  });
</script>

<!-- Dla anonimowych odwiedzających — po prostu init bez identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Brak wywołania identify() — użytkownik jest anonimowy, tematy objęte bramką będą ograniczone
</script>

Konfigurację weryfikacji HMAC znajdziesz w Weryfikacja tożsamości (HMAC).

Bramka treści a Tematy do unikania

Tematy do unikania blokują tematy dla wszystkich użytkowników — zarówno uwierzytelnionych, jak i anonimowych. Używaj tego dla tematów, których agent nigdy nie powinien poruszać (np. porównania z konkurencją, porady prawne).

Bramka treści blokuje tematy wyłącznie dla anonimowychużytkowników. Uwierzytelnieni użytkownicy widzą pełne odpowiedzi. Używaj tego dla informacji, którymi chcesz dzielić się z klientami, ale nie z opinią publiczną (np. ceny, funkcje wewnętrzne).