前言¶

在 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