Limiti API dell’add-on di archiviazione Drive

L’add-on di archiviazione Drive amplia lo spazio di archiviazione condiviso per gli account TrekMail. Gli agenti possono leggere lo stato e i prezzi dell’add-on, ma non possono acquistarlo, aumentarne o ridurne la capacità, annullarlo o modificare in altro modo l’abbonamento tramite operazioni di scrittura API o MCP.

Questa pagina spiega tale limite, affinché l’automazione possa essere utile senza trasformare le decisioni di fatturazione in azioni eseguite in background dagli agenti.

Cosa possono leggere gli agenti

Con drive:addon:read, un’integrazione può leggere:

• Lo stato attuale dell’add-on Drive.
• La capacità e il periodo di fatturazione, quando un add-on è attivo.
• Le opzioni di prezzo per le valute supportate.
• Le informazioni di anteprima dell’annullamento, ove disponibili.
• Il contesto di utilizzo dello spazio di archiviazione che aiuta a spiegare se potrebbe servire più capacità.

È sufficiente per agenti di reportistica, dashboard, monitor dello spazio di archiviazione e flussi di assistenza.

Cosa non possono modificare gli agenti

L’API e il server MCP non espongono operazioni di scrittura per:

• Acquistare un add-on Drive.
• Aumentare o ridurre la capacità dell’add-on.
• Modificare il periodo di fatturazione o il metodo di pagamento.
• Annullare o riattivare l’add-on.
• Attivare addebiti sulla carta o modifiche all’abbonamento.

Non esiste un ambito drive:addon:write. Il server MCP non offre strumenti per l’acquisto, il ridimensionamento o l’annullamento.

Perché esiste questo limite

Le modifiche allo spazio di archiviazione possono influire su fatture, valuta, pianificazione della capacità e conservazione dei dati. Un agente utile può notare che l’utilizzo è elevato e spiegare le opzioni, ma il passaggio finale di fatturazione deve avvenire nella dashboard, dove una persona vede il prezzo e conferma l’azione.

Inoltre, questo limita i danni in caso di configurazione errata di un agente. Un token con ambito ristretto per il monitoraggio dello spazio può segnalare che «sei vicino alla quota» senza poter spendere denaro o annullare capacità.

Modello di automazione consigliato

1. Concedi drive:addon:read e l’ambito di lettura Drive pertinente.
2. Fai controllare all’agente l’utilizzo e lo stato dell’add-on.
3. Se lo spazio sta per esaurirsi, fai preparare all’agente una breve raccomandazione.
4. Indirizza l’utente alla pagina dell’add-on Drive nella dashboard per qualsiasi acquisto, modifica della capacità o annullamento.

Esempio di risposta dell’agente:

Il tuo account utilizza il 91% dello spazio di archiviazione condiviso. L’add-on Drive attuale è attivo. In base alla crescita attuale, valuta di controllare le dimensioni dell’add-on nella dashboard prima del prossimo gruppo di caricamenti.

Stati di tolleranza e sola lettura

Se un add-on viene annullato, può esserci un periodo di tolleranza durante il quale i file rimangono leggibili mentre le scritture sono limitate. Gli agenti devono considerarlo uno stato da segnalare, non qualcosa da correggere automaticamente. L’utente può decidere se ripristinare la capacità, eliminare file o esportare dati.