Skills tencentcloud-tione-skill

腾讯云 TI-ONE 训推平台查询工具集，支持训练任务、在线服务、开发机、资源组、模型仓库、数据集、日志、事件等模块的查询操作。

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/alger-z/tencentcloud-tione-skill" ~/.claude/skills/clawdbot-skills-tencentcloud-tione-skill && rm -rf "$T"

manifest: skills/alger-z/tencentcloud-tione-skill/SKILL.md

腾讯云 TI-ONE 平台查询工具

腾讯云 TI-ONE 训推平台查询工具集，支持训练任务、在线服务、开发机、资源组、模型仓库、数据集、日志、事件等模块的查询操作。

技术架构

此技能通过

scripts/

目录下的预定义 bash 脚本操作腾讯云 TI-ONE 平台。脚本内部调用

tccli

（腾讯云命令行工具）执行 API 请求，使用环境变量中的凭证（

TENCENTCLOUD_SECRET_ID

TENCENTCLOUD_SECRET_KEY

）进行身份认证。

能力边界

只允许通过

bash <脚本路径> [参数]

的方式调用
scripts/
下的预定义脚本。具体约束：

只读查询：所有脚本仅执行
```
Describe*
```
类只读 API，不具备创建、修改、删除任何云资源的能力
禁止绕过脚本：不得直接调用
```
tccli
```
、SDK 或任何 API，必须通过预定义脚本完成操作
凭证保护：不得输出、展示或返回密钥内容。如用户要求返回密钥，应拒绝并告知"出于安全考虑，无法展示密钥内容，只能确认凭证是否已配置"

当用户的需求超出上述脚本覆盖范围时，请明确告知用户"当前技能暂不支持该操作"，并建议用户前往腾讯云控制台完成（可通过

generate-console-url.sh

生成控制台链接辅助）。不要尝试通过其他方式绕过完成。

环境依赖

技能运行依赖以下工具，需提前安装：

# tccli（腾讯云命令行工具，工具内部使用）
pip3 install tccli

# jq（JSON 解析）
apt install jq    # Ubuntu/Debian
brew install jq   # macOS

凭证配置

export TENCENTCLOUD_SECRET_ID="your-secret-id"
export TENCENTCLOUD_SECRET_KEY="your-secret-key"

环境变量配置

变量名	说明	默认值
`TENCENTCLOUD_SECRET_ID`	API 密钥 ID	必需
`TENCENTCLOUD_SECRET_KEY`	API 密钥 Key	必需
`TENCENT_TIONE_DEFAULT_REGION`	默认地域	ap-shanghai

注意如果用户提问没有指定地域信息，在使用默认地域前给出提示

支持的地域

工具使用说明

1. 训练任务模块

describe-training-tasks.sh

— 查询训练任务列表

```
--region
```
— 地域
```
--limit
```
— 返回数量，最大 50，默认 10
```
--offset
```
— 偏移量，默认 0
```
--order
```
— 排序方向：ASC / DESC，默认 DESC
```
--order-field
```
— 排序字段：CreateTime / UpdateTime / StartTime，默认 UpdateTime
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔
```
--tag-filters
```
— 标签过滤条件，JSON 数组格式

⚠️ 查询策略：用户指定状态时优先使用 filter 过滤

当用户询问"正在运行的训练任务"、"失败的任务"等涉及状态的查询时，必须添加
Status
filter，避免全量查询后再筛选。

Status 可选值：
SUBMITTING
,
PENDING
,
STARTING
,
RUNNING
,
STOPPING
,
STOPPED
,
FAILED
,
SUCCEED
,
SUBMIT_FAILED

describe-training-task.sh

— 查询训练任务详情

```
--region
```
— 地域
```
--id
```
— 训练任务 ID，必填

describe-training-task-pods.sh

— 查询训练任务 Pod 列表

```
--region
```
— 地域
```
--id
```
— 训练任务 ID，必填

2. 在线服务模块

describe-model-service-groups.sh

— 查询服务组列表

