Drive 스토리지 애드온 API 경계

Drive 스토리지 애드온은 TrekMail 계정의 통합 스토리지를 확장합니다. 에이전트는 애드온 상태와 가격을 읽을 수 있지만 API 또는 MCP 쓰기 작업을 통해 구매, 용량 변경, 취소 또는 그 밖의 구독 변경을 수행할 수 없습니다.

이 페이지에서는 결제 결정이 백그라운드 에이전트 작업으로 바뀌지 않으면서 자동화를 유용하게 활용할 수 있도록 이 경계를 설명합니다.

에이전트가 읽을 수 있는 정보

drive:addon:read 권한이 있는 통합은 다음 정보를 읽을 수 있습니다.

• 현재 Drive 애드온 상태.
• 애드온이 활성 상태일 때의 용량과 결제 주기.
• 지원되는 통화의 가격 옵션.
• 제공되는 경우 취소 미리 보기 정보.
• 추가 용량이 필요할 수 있는지 설명하는 데 도움이 되는 스토리지 사용 현황.

이 정보는 보고 에이전트, 대시보드, 스토리지 모니터 및 지원 워크플로에 충분합니다.

에이전트가 변경할 수 없는 항목

API와 MCP 서버는 다음 작업을 위한 쓰기 작업을 제공하지 않습니다.

• Drive 애드온 구매.
• 애드온 용량 확대 또는 축소.
• 결제 주기 또는 결제 수단 변경.
• 애드온 취소 또는 재활성화.
• 카드 청구 또는 구독 변경 실행.

drive:addon:write 범위는 없습니다. MCP 서버에는 구매, 용량 변경 또는 취소 도구가 없습니다.

이 경계가 존재하는 이유

스토리지 변경은 청구서, 통화, 용량 계획 및 데이터 보존에 영향을 줄 수 있습니다. 유용한 에이전트는 사용량이 많다는 사실을 파악하고 선택지를 설명할 수 있지만, 최종 결제 단계는 사람이 가격을 확인하고 작업을 승인하는 대시보드에서 진행해야 합니다.

이 경계는 에이전트가 잘못 구성된 경우의 피해도 제한합니다. 범위가 제한된 스토리지 모니터 토큰은 비용을 지출하거나 용량을 취소할 수 없는 상태에서 할당량이 거의 소진되었다고 보고할 수 있습니다.

권장 자동화 패턴

1. drive:addon:read 및 관련 Drive 읽기 범위를 부여합니다.
2. 에이전트가 사용량과 애드온 상태를 확인하도록 합니다.
3. 스토리지가 부족하면 에이전트가 짧은 권장 사항을 준비하도록 합니다.
4. 구매, 용량 변경 또는 취소 작업은 대시보드의 Drive 애드온 페이지에서 진행하도록 사용자를 안내합니다.

에이전트 응답 예시:

계정에서 통합 스토리지의 91%를 사용하고 있습니다. 현재 Drive 애드온은 활성 상태입니다. 현재 증가 추세를 고려하여 다음 업로드 작업 전에 대시보드에서 애드온 용량을 검토해 보세요.

유예 및 읽기 전용 상태

애드온이 취소되면 쓰기가 제한되는 동안 파일은 계속 읽을 수 있는 유예 기간이 제공될 수 있습니다. 에이전트는 이를 자동으로 해결할 문제가 아니라 보고할 상태로 취급해야 합니다. 용량을 복원할지, 파일을 삭제할지, 데이터를 내보낼지는 사용자가 결정할 수 있습니다.