Agent Skills
返回列表
腾讯云 API 运维助手

腾讯云 API 运维助手

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md 将 @tencent-adm/tcapi 安装到你的 AI 助手中。

技能介绍

解决的问题

tccli 让腾讯云 API 调用从手动拼 SDK、查分散文档，收敛为统一 CLI 工作流。技能聚焦常见卡点：环境缺 CLI、地域参数不一致、复杂参数 JSON 格式错误、凭证未登录或误操作打印密钥，以及并行调用导致配置竞争。

技能如何工作

  • 统一入口：优先用 tccli 调用腾讯云 API，未安装时按参考文档补齐环境。
  • 调用约束：多数产品需传 --region，如 ap-guangzhou；cam、account、dnspod 等全局接口可省略。非简单类型参数必须使用标准 JSON，例如 --Placement '{"Zone":"ap-guangzhou-2"}'。
  • 凭证处理：凭证可用时直接调用；出现 secretId is invalid 时通过 tccli auth login 做浏览器授权，等待 OAuth 回调后再继续。
  • 接口发现：先用 curl + grep 检索服务名、最佳实践、Action、参数说明与数据结构；若最佳实践未覆盖，再在接口列表中定位具体 API。
  • 安全边界：不向用户索要 SecretId / SecretKey，不执行可能打印凭证的命令，避免把密钥暴露到日志或对话中。

适用边界与注意点

该技能适合 IT 运维、安全排查、资源巡检、创建类接口和跨产品 API 检索。当前不建议并行调用多个接口，因为 tccli 并行时可能存在配置文件竞争，导致响应失败；多用户凭证、授权原理需要参考对应文档逐步确认。

使用场景

  • 排查 CVM/CBS 资源异常时，用 tccli 按地域调用对应 API 获取实例与磁盘状态。
  • 创建资源前，按技能规则构造标准 JSON 参数，如 Placement，避免参数格式导致接口失败。
  • 出现 secretId is invalid 时，通过 tccli auth login 完成浏览器 OAuth 后继续调用接口。
  • 定位陌生业务接口时，用 curl+grep 检索服务名、最佳实践、Action 与数据结构。

适合人员

  • 负责腾讯云资源巡检的运维工程师，需要按地域稳定调用 CVM/CBS 等接口排查状态。
  • 处理创建类 API 的后端工程师，需要把复杂参数写成标准 JSON 避免接口报错。
  • 遇到 secretId is invalid 的平台工程师，需要走浏览器 OAuth 后继续执行调用。
  • 需要安全使用凭证的 IT 安全工程师，避免索要或打印 SecretId/SecretKey。