前言¶

在 TI-ONE 上排障时，常见路径是打开控制台逐页点训练任务、在线服务、开发机和日志。若你已经在 Cursor、Claude Code 等环境里用 Agent 处理运维问题，更希望用自然语言问「这台训练任务为什么失败」「推理服务组是否异常」，而不是反复切换页面抄 ID。

下面介绍 SkillHub 上的 Tencent Cloud TIONE（坐标 @tencent-adm/tencentcloud-tione-skill）。它把 TI-ONE 的 Describe 类查询封装成一组 bash 脚本，由 Agent 按 SKILL 约定调用，在凭证不出屏的前提下完成列表、详情、日志与事件等只读操作。

这是什么¶

Tencent Cloud TIONE 是腾讯云 TI-ONE 团队发布的 enterprise 来源 Skill，当前版本 1.0.5，分类为 it-ops-security，SkillHub 标签含 requires_api_key=true。

一句话定位：腾讯云 TI-ONE 训推平台的查询工具集，覆盖训练任务、在线服务、开发机（Notebook）、资源组、模型仓库、数据集、日志、事件等模块；不提供创建、修改或删除云资源的能力。

核心功能¶

技能通过 scripts/ 下预定义脚本调用 tccli 的 TI-ONE 接口，Agent 只能以 bash <脚本路径> [参数] 方式执行，且均为 Describe* 只读 API。主要模块如下。

查询策略上，SKILL 明确要求：用户问「运行中的任务」「异常服务」等状态时，应优先用 --filters 传 Status 等条件，避免先全量拉取再筛选。日志与事件的 --service-id 须使用实例级 ID（例如从训练任务详情的 LatestInstanceId、Notebook 的 PodName、服务组详情的 Services[].ServiceId 取得），不能直接用顶层 train-xxx / nb-xxx / ms-xxx。

默认地域由环境变量 TENCENT_TIONE_DEFAULT_REGION 控制，未配置时为 ap-shanghai；支持的地域包括 ap-beijing、ap-shanghai、ap-guangzhou、ap-shanghai-adc、ap-zhongwei、ap-nanjing。未指定地域时，Agent 应在使用默认值前向用户说明。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

先确认本机是否已有 CLI：

command -v skillhub && skillhub --version

未安装时可按 SkillHub 官方说明执行完整安装（含 CLI 与默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2. 安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。坐标与 SkillHub 页面一致：

skillhub install @tencent-adm/tencentcloud-tione-skill --dir <你的 skills 目录>

常见路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可将下面提示词发给 Agent，让其按 SkillHub 安装说明 完成安装：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencentcloud-tione-skill`。

3. 运行依赖¶

脚本依赖 tccli 与 jq：

pip3 install tccli
apt install jq    # Ubuntu/Debian
# macOS: brew install jq

4. 凭证与环境变量¶

腾讯云 API 密钥通过环境变量注入（Skill 元数据标记需要 API Key）：

export TENCENTCLOUD_SECRET_ID="your-secret-id"
export TENCENTCLOUD_SECRET_KEY="your-secret-key"
export TENCENT_TIONE_DEFAULT_REGION="ap-shanghai"   # 可选，默认 ap-shanghai

SKILL 要求 Agent 不得输出或回显密钥内容；仅可确认是否已配置。

典型用法¶

安装并配置凭证后，在 Agent 对话中可直接描述意图，例如「列出上海地域状态为 RUNNING 的训练任务」「查看服务组 ms-xxx 的详情和调用信息」。Agent 应进入已安装 Skill 目录，调用对应脚本。

以下示例摘自技能包内 references/cmd-reference.md，路径相对于 Skill 根目录；将 train-xxx、ms-xxx 等替换为真实 ID。

按状态查训练任务：

./scripts/training/describe-training-tasks.sh --region ap-shanghai --filters "Name=Status,Values=RUNNING"

排查训练任务（详情 → 日志 → 事件）：

./scripts/training/describe-training-task.sh --region ap-shanghai --id train-xxx

./scripts/log/describe-logs.sh --region ap-shanghai --service TRAIN \
  --service-id train-xxx-yyy \
  --start-time "2026-03-10T02:50:56Z" --end-time "2026-03-10T03:30:00Z" --limit 50

./scripts/event/describe-events.sh --region ap-shanghai --service TRAIN \
  --service-id train-xxx-yyy --start-time "2026-03-10T02:50:56Z"

其中 train-xxx-yyy 来自详情中的 LatestInstanceId，时间范围宜与详情中的 StartTime / EndTime 对齐。

查异常在线服务组：

./scripts/service/describe-model-service-groups.sh --region ap-shanghai --filters "Name=Status,Values=Abnormal"

生成控制台链接（需去页面进一步操作时）：

./scripts/utils/generate-console-url.sh --type training --id train-xxx --region ap-shanghai

更完整的参数表与过滤字段见技能内 references/cmd-reference.md、references/tione-guide.md。

适用场景与注意¶

适合谁： 已在腾讯云 TI-ONE 上跑训练、推理或 Notebook，希望在与 Agent 的对话里完成状态核对、日志与事件拉取、资源组容量查看，且接受「只读、不代客改配置」边界的团队。

限制与注意：

• 仅支持 SKILL 列出的脚本；超出范围应提示用户去控制台，可用 generate-console-url.sh 辅助跳转。
• Agent 不得绕过脚本直接调用 tccli 或其它 SDK（SKILL 硬性约束）。
• 日志、事件接口对实例 ID 与时间范围敏感，应先查详情再查日志，避免大范围扫描。
• 资源组列表脚本会对 CPU、内存、GPU 等返回值做单位换算（如 GPU 为「卡」），阅读输出时注意与控制台单位一致。

SkillHub 页面显示该 Skill 评分 100000、下载约 1809 次（统计以 SkillHub 展示为准）。

结尾¶

Tencent Cloud TIONE 把 TI-ONE 高频只读查询固化成 Agent 可执行的脚本与查询策略，适合把「看状态、拉日志、对 ID」留在对话里完成。官方入口：

• SkillHub：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-tione-skill
• API 坐标页：https://api.skillhub.cn/tencent-adm/tencentcloud-tione-skill