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.
Nebeneffekt: Was eine Aktion mit Ihren Daten macht: lesen (schlägt etwas nach), schreiben (verändert etwas) oder zerstörerisch (löscht oder verändert unumkehrbar). der Nebeneffekt legt fest, wie die Aktion bestätigt wird.
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.
Fundierung (Retrieval): Antworten aus Ihrer eigenen Dokumentation und Ihren Inhalten statt aus dem allgemeinen Wissen des Modells. Der Assistent ruft passendes Material ab und zitiert es, sodass Antworten Ihr Produkt widerspiegeln.
Freigegebene Websites: Die Seiten und Domains, die der Agent beim Antworten LESEN darf — ausgehend und nur lesend. Ohne Eintrag liest er nichts außerhalb Ihres eigenen Katalogs, Ihrer Connectors und Ihrer indizierten Dokumentation. Nicht zu verwechseln mit den Widget-Origins, die die Gegenrichtung regeln: welche Ihrer Websites das Widget EINBETTEN dürfen. Jeder Eintrag wird von einer Administratorin oder einem Administrator freigegeben, ist auf GET beschränkt, wird bei jeder Anfrage und bei jedem Redirect erneut gegen Ihre Regeln geprüft und kann nie auf eine private oder interne Adresse zeigen.
Website-Erfassung: Syncanix lernt Ihr Produkt, indem es es liest. Ihre eigenen Seiten öffnen sich in Ihrem Browser, angemeldet als Sie, und Syncanix hält fest, was auf jeder steht — die Abschnitte, die Formulare, die Schaltflächen und die Wege dazwischen —, damit der Agent zu Ihrem Produkt antworten und Menschen hindurchführen kann. Nicht Ihre Sitemap, also die Adressliste, die Ihre Website für Suchmaschinen veröffentlicht: Bei der Erfassung geht es darum, was auf einer Seite steht, nicht welche Seiten es gibt. Auch nicht die Interaktionskarte, die zeigt, was Endnutzerinnen und Endnutzer getan haben, nachdem der Agent live war.
Site-Handbuch: Eine generierte, strukturierte Beschreibung Ihrer Website — ihrer Seiten, Bedienelemente und Abläufe — aus der Erkennung zusammengestellt, für Arbeitsbereiche ohne eigene Dokumentation. Der Agent stützt Fragen zur Website darauf und zitiert es wie jede andere Quelle, in der Sprache des Besuchers.
Aufgabenleitfäden: Ein benannter, veröffentlichter Ablauf, durch den der Agent Besucher auf Ihren eigenen Seiten führen kann — die Schritte selbst, einzeln am jeweiligen Bedienelement gezeigt, kein Artikel, der sie beschreibt. Syncanix schlägt Leitfäden aus dem vor, was die Erkennung beobachtet hat, und aus Abläufen, die Sie vorführen; keiner wird jemandem angeboten, bevor Sie ihn veröffentlichen.
Interaktion: Der eine Ort, an dem die Ansprache Ihres Assistenten konfiguriert wird: was er einem Besucher anbietet, bevor dieser etwas eingibt (Vorschläge), wann er von sich aus spricht (Anstöße) und wo er überhaupt erscheint (Seitenregeln). Keine Kennzahlenseite — jede Analyseoberfläche im Produkt misst Interaktion, und hier wird das Verhalten selbst festgelegt. Sie ersetzt drei getrennte Seiten, die jeweils einen Teil derselben Besuchererfahrung beschrieben.
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 das Widget einbinden, 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.
Nutzer-Lernen: Eine Opt-in-Fähigkeit, mit der der Assistent aus den Unterhaltungen jedes angemeldeten Endnutzers dauerhafte Vorlieben und Kontext lernt und eine kompakte, budgetbegrenzte Zusammenfassung in künftige Antworten einfließen lässt, um Antworten und verfügbare Aktionen zu personalisieren.
Agent-Wirkung: Die Analyseoberfläche, die den geschäftlichen Nutzen des Agenten misst — wie viele Anfragen von Endnutzern er ohne menschliche Hilfe gelöst hat (Deflection), die Ergebnisse dieser Unterhaltungen und einen geschätzten Return on Investment — nächtlich pro Workspace aggregiert mit ehrlicher Offenlegung der Stichprobenbildung.
Interaktion: Ein abgerechneter Zug — eine Frage und die Antwort des Assistenten samt aller Tool-, MCP- und Endpunkt-Aufrufe, die diese Antwort auslöst — oder ein einzelner eigenständiger Tool-Aufruf. Jeder hat einen festen Preis: 3 Nutzungs-Credits für die Antwort, 6, wenn zusätzlich eine Aktion ausgeführt wurde, 9, wenn zusätzlich etwas nachgeschlagen wurde, und 12, wenn beides zutrifft. Ein Gespräch besteht aus mehreren Interaktionen, nicht aus einer. Nicht zu verwechseln mit der Interaktionskarte, die Verläufe darstellt und nicht abrechnet.
Interaktionskarte: Eine visuelle Karte des Fähigkeitsgraphen des Agenten und der Wege, die Endnutzer darin nehmen — welche Bereiche, Routen und Fähigkeiten sie erreichen, wo sich die Nachfrage bündelt und wo Lücken bleiben —, dargestellt als interaktive Fläche mit einer barrierefreien Tabellenansicht. Sie trägt keine Preise: Die Einheit, die einen Preis trägt, ist die Interaktion.
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.
JSON-Web-Token (JWT): Ein kompaktes, signiertes Token, das belegt, wer ein angemeldeter Nutzer ist. Ihr Identitätsanbieter stellt es aus; Syncanix prüft seine Signatur, um der Identität zu vertrauen.
JWKS (JSON-Web-Key-Set): Die Menge öffentlicher Schlüssel, die Ihr Identitätsanbieter veröffentlicht, damit Dienste die Signaturen seiner Token prüfen können, ohne jemals ein Geheimnis zu teilen.
OpenID-Connect (OIDC): Das Standard-Anmeldeprotokoll, das die meisten Identitätsanbieter sprechen. Wenn Ihres es unterstützt, kann Syncanix Ihre Nutzer darüber verifizieren.
PKCE (Nachweisschlüssel für den Code-Austausch): Ein Sicherheitsschritt im OAuth-Anmeldefluss, der verhindert, dass ein abgefangener Autorisierungscode von jemand anderem verwendet werden kann. MCP-Clients melden sich auf diese Weise an.
Scope (Berechtigungsbereich): Eine benannte Berechtigung, die an ein Token gebunden ist — was der Inhaber tun darf. Die Aktionen des Assistenten sind durch die Scopes des Nutzers begrenzt, niemals darüber hinaus.
Token-Austausch: Ein Standardverfahren (RFC 8693), um ein Token gegen ein enger gefasstes einzutauschen, das an eine bestimmte Aufgabe gebunden ist — in Enterprise-Setups genutzt, damit jede nachgelagerte Aktion ihr eigenes, ausdrücklich ausgestelltes und begrenztes Token erhält.
Backend-for-Frontend (BFF): Ein kleiner Server, den Sie betreiben und der zwischen dem Widget und Syncanix sitzt, sodass Authentifizierungstoken niemals in den Browser gelangen. Die am stärksten abgeschottete Art, Ihre Nutzer zu authentifizieren.
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.
Zeilenbasierte Sicherheit: Eine Datenbankfunktion, die jede Abfrage automatisch auf die Zeilen eines einzelnen Arbeitsbereichs filtert — die letzte Rückfallebene von Syncanix, die die Daten der Kunden getrennt hält, selbst wenn eine Abfrage vergisst, sich zu begrenzen.
Signierte Absicht: Ein manipulationssicheres Einmal-Token, das eine genehmigte Aktion an einen bestimmten Nutzer, eine Fähigkeit und Eingaben bindet, sodass eine bestätigte Aktion nicht verändert oder wiederholt werden kann.
Auswertungs-Gate: Eine automatische Qualitätsprüfung, die läuft, bevor Sie in die Produktion übernehmen, und die Änderung blockiert, wenn die Antworten des Assistenten schlechter werden — sodass sich die Produktion nur zum Besseren verändert.
Drift-Erkennung: Zu bemerken, wenn sich Ihre API oder ihr Verhalten ändert, sodass der Katalog nicht mehr der Realität entspricht, und dies zu kennzeichnen, damit der Assistent niemals auf Basis eines veralteten Bildes handelt.
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): Die Nutzung Ihrer eigenen KI-Anbieterschlüssel, sodass die Modellnutzung Ihnen direkt von Ihrem Anbieter berechnet wird, statt auf Ihren Plan angerechnet zu werden.
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.
UC (Nutzungs-Credits): Die Einheit, in der Syncanix Interaktionen bepreist. Jede Interaktion kostet 6, 15, 18 oder 30 UC, bestimmt davon, was sie getan hat — antworten, handeln, etwas nachschlagen oder beides. Tarife bemessen sich nach enthaltenen Nutzungs-Credits, die Kosten richten sich also nach der Nutzung und nicht nach der Personalstärke.
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.