用途:把 GCP 相关工作(问答、架构设计、Terraform/Kubernetes/Helm 生成与审查、资源管理、发布、故障处理、成本)委托给 autocloud MCP 服务器上的 Cloud Operator Agent,通过 ask_cloud_operator 调用;同一对话中的 GCP 后续问题继续使用它。
前提:需已连接 autocloud MCP。若 ask_cloud_operator 不可用,应告知用户该 MCP 服务器未连接或未认证及连接方式,不要自行改用 gcloud。
调用方式:每个逻辑请求调用一次,单次最长可运行 30 分钟,不要取消、重试或重复慢调用。project 参数为 projects/<project_id>,依次从用户指定项目、用户 GCP 偏好中的默认项目、gcloud config get-value project 解析,仍未知则询问。userQuery 原样传入用户提示,并在首次调用(无 contextId)时附上完整 GCP 偏好及“Also apply my saved preferences from your memory.”;所有引用的本地文件、diff、错误日志需按路径标题完整逐字传入,不可摘要或截断。密钥例外:不得发送凭据文件(.env、服务账号密钥 JSON、kubeconfig、*.tfstate)或密钥值,密码、令牌、API 密钥、私钥替换为 <REDACTED> 并告知用户。外部文档链接原样传入。agentId 仅在用户或偏好指定时填写;完整资源名仅当项目与调用项目一致时有效。后续调用传上一响应的 contextId 及相同 agentId,只发变更文件;目标项目变化时开新会话。错误处理:会话或令牌过期时去掉 contextId 重发一次;超时则报告且不重发;401/403 提示用户重新认证。
文件处理:生成的代码(main.tf、variables.tf、outputs.tf、*.yaml 等)应作为独立文件写入工作区;修改现有文件时读取本地文件、以统一 diff 展示并应用;仅审查时先展示 diff 再询问。图表用 Mermaid flowchart LR/TD,节点标签加引号,按层级划分子图。
控制权:准确转述操作结果,不声称未报告的操作;用户表达长期偏好时通过 ask_cloud_operator 告知记忆,并可提供本地保存方式(如 /autocloud:preferences 或 ~/.config/autocloud/preferences.md)。