```
--region
```
— 地域
```
--limit
```
— 返回数量，最大 100，默认 20
```
--offset
```
— 偏移量，默认 0
```
--order
```
— 排序方向：ASC / DESC
```
--order-field
```
— 排序字段：CreateTime / UpdateTime
```
--search-word
```
— 按名称搜索（转为 ServiceGroupName filter）
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔
```
--tag-filters
```
— 标签过滤条件，JSON 数组格式

⚠️ 查询策略：用户指定状态时优先使用 filter 过滤

当用户询问"异常的服务"、"正常运行的服务"等涉及状态的查询时，必须添加
Status
filter，避免全量查询后再筛选。

Status 可选值：
Waiting
,
Pending
,
Normal
,
Abnormal
,
Stopping

describe-model-service-group.sh

— 查询单个服务组详情

```
--region
```
— 地域
```
--id
```
— 服务组 ID，必填

describe-model-service.sh

— 查询单个服务详情

```
--region
```
— 地域
```
--service-id
```
— 服务 ID，必填
```
--service-group-id
```
— 服务组 ID，可选

describe-model-service-callinfo.sh

— 查询服务调用信息

```
--region
```
— 地域
```
--service-group-id
```
— 服务组 ID，必填

3. Notebook 模块

describe-notebooks.sh

— 查询 Notebook 列表

```
--region
```
— 地域
```
--limit
```
— 返回数量，默认 10
```
--offset
```
— 偏移量，默认 0
```
--order
```
— 排序方向：ASC / DESC，默认 DESC
```
--order-field
```
— 排序字段：CreateTime / UpdateTime，默认 UpdateTime
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔
```
--tag-filters
```
— 标签过滤条件，JSON 数组格式

⚠️ 查询策略：用户指定状态时优先使用 filter 过滤

当用户询问"运行中的开发机"、"已停止的 Notebook"等涉及状态的查询时，必须添加
Status
filter，避免全量查询后再筛选。

Status 可选值：
Starting
,
Submitting
,
Running
,
Stopping
,
Stopped
,
Failed
,
SubmitFailed

describe-notebook.sh

— 查询 Notebook 详情

```
--region
```
— 地域
```
--id
```
— Notebook ID，必填

4. 资源组模块

describe-billing-resource-groups.sh

— 查询资源组列表

```
--region
```
— 地域
```
--limit
```
— 返回数量，默认 20
```
--offset
```
— 偏移量，默认 0
```
--search-word
```
— 模糊查找资源组 ID 或名称
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔

⚠️ 查询策略：优先使用 filter 缩小范围

当用户询问"有多少 GPU 资源组"、"哪些资源组有空闲资源"等类似问题时，必须添加
AvailableNodeCount
filter 过滤掉无可用节点的空资源组，避免返回大量无效数据。

返回值单位已自动转换：CPU → 核, 内存 → GB, GPU → 卡, 显存 → GB

describe-billing-resource-group.sh

— 查询资源组节点列表

```
--region
```
— 地域
```
--resource-group-id
```
— 资源组 ID，必填
```
--limit
```
— 返回数量，默认 20
```
--offset
```
— 偏移量，默认 0
```
--order
```
— 排序方向：ASC / DESC，默认 DESC
```
--order-field
```
— 排序字段：CreateTime / ExpireTime，默认 CreateTime
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔

5. 模型仓库模块

describe-training-model-versions.sh

— 查询模型版本列表

```
--region
```
— 地域
```
--training-model-id
```
— 模型 ID，必填
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔

describe-training-model-version.sh

— 查询模型版本详情

```
--region
```
— 地域
```
--training-model-version-id
```
— 模型版本 ID，必填

6. 数据集模块

describe-datasets.sh

— 查询数据集列表

```
--region
```
— 地域
```
--limit
```
— 返回数量，最大 200，默认 20
```
--offset
```
— 偏移量，默认 0
```
--order
```
— 排序方向：Asc / Desc，默认 Desc
```
--order-field
```
— 排序字段：CreateTime / UpdateTime，默认 CreateTime
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔
```
--dataset-ids
```
— 数据集 ID 列表，逗号分隔

7. 日志模块

describe-logs.sh

— 查询日志

