IntegrationsmaterialIntegration material
Beginnen Sie ohne Zugangsdaten. Die Plattform läuft vollständig auf Mock-Engines — Sie können jede Schnittstelle ausprobieren, bevor Sie einen einzigen Schlüssel beantragen. Start without credentials. The platform runs entirely on mock engines, so you can exercise every interface before requesting a single key.
Sechs Schritte bis zur ersten Antwort. Six steps to the first answer.
Was die Plattform kann — und was noch nicht. What the platform does — and what it does not yet.
Was Sie bereitstellen — und wann. What you supply — and when.
Die Phasen einer Anbindung, mit Abhängigkeiten. The phases of an integration, with dependencies.
Schritt für Schritt, zum Kopieren. Step by step, copy-pasteable.
In fünf MinutenIn five minutes
Der Schnellstart startet ACP im selben Prozess auf Mock-Engines und führt durch Mandant, Wissen, Abruf, Gespräch, Ereignisse und Widget. Er benötigt weder Netz noch Zugangsdaten. The quickstart runs ACP in-process on mock engines and walks through tenant, knowledge, retrieval, a conversation, events and the widget. It needs neither network nor credentials.
git clone <repo> && cd acp
make install
python sdk/python/quickstart.pyHaben Sie bereits einen Schlüssel für eine laufende Instanz, brauchen Sie das Repository nicht: der Schnellstart führt dieselben Schritte als sechs HTTP-Aufrufe. If you already hold a key for a running instance you do not need the repository: the quickstart walks the same steps as six HTTP calls.
Die eine RegelThe one rule
Ein API-Schlüssel (acp_sk_) gehört niemals in eine Webseite. Er gewährt Lese- und Schreibzugriff auf den gesamten Mandanten. Das Widget verwendet einen öffentlichen, an die Herkunft gebundenen Schlüssel (acp_pk_) — er ist absichtlich öffentlich und aus einer fremden Domain wertlos. An API key (acp_sk_) never belongs in a web page. It grants read and write across the whole tenant. The widget uses a public, origin-bound key (acp_pk_) — public by design, and worthless from anyone else's domain.
Beide SDKs verweigern diesen Fehler in beide Richtungen. Both SDKs refuse that mistake in both directions.