API-Grenzen des Drive-Speicher-Add-ons

Das Drive-Speicher-Add-on erweitert den gemeinsam genutzten Speicher für TrekMail-Konten. Agenten können Status und Preise des Add-ons lesen. Sie können es jedoch nicht über schreibende API- oder MCP-Vorgänge kaufen, vergrößern, verkleinern, kündigen oder das Abonnement anderweitig ändern.

Diese Seite erläutert diese Grenze, damit Automatisierung hilfreich sein kann, ohne Abrechnungsentscheidungen zu im Hintergrund ausgeführten Agentenaktionen zu machen.

Was Agenten lesen können

Mit drive:addon:read kann eine Integration Folgendes lesen:

• Den aktuellen Status des Drive-Add-ons.
• Kapazität und Abrechnungszeitraum, wenn ein Add-on aktiv ist.
• Preisoptionen für unterstützte Währungen.
• Informationen zur Kündigungsvorschau, sofern verfügbar.
• Den Kontext der Speichernutzung, mit dem sich ein möglicher Bedarf an zusätzlicher Kapazität erklären lässt.

Das reicht für Berichtsagenten, Dashboards, Speicherüberwachungen und Supportabläufe aus.

Was Agenten nicht ändern können

Die API und der MCP-Server stellen keine Schreibvorgänge für Folgendes bereit:

• Den Kauf eines Drive-Add-ons.
• Das Vergrößern oder Verkleinern des Add-ons.
• Das Ändern des Abrechnungszeitraums oder der Zahlungsmethode.
• Das Kündigen oder Reaktivieren des Add-ons.
• Das Auslösen von Kartenbelastungen oder Abonnementänderungen.

Es gibt keinen Berechtigungsumfang drive:addon:write. Der MCP-Server hat kein Werkzeug zum Kaufen, Ändern der Kapazität oder Kündigen.

Warum diese Grenze besteht

Speicheränderungen können sich auf Rechnungen, Währung, Kapazitätsplanung und Datenaufbewahrung auswirken. Ein hilfreicher Agent kann eine hohe Nutzung erkennen und die Optionen erläutern. Der abschließende Abrechnungsschritt sollte jedoch im Dashboard erfolgen, wo ein Mensch den Preis sieht und die Aktion bestätigt.

Das begrenzt außerdem mögliche Schäden, wenn ein Agent falsch konfiguriert ist. Ein eng begrenztes Token zur Speicherüberwachung kann melden, dass das Kontingent fast erreicht ist, ohne Geld ausgeben oder Kapazität kündigen zu können.

Empfohlenes Automatisierungsmuster

1. Gewähren Sie drive:addon:read und den entsprechenden Drive-Leseumfang.
2. Lassen Sie den Agenten Nutzung und Add-on-Status prüfen.
3. Lassen Sie den Agenten eine kurze Empfehlung erstellen, wenn der Speicher knapp wird.
4. Leiten Sie den Benutzer für jeden Kauf, jede Kapazitätsänderung oder Kündigung zur Seite des Drive-Add-ons im Dashboard weiter.

Beispielantwort eines Agenten:

Ihr Konto nutzt 91% des gemeinsam genutzten Speichers. Das aktuelle Drive-Add-on ist aktiv. Angesichts des derzeitigen Wachstums sollten Sie die Größe des Add-ons vor dem nächsten Upload-Paket im Dashboard prüfen.

Kulanz- und Schreibschutzzustände

Nach der Kündigung eines Add-ons kann es ein Kulanzfenster geben, in dem Dateien weiterhin gelesen werden können, während Schreibvorgänge eingeschränkt sind. Agenten sollten dies als zu meldenden Zustand behandeln und nicht als etwas, das automatisch behoben werden muss. Der Benutzer kann entscheiden, ob er die Kapazität wiederherstellt, Dateien löscht oder Daten exportiert.