Inhaltssperre

Mit der Inhaltssperre können Sie Themen definieren, die nur mit authentifizierten Nutzern besprochen werden sollen. Wenn ein anonymer Besucher nach einem gesperrten Thema fragt, antwortet die KI mit einer benutzerdefinierten Nachricht anstelle der eigentlichen Antwort.

Das ist nützlich, um sensible Informationen zu schützen, wie zum Beispiel:

• Preisdetails und Rabattstrukturen
• Enterprise-Funktionen oder interne Roadmap
• API-Dokumentation oder technische Spezifikationen
• Partnerspezifische Informationen

Das Themen-Gating wird derzeit über die Agent-Einstellungs-API konfiguriert. Aktualisieren Sie Ihren Agenten mit drei Einstellungsschlüsseln:

• gated_enabled (boolean) — schaltet das Themen-Gating ein oder aus
• gated_topics (Array von Strings) — die einzuschränkenden Themen. Seien Sie spezifisch — verwenden Sie zum Beispiel „Enterprise-Preisstufen“ statt nur „Preise“, um Fehlalarme zu vermeiden.
• gated_message (String) — die Nachricht, die anonyme Nutzer sehen, wenn sie nach einem gesperrten Thema fragen. Ist sie leer, lautet der Standard: "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."
    }
  }'

Die Inhaltssperre erfordert außerdem eine Nutzeridentifikation, um authentifizierte von anonymen Besuchern zu unterscheiden. Anweisungen zur Einrichtung finden Sie in der Dokumentation Nutzeridentifikation.

Wenn eine Nachricht vom Widget eintrifft, prüft das System, ob der Nutzer über eine verifizierte Identität verfügt:

Damit die Inhaltssperre funktioniert, müssen Sie beim Initialisieren des Widgets die Nutzeridentität übergeben. Hier ist ein minimales Beispiel:

<!-- Für authentifizierte Nutzer -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  Respondo.identify({
    userId: 'user-123',
    email: 'user@example.com',
    userHash: 'HMAC_SHA256_HASH'  // Erforderlich, wenn identity_secret gesetzt ist
  });
</script>

<!-- Für anonyme Besucher — einfach init ohne identify -->
<script>
  Respondo.init({ agentId: 'YOUR_AGENT_ID' });
  // Kein identify()-Aufruf — der Nutzer ist anonym, gesperrte Themen werden eingeschränkt
</script>

Zur Einrichtung der HMAC-Verifizierung siehe Identitätsverifizierung (HMAC).