用途:引导用户完成 Google Cloud Data Agent Kit(DAK)插件的配置或重新配置。该技能通常由 SessionStart 钩子触发,而非用户主动调用。
主要能力与流程:按顺序执行以下步骤,任一步无法完成即停止并说明阻塞原因。
- 检查 gcloud 是否安装:gcloud --version;未安装则停止并指向 https://cloud.google.com/sdk/docs/install,不代为安装。
- 检查 ADC 凭据:gcloud auth application-default print-access-token > /dev/null 2>&1 && echo "ADC_OK" || echo "ADC_MISSING";缺失时运行 gcloud auth application-default login(无头环境用 --no-launch-browser),完成后重新检查。
- 获取 GCP 项目 ID,可先用 gcloud config get-value project 2>/dev/null 检测默认值;项目 ID 为 6–30 位小写字母、数字和连字符。
- 获取 GCP 区域,可先用 gcloud config get-value compute/region 2>/dev/null 检测;需区域(如 us-central1)而非可用区。
- 选择要启用的服务集成,至少一个,使用规范名称:BigQuery、Knowledge Catalog、AlloyDB、Cloud SQL、Spanner、Bigtable、Firestore、Cloud Storage、Apache Spark、Apache Airflow、Dataflow。
- 运行脚本:node "<skill directory>/scripts/dak-setup.js" save --project-id "<project id>" --region "<region>" --services "<service1>" "<service2>";save 紧随脚本路径,标志用两个 ASCII 连字符,值以空格分隔,--services 为可变参数且每个服务单独加引号,脚本路径也需加引号。脚本位于技能目录 scripts/dak-setup.js,需用完整路径。
- 提示用户重启代理,配置仅在插件加载(会话开始时)生效;重启前不要调用 DAK 工具。
适用场景:首次配置或重新配置 DAK 插件。重新配置时新配置会覆盖旧配置,未列出的服务会被移除而非合并。
限制:不代为安装 gcloud;不猜测项目 ID 或区域;脚本缺失时说明插件安装不完整,不要回退到 npx dak-setup(该包未发布)。