Limites da API do complemento de armazenamento do Drive

O complemento de armazenamento do Drive expande o armazenamento partilhado das contas TrekMail. Os agentes podem consultar o estado e os preços do complemento, mas não podem comprá-lo, alterar a sua capacidade, cancelá-lo ou modificar de outra forma a subscrição através de operações de escrita da API ou do MCP.

Esta página explica esse limite para que a automatização seja útil sem transformar decisões de faturação em ações de agentes executadas em segundo plano.

O que os agentes podem consultar

Com drive:addon:read, uma integração pode consultar:

• O estado atual do complemento do Drive.
• A capacidade e o período de faturação, quando um complemento está ativo.
• As opções de preço para as moedas suportadas.
• As informações de pré-visualização do cancelamento, quando disponíveis.
• O contexto de utilização do armazenamento que ajuda a explicar se poderá ser necessária mais capacidade.

Isto é suficiente para agentes de relatórios, painéis, monitores de armazenamento e fluxos de suporte.

O que os agentes não podem alterar

A API e o servidor MCP não disponibilizam operações de escrita para:

• Comprar um complemento do Drive.
• Aumentar ou reduzir a capacidade do complemento.
• Alterar o período de faturação ou o método de pagamento.
• Cancelar ou reativar o complemento.
• Acionar débitos no cartão ou alterações à subscrição.

Não existe o âmbito drive:addon:write. O servidor MCP não dispõe de ferramentas para comprar, alterar a capacidade ou cancelar.

Porque existe este limite

As alterações de armazenamento podem afetar faturas, moeda, planeamento de capacidade e retenção de dados. Um agente útil pode detetar que a utilização está elevada e explicar as opções, mas o passo final de faturação deve ocorrer no painel, onde uma pessoa vê o preço e confirma a ação.

Isto também limita os danos caso um agente esteja mal configurado. Um token restrito para monitorização do armazenamento pode avisar que «está perto do limite» sem poder gastar dinheiro ou cancelar capacidade.

Padrão de automatização recomendado

1. Conceda drive:addon:read e o âmbito de leitura do Drive relevante.
2. Peça ao agente que verifique a utilização e o estado do complemento.
3. Se o armazenamento estiver a ficar cheio, peça ao agente que prepare uma recomendação curta.
4. Encaminhe o utilizador para a página do complemento do Drive no painel para qualquer compra, alteração de capacidade ou cancelamento.

Exemplo de resposta do agente:

A sua conta está a utilizar 91% do armazenamento partilhado. O complemento do Drive atual está ativo. Com base no crescimento atual, considere rever a capacidade do complemento no painel antes do próximo lote de carregamentos.

Estados de tolerância e só de leitura

Se um complemento for cancelado, poderá existir um período de tolerância durante o qual os ficheiros permanecem legíveis, mas as escritas ficam restringidas. Os agentes devem tratar esta situação como um estado a comunicar, não como algo a corrigir automaticamente. O utilizador pode decidir se pretende restaurar a capacidade, eliminar ficheiros ou exportar dados.