腾讯云 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 |
注意 如果用户提问没有指定地域信息，在使用默认地域前给出提示
支持的地域
ap-beijing | ap-shanghai | ap-guangzhou | ap-shanghai-adc | ap-zhongwei | ap-nanjing
工具使用说明
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 过滤
当用户询问"正在运行的训练任务"、"失败的任务"等涉及状态的查询时，必须添加
Statusfilter，避免全量查询后再筛选。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 过滤
当用户询问"异常的服务"、"正常运行的服务"等涉及状态的查询时，必须添加
Statusfilter，避免全量查询后再筛选。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"等涉及状态的查询时，必须添加
Statusfilter，避免全量查询后再筛选。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 资源组"、"哪些资源组有空闲资源"等类似问题时，必须添加
AvailableNodeCountfilter 过滤掉无可用节点的空资源组，避免返回大量无效数据。返回值单位已自动转换：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