前言¶
在腾讯云上做运维或排障时，指标往往分散在云产品监控、APM、RUM、告警、Dashboard 等多个控制台与 OpenAPI 里。你要先确认产品命名空间、指标英文名、维度字段，再对照文档拼请求参数，最后自己整理曲线或表格。对熟悉某一两条链路的人尚可接受，跨 APM、压测、Grafana、EventBridge 等场景时，成本会明显上升。
下面介绍 SkillHub 上的 腾讯云可观测平台（tcop-api）（坐标 @tencent-adm/tcop）。它把可观测相关能力封装成 Agent Skill，让对话侧用自然语言描述查询意图，由 Skill 引导完成产品路由、指标匹配、维度组装与 API 调用，并给出结果摘要。
这是什么¶
腾讯云可观测平台 tcop-api 是腾讯云可观测平台侧发布的、面向全场景集成的 Agent Skill（SkillHub 来源标注为 enterprise，发布者为「腾讯云可观测平台」）。当前 SkillHub 页面版本为 v1.0.1，分类为 it-ops-security。
一句话定位：在支持 Skill 的 AI 客户端里，用自然语言查询与汇总腾讯云可观测体系内的监控、链路、告警等数据，减少手翻文档与手拼 OpenAPI 参数。
核心功能¶
依据 SkillHub 与官方简介，已核实的能力范围如下。
覆盖的子产品模块¶
Skill 声明覆盖 11 个子产品模块，包括：
- APM
- RUM
- CAT
- PTS
- TMP
- Grafana
- 云产品监控
- 告警
- Dashboard
- EventBridge
其中，基础监控相关数据查询 宣称覆盖 100+ 云产品（以 Skill 简介为准，具体产品列表以 Skill 包内说明与腾讯云 API 为准）。
自然语言到 API 的链路¶
官方给出的示例流程为：用户用自然语言描述查询（例如查某地域 CVM 实例最近一段时间内的 CPU），Skill 侧依次完成：
- 产品路由 — 判断应走哪类可观测/监控接口；
- 指标匹配 — 将口语中的指标映射到平台指标；
- 维度组装 — 补齐地域、实例 ID 等维度；
- API 调用 — 调用对应腾讯云可观测相关 API；
- 结果摘要 — 将返回数据整理成便于阅读的摘要。
全程无需在对话外单独翻文档拼参（仍以你账号权限与 API 可用性为前提）。
安装与启用¶
Skill 基于通用 SKILL.md 格式分发。SkillHub 页面提供两种常见启用方式：把安装提示词发给 AI，或使用 skillhub CLI 安装到当前 Agent 的 skills 目录。
方式一：提示词安装（官方页面推荐）¶
将下面提示词发送给你的 AI（Cursor、Claude Code、Codex 等支持 Skill 的客户端均可按各自 Skill 机制解析）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tcop`。
AI 会按 SkillHub 安装与优先源配置 拉取并落到对应 skills 目录。
方式二：skillhub CLI¶
若本机已有 skillhub，可先确认版本：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 @tencent-adm/tcop 时，必须 使用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被客户端识别。常见路径示例（来自 SkillHub 安装文档）：
| 客户端 | skills 目录示例 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式如下（将 <skills 目录> 替换为上表对应路径）：
skillhub install @tencent-adm/tcop --dir <skills 目录>
也可先搜索再安装：
skillhub search tcop
skillhub install @tencent-adm/tcop --dir <skills 目录>
配置说明¶
SkillHub 标签标明 requires_api_key=false，表示在 SkillHub 元数据层面不强制配置单独的 Skill API Key。实际查询腾讯云监控与可观测数据时，仍依赖你环境中的腾讯云账号鉴权（具体字段与配置以安装后的 SKILL.md 及腾讯云 API 文档为准；本文不展开未在官方页面列出的配置项）。
安装或更新 Skill 后，若客户端未自动加载新技能，按所用客户端说明重启或刷新 Skill 列表。
典型用法¶
以下示例摘自 SkillHub 官方简介，用于说明交互方式，实例 ID 需替换为你账号下的真实资源。
在已启用 @tencent-adm/tcop 的对话中，你可以直接说：
查广州 CVM ins-xxx 最近 1 小时的 CPU
预期行为（与官方描述一致）：Skill 完成产品路由、指标匹配、维度组装、API 调用，并返回 CPU 相关数据的摘要，而不需要你手写监控 API 的 Namespace、MetricName、Instances 等参数。
其他场景可按同样方式用自然语言描述，例如涉及 APM 链路、RUM 前端性能、告警记录、Dashboard 或 EventBridge 等模块的查询；具体能否成功取决于 Skill 包内支持的接口范围与你的账号权限。
适用场景与注意¶
适合谁
- 日常在腾讯云上做 运维、SRE、排障，需要频繁查监控指标、告警或可观测子产品数据；
- 希望把「查数」留在 AI 对话里，减少在多个控制台与 API 文档之间切换；
- 已使用 Cursor、Claude Code、Codex 等支持 SkillHub 技能的 Agent 环境。
使用注意
- 权限与地域：查询结果取决于腾讯云账号对目标资源与 API 的权限；地域、实例 ID 等需与资源实际信息一致。
- 版本：SkillHub 当前展示版本为 1.0.1；升级可用
skillhub按 SkillHub 文档更新，并确认客户端已加载新版本。 - 数据口径：不同子产品（APM、基础监控、Grafana 等）指标定义不同，复杂对比分析仍建议对照腾讯云官方指标说明核对。
- 网络与 CLI：在受限网络环境中安装
skillhub或拉取 Skill 包时，需保证安装脚本与 SkillHub 源可访问。
SkillHub 页面统计（以抓取时为准）：评分 100000，下载 1701 次；分类 it-ops-security。统计会随时间变化，以 SkillHub 实时页面为准。
结尾¶
腾讯云可观测平台 tcop-api 把 APM、RUM、云产品监控、告警等 11 类模块收敛到一个 Skill 里，用自然语言驱动「路由 → 匹配 → 组参 → 调 API → 摘要」的固定链路，适合在 Agent 工作流里做可观测数据查询。
- SkillHub 技能页：https://www.skillhub.cn/skills/tencent-adm/tcop
- 官方介绍地址：https://api.skillhub.cn/tencent-adm/tcop
- 坐标：
@tencent-adm/tcop，版本 1.0.1
