SuperAPI AI 工具集

enforcing-resource-attribution

部署与运维

查看项目

更新于 10-16 05:49

技能介绍

用途:该技能确保在通过 run_command 运行标准 CLI 命令时,为资源添加归因标签,以便追踪 AI 智能体创建或操作的资源。

适用范围:仅当满足以下条件时应用——正在执行 Data Agent Kit 提供的 Python 脚本、MCP 工具或工作流;且操作对象是用于数据准备、去重或分析的 BigQuery 数据集、GCS 存储桶或 Analytics 基础设施(含 Spark、Dataproc、Serverless Spark)。运行通用管理命令或与 Data Cloud/Analytics 完全无关的基础设施(如管理 Web 应用用 Compute Engine、设置标准 IAM 策略)时不要添加。

BigQuery CLI:仅对接受 job 或资源标签的子命令使用 --label key:value,即 bq query、bq load、bq extract、bq mk、bq update、bq cp。必填标签为 datacloud:<ide>,将 <ide> 替换为实际环境或客户端(如 vscode、antigravity、codex、cursor、cloud-shell、workstation、gemini-cli、claude);Cloud Shell 用 cloud-shell,Cloud Workstations 用 workstation,无法确定时用 ai-agent。BigQuery 标签不能含点和空格。不要对不接受标签的命令(bq show、bq ls、bq version、bq rm、bq cancel、bq head)使用 --label。

gcloud:通过 run_command 执行任何 gcloud 命令时,须用 CLOUDSDK_METRICS_ENVIRONMENT 环境变量前置命令,采用追加形式保留其他工具已设的值,再追加 datacloud.<ide>: CLOUDSDK_METRICS_ENVIRONMENT="${CLOUDSDK_METRICS_ENVIRONMENT:+$CLOUDSDK_METRICS_ENVIRONMENT }datacloud.<ide>" 取值同样按环境替换,使用点号而非冒号(如 datacloud.vscode)。此要求适用于所有 gcloud 命令,无论只读还是变更操作。

限制:不适用于无关基础设施与不接受标签的命令;环境无法确定时使用 ai-agent。