Revised:
1. Modelo de autorización
El servidor es un recurso OAuth 2.1: flujo de código de autorización con PKCE obligatorio (S256), registro dinámico de clientes para asistentes, tokens de acceso y actualización, y un endpoint de revocación. Los documentos de detección se publican en las direcciones estándar well-known del mismo host.
2. Ámbitos y roles
Existen cuatro ámbitos de lectura: catalog.read, inventory.read, orders.read y account.read, y dos de escritura: catalog.write e inventory.write. Los ámbitos de escritura solo se conceden a propietarios y administradores. Una herramienta solo es visible para un asistente si el ámbito concedido y tu rol lo permiten, así que un usuario de almacén nunca ve datos que solo ve un propietario.
3. Aislamiento de inquilinos
Cada llamada se ejecuta como el usuario autenticado dentro de una sola empresa. Se utiliza el mismo código de permisos, validación y aislamiento que en la aplicación web; no existe una vía de datos independiente para los asistentes.
4. Cambios solo con vista previa y confirmación
Las herramientas de escritura devuelven primero una vista previa de los valores antiguos y nuevos y solo guardan cuando se vuelven a llamar con confirm=true y la versión actual del producto, de modo que una llamada obsoleta o accidental no puede sobrescribir datos más recientes. Una llamada cambia un producto, no se puede eliminar nada y WareRushAI puede desactivar en cualquier momento todos los cambios de asistentes en toda la plataforma.
5. Auditoría y revocación
Cada llamada a una herramienta se registra con el nombre de la herramienta, el resultado y la duración. Puedes revocar el acceso a un asistente en cualquier momento, y los tokens revocados dejan de funcionar inmediatamente.
6. Minimización de datos
Las herramientas devuelven resúmenes breves y únicamente los campos que el asistente necesita; los detalles se obtienen bajo petición. Cuando los datos son procesados por el proveedor del asistente, se aplican los términos y la política de privacidad de dicho proveedor.
