cloud-storage-get-bucket-metadata

A “cloud-storage-get-bucket-metadata” tool returns metadata for a Cloud Storage bucket.

About

A cloud-storage-get-bucket-metadata tool returns metadata for a single Cloud Storage bucket. Use it when the LLM needs fields such as location, storage class, labels, lifecycle configuration, or uniform bucket-level access status.

The response is the bucket metadata structure returned by the Cloud Storage API.

You can set bucket in the tool configuration. When set, bucket is removed from the runtime parameter schema and the configured bucket is always used. A configured bucket must be a non-empty string.

Compatible Sources

This tool can be used with the following database sources:

Source Name
Cloud Storage Source

Requirements

The Cloud Storage credentials must be able to read metadata for the target bucket.

Parameters

parametertyperequireddescription
bucketstringtrueName of the Cloud Storage bucket to inspect.

Example

kind: tool
name: get_bucket_metadata
type: cloud-storage-get-bucket-metadata
source: my-gcs-source
description: Use this tool to inspect metadata for a Cloud Storage bucket.
kind: tool
name: get_app_bucket_metadata
type: cloud-storage-get-bucket-metadata
source: my-gcs-source
description: Use this tool to inspect metadata for the application bucket.
bucket: my-app-bucket

Output Format

The tool returns bucket metadata from the Cloud Storage API, including fields such as Name, Location, StorageClass, Created, Labels, VersioningEnabled, Lifecycle, and UniformBucketLevelAccess.

Reference

fieldtyperequireddescription
typestringtrueMust be “cloud-storage-get-bucket-metadata”.
sourcestringtrueName of the Cloud Storage source to get bucket metadata from.
descriptionstringtrueDescription of the tool that is passed to the LLM.
bucketstringfalseBucket to always inspect. When set, the runtime bucket parameter is hidden. Must not be empty.