API-grenzen van de Drive-opslaguitbreiding

De Drive-opslaguitbreiding vergroot de gezamenlijke opslag voor TrekMail-accounts. Agents kunnen de status en prijzen van de uitbreiding lezen, maar ze kunnen de uitbreiding niet kopen, vergroten, verkleinen, annuleren of het abonnement op een andere manier wijzigen via API- of MCP-schrijfbewerkingen.

Deze pagina legt de grens uit, zodat automatisering nuttig kan zijn zonder dat factureringsbeslissingen veranderen in agentacties die op de achtergrond worden uitgevoerd.

Wat agents kunnen lezen

Met drive:addon:read kan een integratie het volgende lezen:

• De huidige status van de Drive-uitbreiding.
• De capaciteit en factureringsperiode wanneer een uitbreiding actief is.
• Prijsopties voor ondersteunde valuta.
• Voorbeeldinformatie over annulering, indien beschikbaar.
• Context over het opslaggebruik die helpt uitleggen of er mogelijk meer capaciteit nodig is.

Dit is voldoende voor rapportageagents, dashboards, opslagmonitors en ondersteuningsprocessen.

Wat agents niet kunnen wijzigen

De API en MCP-server bieden geen schrijfbewerkingen voor:

• Het kopen van een Drive-uitbreiding.
• Het vergroten of verkleinen van de uitbreiding.
• Het wijzigen van de factureringsperiode of betaalmethode.
• Het annuleren of opnieuw activeren van de uitbreiding.
• Het activeren van kaartafschrijvingen of abonnementswijzigingen.

Er is geen drive:addon:write-scope. De MCP-server heeft geen hulpmiddel voor kopen, aanpassen van de capaciteit of annuleren.

Waarom deze grens bestaat

Opslagwijzigingen kunnen gevolgen hebben voor facturen, valuta, capaciteitsplanning en gegevensbewaring. Een behulpzame agent kan opmerken dat het gebruik hoog is en de opties uitleggen, maar de laatste factureringsstap hoort in het dashboard plaats te vinden, waar een persoon de prijs ziet en de actie bevestigt.

Dit beperkt ook de schade als een agent verkeerd is geconfigureerd. Een token met een beperkte scope voor opslagbewaking kan melden dat je bijna aan je quotum zit zonder geld te kunnen uitgeven of capaciteit te kunnen annuleren.

Aanbevolen automatiseringspatroon

1. Verleen drive:addon:read en de relevante Drive-leesscope.
2. Laat de agent het gebruik en de status van de uitbreiding controleren.
3. Laat de agent een korte aanbeveling opstellen als de opslagruimte krap wordt.
4. Stuur de gebruiker naar de pagina van de Drive-uitbreiding in het dashboard voor elke aankoop, capaciteitswijziging of annulering.

Voorbeeld van een antwoord van een agent:

Je account gebruikt 91% van de gezamenlijke opslag. De huidige Drive-uitbreiding is actief. Overweeg op basis van de huidige groei om de grootte van de uitbreiding in het dashboard te bekijken vóór de volgende reeks uploads.

Respijt- en alleen-lezenstatussen

Als een uitbreiding wordt geannuleerd, kan er een respijtperiode zijn waarin bestanden leesbaar blijven, maar schrijfbewerkingen worden beperkt. Agents moeten dit behandelen als een status om te melden, niet als iets dat ze automatisch moeten oplossen. De gebruiker kan beslissen om de capaciteit te herstellen, bestanden te verwijderen of gegevens te exporteren.