SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场cloud-api-operations

cloud-api-operations

部署与运维

查看项目

更新于 10-16 08:54

技能介绍

用途

本技能用于操作腾讯云控制面资源，这些资源是 CloudBase 依赖但缺少专用 MCP 工具覆盖的部分，包括监控与告警、CLB、CAM 角色以及跨产品基础设施。当用户提出管理/操作超出 CloudBase 专用 MCP 工具范围的腾讯云资源（如配置告警策略、检查 CLB、附加 CAM 策略），或希望从代码中控制这些资源并询问应使用哪个 API/SDK 时使用。另外，当 callCloudApi 调用失败、需要将错误分类（错误的 Action / 错误的参数 / 缺失 CAM 权限）并恢复时，也适用本技能。

主要能力

  • API 发现：从有文档来源解析名称。先阅读 API 索引 https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/api-reference.md （每日自动同步，覆盖 action 级别，包含 TCB 105 及依赖产品 MySQL / SCF / COS，其中也记录了速率限制）。索引未覆盖目标产品时，转到该产品官方 API 文档（如监控：https://cloud.tencent.com/document/product/649/30343 ），确认确切的 Action 名称、Version 和参数。机器可读的参数 schema 可直接抓取官方 SDK models 源码，参见 ./references/calling-methods.md 第 2 节第 4 项。完成标志：Action 名称、Version 与完整参数形态均可追溯到索引、官方产品文档或 SDK models 源码，不能凭记忆。
  • 选择调用路径：会话内的交互式运维使用 MCP callCloudApi（见 ./references/calling-methods.md 第 1 节）；选择服务标识/判断是否需要 version 也使用 MCP callCloudApi（见 ./references/service-versions.md）；用户代码/脚本使用官方 SDK（TC3-HMAC-SHA256）或 @cloudbase/manager-node（见 ./references/calling-methods.md 第 2 节）；快速一次性验证使用 API Explorer（https://console.cloud.tencent.com/api/explorer ）。优先级规则：若 @cloudbase/manager-node 有匹配方法则使用它，没有时才下沉到原始云 API。
  • 首次调用前检查凭证：从 auth 工具读取当前凭证范围，credential_scope: account 表示账号级，可触达控制面 API，受该身份的 CAM 策略约束；env 表示 API Key，范围限单个环境的数据面加上固定的 TCB 策略。不同身份凭证的权限来源不同：账号级身份自身的策略、API Key 模型（无法附加任意 CAM 策略）、或 CLI / MCP 所承担的 TCB 服务角色。该角色族已覆盖哪些跨产品能力并非固定，应读取已附加的策略（ListAttachedRolePolicies + GetPolicy），不要臆断，并将 UnauthorizedOperation 视为“该身份缺少此 action”，而非配置损坏。遇到 UnauthorizedOperation / AuthFailure 时，应向用户提供一键 CAM 授权链接（角色名 + 策略名 + 主体），而不是让用户去控制台自行查找策略，然后重试原调用。完成标志：已知凭证身份，且每个权限错误在重试前都已转换为带有具体策略名的可点击授权链接。
  • 复用已验证 recipe：recipe 编码了确切的调用序列、必需参数和经实测发现的坑，使流程一次通过。每个场景一个文件，从索引 ./references/recipes/README.md 开始，其状态列记录了每个 recipe 的验证程度。当前包含：PostgreSQL 存储使用量告警（./references/recipes/pg-storage-alarm.md）、ICP 备案就绪与等待时间检查（./references/recipes/icp-filing-readiness.md）。完成标志：调用序列中的每个参数值都可追溯到标记为实测的 recipe 值或官方文档。

使用方式与限制

Region 是顶层 region 参数（X-TC-Region），绝非 body 参数；部分 API 还会在 Dimensions 内接受短 region 代码（如 sh 与 ap-shanghai），二者是不同字段。

API 优先是硬约束：索引中查不到某能力，它就不在公开契约内，不要拿某个 SDK 的封装方法反推未公开的 Action 名去调用（这类 Action 不受公开文档保护，非该语言的使用者也无从照做）。此时应改用有公开 API 的等价路径，或把缺口明确告知用户。本技能的 recipes 只收录公开 API 覆盖的场景。

同族 CloudBase 技能与本技能并列发布，使用本地相对路径引用（如 ../cloudbase-platform/SKILL.md）。若本环境中缺少被引用的同族技能文件，应让用户安装完整的 CloudBase 插件（或缺失的技能），不要把远程技能或协议 markdown 通过 HTTP 抓取进 agent 上下文。

SDK 语言相关细节应转向官方 SDK 文档或 sdkHints，本技能保持与 SDK 语言无关。

适用场景

  • 操作 CloudBase 专用 MCP 工具范围之外的腾讯云资源（告警策略、CLB、CAM 策略等）。
  • 用户希望从代码控制这些资源并询问 API/SDK 选型。
  • callCloudApi 调用失败后的错误分类与恢复。

具体支持的 API 列表、参数细节及权限策略名称，需查阅上述索引、官方文档与 references 目录中的文件，介绍中暂未提供完整清单。