Revised:
1. Modelo de autorização
O servidor é um recurso OAuth 2.1: fluxo de código de autorização com PKCE obrigatório (S256), registo dinâmico de clientes para assistentes, tokens de acesso e de atualização, e um endpoint de revogação. Os documentos de deteção estão publicados nos endereços padrão well-known do mesmo anfitrião.
2. Âmbitos e funções
Existem quatro âmbitos de leitura: catalog.read, inventory.read, orders.read e account.read, e dois de escrita: catalog.write e inventory.write. Os âmbitos de escrita só são concedidos a proprietários e administradores. Uma ferramenta só fica visível para um assistente se o âmbito concedido e a sua função o permitirem, pelo que um utilizador de armazém nunca vê dados que só o proprietário vê.
3. Isolamento de inquilinos (tenants)
Cada chamada é executada com a identidade do utilizador autenticado dentro de exatamente uma empresa. É utilizado o mesmo código de permissões, validação e isolamento da aplicação web; não existe um fluxo de dados separado para assistentes.
4. Alterações só com pré-visualização e confirmação
As ferramentas de escrita devolvem primeiro uma pré-visualização dos valores antigos e novos e só guardam quando chamadas novamente com confirm=true e a versão atual do produto, pelo que uma chamada desatualizada ou acidental não pode substituir dados mais recentes. Uma chamada altera um produto, nada pode ser eliminado e o WareRushAI pode desligar a qualquer momento todas as alterações por assistentes em toda a plataforma.
5. Auditoria e revogação
Cada chamada de ferramenta é registada com o nome da ferramenta, o resultado e a duração. Pode revogar o acesso de um assistente a qualquer momento, e os tokens revogados deixam de funcionar de imediato.
6. Minimização de dados
As ferramentas devolvem resumos curtos e apenas os campos necessários ao assistente; os detalhes são obtidos a pedido. Quando os dados são processados pelo fornecedor do assistente, aplicam-se os termos e a política de privacidade desse mesmo fornecedor.
