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

cloud-api-operations

部署与运维

查看项目

更新于 10-16 09:40

技能介绍

用途

Cloud API Operations 用于操作腾讯云中 CloudBase 依赖、但没有专用 MCP 工具覆盖的资源，例如监控与告警、CLB、CAM 角色以及跨产品基础设施。它有两个目标：在不靠猜测的情况下找到正确的 API，以及复用已有验证过的流程而不是重新探索。

何时使用

  • 用户要求管理或操作超出 CloudBase 专用 MCP 工具范围的腾讯云资源（例如配置告警策略、检查 CLB、附加 CAM 策略）。
  • 用户希望从代码中控制这些资源，并询问应使用哪个 API/SDK。
  • callCloudApi 调用失败，需要判断错误类型（Action 错误 / 参数错误 / 缺少 CAM 权限）并恢复。

工作流

  1. 发现 API——从有文档的来源解析名称。先阅读 API 索引：https://docs.cloudbase.net/ai/cloudbase-ai-toolkit/api-reference.md，该索引每日自动同步，覆盖 action 级信息（TCB 105 以及依赖产品 MySQL / SCF / COS），也可在其中查看速率限制。索引检查只需快速 grep，可与步骤 2/3 的抓取并行执行，不要串行。如果索引未覆盖目标产品，则前往该产品的官方 API 文档（例如 monitor：https://cloud.tencent.com/document/product/649/30343），确认确切的 Action 名称、Version 和参数。若要机器可读的参数 schema，直接抓取官方 SDK models 源码，参见 ./references/calling-methods.md §2 第 4 项。

    完成标准：Action 名称、Version 和完整参数结构都可追溯到索引、官方产品文档或 SDK models 源码，不能凭记忆。若调用仍返回 action ... is invalid or not found，说明名称未按此方式解析，需依据 ./references/calling-methods.md §1 的错误表分类并恢复。

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

  2. 选择调用路径。

    • 本会话内的交互式操作：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。

  3. 首次调用前检查凭证。通过 auth 工具读取当前凭证范围：credential_scope: account = 账户级，可触达控制面 API，但受该身份 CAM 策略约束；env = API Key，范围限于某个环境的数据面加上固定的 TCB 策略。权限来源因凭证身份而异：账户级身份自身的策略、API Key 模型（没有携带任意 CAM 策略的通道），或 CLI / MCP 所代入的 TCB 服务角色。该角色家族已覆盖哪些跨产品能力并非固定，应读取已附加的策略（ListAttachedRolePolicies + GetPolicy）而不是假设，并把 UnauthorizedOperation 视为「该身份缺少此 action」，绝不视为配置损坏。遇到 UnauthorizedOperation / AuthFailure 时，给用户提供一个一键 CAM 授权链接（角色名 + 策略名 + 主体），而不是让其去控制台自行寻找策略，然后重试原调用。角色目标、主体取值以及哪个预设策略覆盖什么，参见 ./references/calling-methods.md §3。完成标准：已知凭证身份，且在任何重试前，每个权限错误都已转化为携带具体策略名的可点击授权链接。

  4. 存在已验证 recipe 时，按 recipe 执行。recipes 编码了确切的调用顺序、必需参数和实际发现的坑点，使流程一次即可跑通。每个文件对应一个场景——从索引 ./references/recipes/README.md 开始，其状态列记录了每个 recipe 的验证程度：

    • PostgreSQL 存储用量告警：./references/recipes/pg-storage-alarm.md
    • ICP 备案就绪与等待时间检查：./references/recipes/icp-filing-readiness.md
    • PostgreSQL 实例规格变更与共享转独享升级：./references/recipes/pg-instance-spec.md
    • 环境的自定义域名接入（HTTP 访问域名、证书、DNS 绑定）：./references/recipes/custom-domain.md

    完成标准：调用序列中的每个参数值都可追溯到标记为实测的 recipe 值或官方文档。

同级技能

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

限制

  • Region 是顶层 region 参数（X-TC-Region），绝不是 body 参数。某些 API 还会在 Dimensions 中接受短 region 代码（例如 sh 与 ap-shanghai），这些是不同字段。
  • SDK 语言相关细节应交给官方 SDK 文档或 sdkHints；本技能不绑定 SDK 语言。
  • 本技能只收录公开 API 覆盖的场景；索引中查不到的能力不在公开契约内。

（价格、收费等其他事实资料中暂未提供。）