查询评测集合成任务详情 - ShowOpsSynthesisTask
功能介绍
该接口用于通过任务ID检索特定评测集合成任务的完整信息,涵盖任务配置快照、实时执行状态及生成统计。
URI
GET /v1/ops/datasets-synthesis/{synthesis_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
synthesis_id |
是 |
String |
参数解释: 合成任务的唯一标识符(ID)。该参数用于在路径中指定特定的合成任务,以便执行查询、停止或删除等操作。 约束限制: 字符串长度限制为1到64个字符。通常采用标准 UUID格式。 取值范围: 1-64位字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
Content-Type |
是 |
String |
参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
|
Authorization |
是 |
String |
参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
X-Sdk-Date |
是 |
String |
参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 合成任务的唯一标识符。 取值范围: 由系统生成的任务ID。 |
|
name |
String |
参数解释: 用户为合成任务定义的描述性名称。 取值范围: 任意字符串。 |
|
scenario_type |
String |
参数解释: 合成任务所属的技术场景分类标识。 取值范围: 如seed_data等。 |
|
scenario_name |
String |
参数解释: 合成场景的友好展示名称。 取值范围: 如 "基于种子数据泛化"。 |
|
scenario_description |
String |
参数解释: 该合成任务具体业务逻辑或目标的详细说明。 取值范围: 自定义场景描述。 |
|
status |
String |
参数解释: 合成任务当前的生命周期运行状态。 取值范围: pending(等待执行),running(正在运行),completed(已完成),failed(执行失败),stopped(已人工停止)。 |
|
stats |
EvaluationOpsSynethsisStats object |
参数解释: 任务执行的统计数据快照。 取值范围: 参考EvaluationOpsSynethsisStats定义。 |
|
usage |
EvaluationOpsTokenUsage object |
参数解释: 本次合成任务消耗的模型Token资源统计。 取值范围: 参考EvaluationOpsTokenUsage定义。 |
|
model_config |
EvaluationOpsModelConfig object |
参数解释: 任务发起时所采用的模型参数配置。 取值范围: 参考EvaluationOpsModelConfig定义。 |
|
seed_data |
EvaluationOpsSeedDataConfig object |
参数解释: 任务依赖的种子数据配置信息。 取值范围: 参考EvaluationOpsSeedDataConfig定义。 |
|
schemas |
Array of EvaluationOpsSynthesisSchema objects |
参数解释: 合成数据所遵循的字段结构定义(Schema)列表。 取值范围: 包含字段名称、类型、描述等元数据的对象数组。 |
|
base_info |
EvaluationOpsTaskBaseInfo object |
参数解释: 任务的基础管理元数据。 取值范围: 参考EvaluationOpsTaskBaseInfo定义。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total |
Integer |
参数解释: 任务计划生成的总样本条数。 约束限制: 0-500之间的整数。 取值范围: 0-500。 默认取值: 0。 |
|
progress |
Integer |
参数解释: 当前任务执行的百分比进度。 约束限制: 0-100之间的整数。 取值范围: 0-100。 默认取值: 0。 |
|
success |
Integer |
参数解释: 当前已成功生成的样本总数。 约束限制: 0-500之间的整数。 取值范围: 0-500。 默认取值: 0。 |
|
failed |
Integer |
参数解释: 在合成过程中失败的样本总数。 约束限制: 0-500之间的整数。 取值范围: 0-500。 默认取值: 0。 |
|
running |
Integer |
参数解释: 当前正处于活跃生成阶段的样本条数。 约束限制: 0-500之间的整数。 取值范围: 0-500。 默认取值: 0。 |
|
pending |
Integer |
参数解释: 尚未开始执行、在队列中等待的样本条数。 约束限制: 0-500之间的整数。 取值范围: 0-500。 默认取值: 0。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
prompt_tokens |
Long |
参数解释: 输入提示词所消耗的Token数量。 约束限制: 长整型数值。 取值范围: 0-9,999,999,999。 默认取值: 0。 |
|
completion_tokens |
Long |
参数解释: 模型生成内容所消耗的Token数量。 约束限制: 长整型数值。 取值范围: 0-9,999,999,999。 默认取值: 0。 |
|
total_tokens |
Long |
参数解释: 本次任务产生的Token消耗总量。 约束限制: 计算公式为 prompt_tokens + completion_tokens。 取值范围: 0-9,999,999,999。 默认取值: 0。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
model_id |
String |
参数解释: 指定调用的大模型唯一标识符。 约束限制: 1-64个字符。 取值范围: 合法的模型ID字符串。 默认取值: 不涉及。 |
|
model_name |
String |
参数解释: 模型的显示名称。 约束限制: 2-100个字符。 取值范围: 任意字符串。 默认取值: 不涉及。 |
|
temperature |
Float |
参数解释: 采样温度参数,用于控制输出的随机性。数值低更聚焦,数值高更具创造性。 约束限制: 浮点数。 取值范围: 0.0到2.0。 默认取值: 0.7。 |
|
max_tokens |
Integer |
参数解释: 单次推理生成的最大Token数量限制。 约束限制: 1-32,000之间的整数。 取值范围: 1-32000。 默认取值: 2000。 |
|
top_p |
Float |
参数解释: 核采样参数。 约束限制: 浮点数。 取值范围: 0.0到1.0。 默认取值: 1.0。 |
|
frequency_penalty |
Float |
参数解释: 频率惩罚系数,降低内容重复倾向。 约束限制: 浮点数。 取值范围: -2.0到2.0。 默认取值: 0。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
参数解释: 种子数据的来源类型。 约束限制: 枚举值。 取值范围: dataset(评测集),file(文件)。 默认取值: 不涉及。 |
|
dataset_id |
String |
参数解释: 种子评测集的唯一ID。 约束限制: 0-64字符。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 默认取值: 不涉及。 |
|
dataset_name |
String |
参数解释: 种子评测集的展示名称。 约束限制: 0-200字符。 取值范围: 任意字符串。 默认取值: 不涉及。 |
|
dataset_version_id |
String |
参数解释: 种子评测集版本的内部唯一标识符。 约束限制: 0-64字符。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 默认取值: 不涉及。 |
|
dataset_version |
String |
参数解释: 种子评测集的可读版本号。 约束限制: 0-64字符。 取值范围: 如0.0.1。 默认取值: 不涉及。 |
|
file_name |
String |
参数解释: 作为种子源的临时文件名称。 约束限制: 1-200字符。 取值范围: 文件名。 默认取值: 不涉及。 |
|
obs_tmp_file_id |
String |
参数解释: 种子数据文件在对象存储中的路径。 约束限制: 最大长度10000字符。 取值范围: OBS路径。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
name |
String |
参数解释: 合成字段的名称。 约束限制: 长度 1-100字符。 取值范围: 由字母、数字、下划线组成。 默认取值: 不涉及。 |
|
description |
String |
参数解释: 合成字段的业务含义描述。 约束限制: 0-400字符。 取值范围: 任意字符串。 默认取值: 不涉及。 |
|
synthesis_requirement |
String |
参数解释: 合成要求,用于指导LLM生成该字段的思考路径。 约束限制: 0-4000 字符。 取值范围: 详细的指令说明。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
created_at |
String |
参数解释: 任务在系统中创建的时间戳。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
start_at |
String |
参数解释: 任务正式开始执行的精确时刻。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
updated_at |
String |
参数解释: 任务状态或元数据最后一次变更的时间。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
completed_at |
String |
参数解释: 任务执行完毕(无论成败)的时间。 约束限制: ISO8601标准。 取值范围: 日期时间字符串。 默认取值: 不涉及。 |
|
duration_seconds |
Long |
参数解释: 任务的有效运行总时长(秒)。 约束限制: 0到31,536,000 之间的整数。 取值范围: 非负整数。 默认取值: 0。 |
|
created_by |
UserInfoObj object |
参数解释: 创建该任务的用户详细信息。 约束限制: 不涉及。 取值范围: 参考UserInfoObj。 默认取值: 不涉及。 |
|
started_by |
UserInfoObj object |
参数解释: 启动该任务的用户详细信息。 约束限制: 不涉及。 取值范围: 参考UserInfoObj。 默认取值: 不涉及。 |
请求示例
请求查询评测集合成任务详情
GET https://*.com/agentarts/v1/ops/datasets-synthesis/a67452bf21f819-6f91-4568-9f2f-57ef9562ab7
响应示例
状态码:200
查询成功
{
"id" : "task_uuid",
"status" : "running",
"stats" : {
"total" : 50
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询成功 |
错误码
请参见错误码。