Glossar

Schlüsselbegriffe aus der Syncanix-Dokumentation.

Das übergreifende Vokabular, das in dieser Dokumentation durchgängig verwendet wird. Spätere Abschnitte definieren ihre eigenen Fachbegriffe dort, wo sie auftreten.

Fähigkeit: Eine einzelne Sache, die Ihre API kann – ein Endpunkt oder eine Aktion wie „eine Bestellung erstatten“ – so beschrieben, dass der Assistent weiß, was sie tut und wann er sie nutzen soll.
Fähigkeitskatalog: Die strukturierte Liste all Ihrer Fähigkeiten. Sie wird aus Ihrer API erkannt und ist die einzige Quelle der Wahrheit, aus der Widget, Chat und MCP-Server lesen.
Erkennung: Der Vorgang, Ihren Code zu durchsuchen, um den Fähigkeitskatalog aufzubauen, ausgeführt von der Syncanix-CLI.
Widget: Die einbettbare Chat-Komponente, die Sie mit einem einzigen Script-Tag in Ihre App einfügen.
Chat-Oberfläche: Das Assistenten-Erlebnis, mit dem Ihre Nutzer interagieren – Fragen beantworten und Aktionen über Ihre API ausführen.
MCP (Model Context Protocol): Ein offener Standard, der es KI-Clients wie Claude Desktop, Cursor und ChatGPT erlaubt, sich mit externen Werkzeugen und Daten zu verbinden.
MCP-Server: Der Endpunkt pro Arbeitsbereich, den Syncanix Ihnen bereitstellt, damit MCP-Clients Ihre Fähigkeiten erreichen.
Entwickler / Administrator: Ihr Team – die Personen, die die CLI ausführen, das Dashboard konfigurieren und den Arbeitsbereich verwalten.
Endnutzer: Der angemeldete Nutzer Ihres Kunden, der mit dem Widget chattet oder einen MCP-Client verbindet. Für jede Aktion wird seine eigene Identität verwendet, nicht eine gemeinsame.
Identitätsanbieter (IdP): Der Dienst, der Ihre Nutzer authentifiziert – zum Beispiel Auth0, Clerk, Cognito oder WorkOS. Syncanix nutzt ihn, statt selbst Anmeldedaten zu speichern.
Föderation: Die Anmeldung an Ihren Identitätsanbieter zu delegieren, sodass dieselbe Anmeldung und dieselben Berechtigungen, die Ihre Nutzer bereits haben, auch in Syncanix gelten.
Erhöhte Authentifizierung (Step-up): Einen Nutzer zu bitten, seine Identität erneut zu bestätigen – etwa per Mehr-Faktor-Authentifizierung – bevor eine sensible Aktion ausgeführt wird.
Im Auftrag handeln: Der Assistent führt eine Aktion als der Endnutzer aus, mit dessen Identität und Berechtigungen – nie mit erhöhtem oder gemeinsamem Zugriff.
Bestätigungsstufen: Wie Syncanix Aktionen nach Risiko absichert: Lesende Aktionen können automatisch laufen, schreibende fragen nach Bestätigung, und destruktive sind gesperrt, sofern Sie sie nicht erlauben.
Keine Datenspeicherung (ZDR): Eine Vereinbarung, bei der ein KI-Anbieter eine Anfrage verarbeitet, ohne sie zu speichern oder damit zu trainieren. Die CLI verlangt Ihre ausdrückliche Zustimmung vor jeder KI-Anreicherung.
BYOK (eigenen Schlüssel mitbringen): Eigene KI-Anbieterschlüssel zu verwenden, sodass die Modellnutzung Ihnen direkt berechnet wird, ohne Syncanix-Aufschlag.
BYOMCP (eigener MCP-Server): Anbindung von MCP-Servern, die Sie bereits betreiben, als zusätzliche Tool-Quellen. Deren Tools erscheinen neben Ihrem erkannten Katalog; Aufrufe werden an Ihren Server weitergeleitet — unter Wahrung der Tenant-Isolation und der Step-up-Authentifizierung.
Witness (Beobachtung): Eine Laufzeitbeobachtung der Form eines API-Aufrufs — Feldnamen und abgeleitete Typen, niemals Werte — erzeugt von der optionalen api-witness-Middleware. Witnesses halten den Katalog mit dem abgeglichen, was Ihre API tatsächlich liefert.
MAEU (monatlich aktive Endnutzer): Die Zahl der unterschiedlichen Endnutzer, die in einem Monat mit Ihrem Assistenten interagieren – das Hauptmaß, nach dem Tarife bemessen werden.
Umgebung: Eine isolierte Kopie Ihrer Konfiguration. Jeder Arbeitsbereich hat eine Entwicklungsumgebung zum Einrichten und eine Produktionsumgebung, die Ihre Nutzer erreichen.
Überführen: Ihre Konfiguration von der Entwicklung in die Produktion zu bringen, sodass sich das Live-Verhalten nur dann ändert, wenn Sie es beabsichtigen.
Veröffentlichbarer & geheimer Schlüssel: Ein veröffentlichbarer Schlüssel (pk_…) kann sicher für das Widget in Ihre Webseite eingebettet werden; ein geheimer Schlüssel (gak_…) wird serverseitig verwendet, etwa von der CLI. Geben Sie einen geheimen Schlüssel niemals im Client-Code preis.
Arbeitsbereich: Ein einzelner Syncanix-Mandant – Ihr Projekt mit Katalog, Konfiguration, Team und Abrechnung. Sie können mehreren angehören.