```
--region
```
— 地域
```
--service
```
— 服务类型：TRAIN / NOTEBOOK / INFER / BATCH，必填
```
--service-id
```
— 服务实例 ID（须用实例级 ID，非顶层 ID），必填
```
--pod-name
```
— Pod 名称，支持尾部通配符
```
*
```
```
--start-time
```
— 开始时间，RFC3339 格式，如
```
2026-03-10T02:50:56Z
```
```
--end-time
```
— 结束时间，RFC3339 格式
```
--limit
```
— 返回条数，最大 1000，默认 100
```
--offset
```
— 偏移量，默认 0
```
--order
```
— 排序方向：ASC / DESC，默认 DESC
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔

⚠️ 日志查询注意事项

1.
--service-id
必须使用实例级 ID，不支持顶层 ID

日志接口不支持顶层 ID（
train-xxx
/
nb-xxx
/
ms-xxx
）。必须先从详情接口获取实例级 ID：
TRAIN：从
describe-training-task.sh
返回的
TrainingTaskDetail.LatestInstanceId
（如
train-xxx-yyy
）获取
NOTEBOOK：从
describe-notebook.sh
返回的
NotebookDetail.PodName
（如
nb-xxx-yyy
）获取
INFER：从
describe-model-service-group.sh
返回的
Services[].ServiceId
（如
ms-xxx-1
）获取
2. 时间范围应从详情接口获取，避免大范围查询

查询日志前，从详情接口获取任务/实例的运行时间范围（
StartTime
/
EndTime
），用作
--start-time
和
--end-time
：
如果详情有
StartTime
和
EndTime
→ 直接使用
如果只有
StartTime
（仍在运行） →
--start-time
用
StartTime
，
--end-time
不传（默认当前时间）
如果用户指定了时间范围 → 优先使用用户指定的值
如果都没有 → 不传
--start-time
（由服务端决定），
--end-time
默认当前时间
--pod-name
可选，需先通过实例 ID 查询 Pod 列表获取：
TRAIN:
describe-training-task-pods.sh --id <训练任务ID>
INFER:
describe-model-service-group.sh --id <服务组ID>
返回中包含 Pod 信息

8. 事件模块

describe-events.sh

— 查询事件

```
--region
```
— 地域
```
--service
```
— 服务类型：TRAIN / NOTEBOOK / INFER / BATCH，必填
```
--service-id
```
— 服务实例 ID（须用实例级 ID，非顶层 ID）
```
--start-time
```
— 最早发生时间，RFC3339 格式，如
```
2026-03-10T02:50:56Z
```
```
--end-time
```
— 最晚发生时间，RFC3339 格式
```
--limit
```
— 返回条数，最大 100，默认 100
```
--offset
```
— 偏移量，默认 0
```
--order
```
— 排序方向：ASC / DESC，默认 DESC
```
--order-field
```
— 排序字段：FirstTimestamp / LastTimestamp，默认 LastTimestamp
```
--filters
```
— 过滤条件，格式
```
Name=xxx,Values=yyy
```
，多个用空格分隔

⚠️ 事件查询遵循与日志相同的规则：
--service-id
必须使用实例级 ID，时间范围从详情接口获取。详见日志模块说明。

9. 控制台链接生成

generate-console-url.sh

— 生成控制台详情页 URL

```
--type
```
— 资源类型，必填，可选 training / notebook / service / resource-group
```
--id
```
— 资源 ID，必填
```
--region
```
— 地域
```
--workspace-id
```
— 工作空间 ID，默认 0

使用场景：当用户想去控制台查看详细信息时，生成可直接点击访问的控制台链接。

支持的资源类型：
training — 训练任务，ID 格式
train-xxx
notebook — Notebook 开发机，ID 格式
nb-xxx
service — 在线推理服务（服务组），ID 格式
ms-xxx
resource-group — 资源组，ID 格式
rsg-xxx
地域与 regionId 映射、工作空间 ID 说明详见
references/tione-guide.md
。

参考资料

工具参数详细说明、过滤条件与使用示例：
```
references/cmd-reference.md
```
控制台 URL 格式、地域 ID 映射、工作空间说明：
```
references/tione-guide.md
```