Revised:
1. Autorisierungsmodell
Der Server ist eine OAuth-2.1-Ressource: Authorization-Code-Flow mit obligatorischem PKCE (S256), dynamischer Client-Registrierung für Assistenten, Access- und Refresh-Tokens sowie einem Revocation-Endpunkt. Die Discovery-Dokumente werden unter den standardmäßigen Well-Known-Adressen desselben Hosts veröffentlicht.
2. Scopes und Rollen
Es gibt vier Lese-Scopes: catalog.read, inventory.read, orders.read und account.read, sowie zwei Schreib-Scopes: catalog.write und inventory.write. Schreib-Scopes erhalten nur Inhaber und Administratoren. Ein Tool ist für einen Assistenten nur sichtbar, wenn der gewährte Scope und Ihre Rolle es erlauben, sodass ein Lagermitarbeiter nie Daten sieht, die nur ein Inhaber sehen darf.
3. Mandantenisolierung
Jeder Aufruf wird als der angemeldete Benutzer innerhalb von genau einem Unternehmen ausgeführt. Es wird derselbe Code für Berechtigungen, Validierung und Isolierung wie in der Webanwendung verwendet; es gibt keinen separaten Datenpfad für Assistenten.
4. Änderungen nur mit Vorschau und Bestätigung
Schreib-Tools liefern zuerst eine Vorschau der alten und neuen Werte und speichern erst, wenn sie erneut mit confirm=true und der aktuellen Produktversion aufgerufen werden, sodass ein veralteter oder versehentlicher Aufruf keine neueren Daten überschreiben kann. Ein Aufruf ändert ein Produkt, nichts kann gelöscht werden, und WareRushAI kann alle Änderungen durch Assistenten jederzeit plattformweit abschalten.
5. Audit und Widerruf
Jeder Tool-Aufruf wird mit Tool-Name, Ergebnis und Dauer protokolliert. Sie können einen Assistenten jederzeit widerrufen; widerrufene Tokens verlieren sofort ihre Gültigkeit.
6. Datensparsamkeit
Tools geben kurze Zusammenfassungen und nur die Felder zurück, die ein Assistent benötigt; Details werden auf Anfrage abgerufen. Soweit Daten vom Anbieter des Assistenten verarbeitet werden, gelten die Geschäftsbedingungen und Datenschutzrichtlinien dieses Anbieters.
