Dokumentation
Implementierungsleitfäden für die sicheren und rechtskonformen KI-Lösungen von ContentCloud. Die unten beschriebene Website-Einbindung ist bereits öffentlich verfügbar. Ingestion-, Administrations- und Plattform-APIs werden derzeit gemeinsam mit unserem Team beim Onboarding, in Pilotprojekten oder bei der Lösungsplanung eingerichtet.
Schnellstart: CCBot auf Ihrer Website einbinden
Dies sind dieselben Schritte, die wir für das Widget auf dieser Website verwenden. Für Schritt 3 benötigen Sie einen API-Schlüssel aus Ihrem ContentCloud-Tenant.
Zugang und API-Schlüssel anfordern
API-Schlüssel werden beim Onboarding oder im Rahmen eines Pilotprojekts bereitgestellt. Kontaktieren Sie uns, damit wir Ihren Tenant und Ihren Schlüssel einrichten.
Widget-Paket installieren
Das React-Widget ist über npm verfügbar. Es wird in einem Shadow DOM gerendert und bringt eigene Styles mit, sodass keine Konflikte mit Ihrem Website-CSS entstehen.
npm install @eworx-org/ccbot-reactAPI-Schlüssel serverseitig gegen ein Sitzungs-Token tauschen
Bewahren Sie den API-Schlüssel auf dem Server auf. Ihr Endpunkt tauscht ihn gegen ein kurzlebiges Sitzungs-Token (Chat Session Token), sodass der Schlüssel niemals in den Browser gelangt. Übergeben Sie die IP-Adresse des Besuchers im Header X-Visitor-IP (über den letzten von Ihrem eigenen Proxy angehängten X-Forwarded-For-Eintrag), damit das Rate-Limiting pro Besucher greift. Leiten Sie den Request-Body des Widgets weiter und geben Sie die Antwort unverändert zurück: Sie enthält das anonyme Geheimnis, mit dem der Chat-Nutzer eines Besuchers über Seitenaufrufe hinweg erhalten bleibt.
// POST /api/ccbot/token (server-side only)
const visitorIp = req.headers.get('x-forwarded-for')?.split(',').pop().trim();
const res = await fetch(
'https://www.contentcloud.com/services/chat-token-service/exchange',
{
method: 'POST',
headers: {
'X-Api-Key': process.env.CONTENT_CLOUD_API_KEY,
'Content-Type': 'application/json',
...(visitorIp && { 'X-Visitor-IP': visitorIp }),
},
body: await req.text(), // { anonymousSecret? } from the widget
},
);
return Response.json(await res.json()); // { token, anonymousSecret }Widget einbinden
Verbinden Sie das Widget mit Ihrem Token-Endpunkt. Genau so ist auch das Widget auf dieser Website eingebunden.
import { CCbotWidget } from '@eworx-org/ccbot-react';
<CCbotWidget auth={{ tokenEndpoint: '/api/ccbot/token' }} />Drupal-Websites: Verwenden Sie das ContentCloud-Drupal-Modul anstelle des React-Pakets – es übernimmt die Platzierung und Konfiguration des Widgets unter Drupal 9, 10 und 11. Modul und Installationshinweise bei uns anfordern.
Begleitung für Ihr Team
Die folgenden Themen behandeln wir beim Onboarding, in Pilotprojekten und bei der Lösungsplanung. Die zugehörige Dokumentation stellen wir Ihrem Team direkt bereit.
Onboarding und Inhalts-Ingestion
Meist 1–2 SitzungenEinrichtung Ihres Projekts und Aufnahme Ihrer ersten Quellen gemeinsam mit unserem Team.
- Projekt- und Tenant-Einrichtung
- Quellenauswahl und Zeitplan für die Ingestion
- Geltungsbereich, Positiv-/Negativlisten und Antwortrichtlinien
- Überprüfung der Antworten anhand Ihrer Originalquellen
Drupal-Modul
Meist ein halber TagInstallation des ContentCloud-Moduls unter Drupal 9/10/11 und Platzierung des Widgets.
- Modulinstallation über Composer
- Konfiguration des API-Schlüssels
- Platzierung und visuelle Anpassung des Widgets
- Inhaltssynchronisierung
React- / JavaScript-Einbindung
Meist 1–2 StundenEinbindung des Widgets über das öffentliche npm-Paket (wie auf dieser Website).
- Installation von @eworx-org/ccbot-react
- Hinzufügen eines serverseitigen Token-Austausch-Endpunkts
- Einbinden der Widget-Komponente
- Styling-Anpassungen im Shadow DOM
Enterprise-Bereitstellung
Je Bereitstellung abgestimmtDedizierte EU-Cloud oder On-Premises-Bereitstellung, abgestimmt mit unseren Ingenieuren.
- SSO-Integration (SAML/OIDC, EU Login)
- On-Premises- oder Private-Cloud-Installation
- Hardware-Dimensionierung und dedizierte GPU-Optionen
- Monitoring und Betrieb
Sicherheits- und Compliance-Prüfung
Auf Anfrage bereitgestelltUnterlagen für Datenschutz-Folgenabschätzungen (DSFA/DPIA), Sicherheitsprüfungen und Vergabeverfahren.
- Datenhaltung, Verschlüsselung und Aufbewahrung
- Zugriffskontrollen und Audit-Protokollierung
- AVV (DPA) und Informationen zu Unterauftragnehmern
- EU AI Act- und DSGVO-Dokumentation
Einrichtung des Memory-Pilotprojekts
Pilot-OnboardingEinrichtung von Desktop-, Mobil- und Portal-Anwendung für Teilnehmende am Memory-Pilotprogramm.
- Installation von Memory Sidekick und Memory Mobile
- Auswahl der Erfassungsquellen pro Gerät
- Arbeitsbereichsrichtlinien und Aufbewahrung
- Self-Hosting mit Docker Compose
Plattform-APIs
Ingestion-, Administrations- und Abfrage-APIs sind in der Plattform vorhanden und werden für Kundenintegrationen eingesetzt, sind jedoch noch nicht als öffentliche Self-Service-API veröffentlicht. Endpunkte, Authentifizierungsdetails und Ratenbegrenzungen werden im Rahmen Ihres Tenants beim Onboarding oder in einem Pilotprojekt bereitgestellt.
Eine öffentlich dokumentierte API steht auf unserer Roadmap. Geben Sie uns gerne Bescheid, wenn Ihre Evaluierung davon abhängt.
Benötigen Sie Hilfe?
Technischer Support
Unterstützung bei Integration, Fehlerbehebung und Bereitstellungsfragen per E-Mail zu den europäischen Geschäftszeiten.
Support kontaktieren →Häufig gestellte Fragen
Antworten zu Bereitstellung, Datenverarbeitung, Preisen, Pilotprojekten, CCBot Mobile und Memory.
FAQs ansehen →