查询数据集的团队标注任务列表
功能介绍
查询数据集的团队标注任务列表。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| dataset_id | 是 | String | 数据集ID。 |
| project_id | 是 | String | 用户项目ID。获取方法请参见获取项目ID和名称。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 否 | Integer | 分页列表的起始页,默认为0。 |
| limit | 否 | Integer | 指定每一页返回的最大条目数,取值范围[1,1000],默认为1000。 |
请求参数
无
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| count | Integer | 团队标注任务总数。 |
| tasks | Array of WorkforceTask objects | 分页查询到的团队标注任务列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| auto_sync_dataset | Boolean | 团队标注任务的标注结果是否自动同步至数据集。可选值如下:
|
| check_rate | Double | 团队标注任务验收比例。 |
| checking_task_desc | WorkforceSamplingTaskDesc object | 团队标注任务当前验收任务详情。 |
| create_time | Long | 标注任务创建时间。 |
| dataset_id | String | 数据集ID。 |
| description | String | 标注任务描述信息。 |
| label_stats | Array of LabelStats objects | 标注任务标签统计信息。 |
| pass_rate | Double | 团队标注任务验收通过率。 |
| repetition | Integer | 团队标注任务每个样本可以由多少人标注,最少为1。 |
| sample_search_conditions | Array of SearchCondition objects | 创建任务时的样本筛选条件。 |
| sample_stats | SampleStats object | 标注任务样本统计信息。 |
| score | Double | 团队标注任务平均验收审核评分。 |
| status | Integer | 团队标注任务状态,可选值如下:
|
| synchronize_auto_labeling_data | Boolean | 团队标注任务是否同步智能标注结果。可选值如下:
|
| synchronize_data | Boolean | 团队标注任务是否同步更新新增数据。可选值如下:
|
| task_id | String | 标注任务ID。 |
| task_name | String | 标注任务名称。 |
| update_time | Long | 标注任务更新时间。 |
| version_id | String | 标注任务关联的数据集版本ID。 |
| workforce_stats | WorkforceStats object | 团队标注任务人员统计信息。 |
| workforces_config | WorkforcesConfig object | 团队标注任务团队信息:委托团队管理员分配,或指定团队自行分配。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| action | Integer | 验收操作。可选值如下:
|
| checking_stats | CheckTaskStats object | 验收任务实时验收报告。 |
| checking_task_id | String | 当前验收任务ID。 |
| overwrite_last_result | Boolean | 验收时若样本已标注,是否使用验收结果覆盖已标注结果。可选值如下:
|
| total_stats | CheckTaskStats object | 历史验收任务汇总后的验收报告。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| accepted_sample_count | Integer | 通过的样本数目。 |
| checked_sample_count | Integer | 已验收的样本数目。 |
| pass_rate | Double | 样本的通过率。 |
| rejected_sample_count | Integer | 驳回的样本数目。 |
| sampled_sample_count | Integer | 抽样的样本数目。 |
| sampling_num | Integer | 验收任务的抽样数目。 |
| sampling_rate | Double | 验收任务的抽样比例。 |
| score | String | 验收评分。 |
| task_id | String | 验收任务ID。 |
| total_sample_count | Integer | 总的样本数目。 |
| total_score | Long | 验收总分。 |
| unchecked_sample_count | Integer | 未验收的样本数目。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| attributes | Array of LabelAttribute objects | 标签的多维度属性,如标签为“音乐”,可能包含属性“风格”、“歌手”等。 |
| count | Integer | 该标签的打标数量。 |
| name | String | 标签名称。 |
| property | LabelProperty object | 标签基本属性键值对,如颜色、快捷键等。 |
| sample_count | Integer | 包含该标签的样本数量。 |
| type | Integer | 标签类型。可选值如下:
|
| 参数 | 参数类型 | 描述 |
|---|---|---|
| default_value | String | 标签属性默认值。 |
| id | String | 标签属性ID。可通过调用标签列表查询。 |
| name | String | 标签属性名称。不能超过64个字符,不能包含字符!<>=&"'。 |
| type | String | 标签属性类型。可选值如下:
|
| values | Array of LabelAttributeValue objects | 标签属性值列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| @modelarts:color | String | 内置属性:标签展示的颜色,为色彩的16进制代码,默认为空。例如:“#FFFFF0”。 |
| @modelarts:default_shape | String | 内置属性:物体检测标签的默认形状(物体检测标签专用属性),默认为空。可选值如下:
|
| @modelarts:from_type | String | 内置属性:三元组关系标签的起始实体类型,创建关系标签时必须指定,该参数仅文本三元组数据集使用。 |
| @modelarts:rename_to | String | 内置属性:重命名后的标签名。 |
| @modelarts:shortcut | String | 内置属性:标签快捷键,默认为空。例如:“D”。 |
| @modelarts:to_type | String | 内置属性:三元组关系标签的指向实体类型,创建关系标签时必须指定,该参数仅文本三元组数据集使用。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| coefficient | String | 根据难度系数筛选。 |
| frame_in_video | Integer | 视频中某帧。 |
| hard | String | 样本级别是否难例。可选值如下:
|
| import_origin | String | 根据数据来源筛选。 |
| kvp | String | CT剂量,通过剂量来筛选。 |
| label_list | SearchLabels object | 标签搜索条件。 |
| labeler | String | 标注人。 |
| metadata | SearchProp object | 通过样本属性搜索。 |
| parent_sample_id | String | 父样本ID。 |
| sample_dir | String | 根据样本所在目录搜索(目录需要以/结尾),只搜索指定目录下的样本,不支持目录递归搜索。 |
| sample_name | String | 根据样本名称搜索(含后缀名)。 |
| sample_time | String | 样本加入到数据集时,会根据样本在OBS上的最后修改时间(精确到天)建立索引,此处可以根据此时间进行搜索。可选值如下:
|
| score | String | 根据置信度筛选。 |
| slice_thickness | String | DICOM层厚,通过层厚筛选样本。 |
| study_date | String | DICOM扫描时间。 |
| time_in_video | String | 视频中某个时间。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| labels | Array of SearchLabel objects | 标签搜索条件列表。 |
| op | String | 如要搜索多个标签,则op需要有值;如果只搜索一个标签,则无需指定op的值。可选值如下:
|
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 标签名。 |
| op | String | 多个属性之间的操作类型。可选值如下:
|
| property | Map<String,Array<String>> | 标签属性,是Object格式,存放任意的键值对;key是属性名称,value是取值列表,如value为null表示不根据值搜索,否则搜索的值满足列表中任意一个即可。 |
| type | Integer | 标签类型。可选值如下:
|
| 参数 | 参数类型 | 描述 |
|---|---|---|
| op | String | 多个属性值之间的关系。可选值如下:
|
| props | Map<String,Array<String>> | 属性的搜索条件,可以有多个属性条件。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| accepted_sample_count | Integer | owner验收通过样本数目。 |
| auto_annotation_sample_count | Integer | 智能标注待确认样本数目。 |
| deleted_sample_count | Integer | 已删除的样本数目。 |
| rejected_sample_count | Integer | owner验收不通过的样本数目。 |
| sampled_sample_count | Integer | 待owner验收且被抽样的样本数目。 |
| total_sample_count | Integer | 样本总数量。 |
| unannotated_sample_count | Integer | 未标注样本数。 |
| uncheck_sample_count | Integer | reviewer审核通过待owner验收的样本数目。 |
| unreviewed_sample_count | Integer | labeler标注完未被reviewer审核的样本数目。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| labeler_count | Integer | 标注人员数量,不能超过100个。 |
| reviewer_count | Integer | 审核人员数量,不能超过100个。 |
| workforce_count | Integer | 团队数量。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| agency | String | 管理员。 |
| workforces | Array of WorkforceConfig objects | 执行标注任务的团队列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| workers | Array of Worker objects | 标注成员列表。 |
| workforce_id | String | 标注团队ID。 |
| workforce_name | String | 标注团队名称,名称不能包含!<>=&"',长度为0-1024位。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| create_time | Long | 创建时间。 |
| description | String | 标注成员描述,长度为0-256位,不能包含^!<>=&"'特殊字符。 |
| | String | 标注成员邮箱。 |
| role | Integer | 角色。可选值如下:
|
| status | Integer | 标注成员的当前登录状态。可选值如下:
|
| update_time | Long | 更新时间。 |
| worker_id | String | 标注成员ID。 |
| workforce_id | String | 所属标注团队ID。 |
请求示例
查询数据集的团队标注任务列表
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks 响应示例
状态码: 200
OK
{
"count" : 2,
"tasks" : [ {
"dataset_id" : "WxCREuCkBSAlQr9xrde",
"task_id" : "tY330MHxV9dqIPVaTRM",
"task_name" : "task-cd60",
"status" : 1,
"create_time" : 1606224714358,
"update_time" : 1606224714358,
"repetition" : 1,
"workforces_config" : {
"workforces" : [ {
"workforce_id" : "0PfqwXA8M59pppYBx4k",
"workforce_name" : "team-123",
"workers" : [ {
"email" : "xxx@xxx.com",
"worker_id" : "6db04ae0afb54d7274a2982255516c29",
"role" : 2
}, {
"email" : "xxx@xxx.com",
"worker_id" : "8c15ad080d3eabad14037b4eb00d6a6f",
"role" : 0
} ]
} ]
},
"synchronize_data" : true,
"synchronize_auto_labeling_data" : true,
"workforce_stats" : {
"workforce_count" : 1,
"labeler_count" : 1,
"reviewer_count" : 0
},
"sample_stats" : {
"total_sample_count" : 309,
"unannotated_sample_count" : 308,
"unreviewed_sample_count" : 0,
"uncheck_sample_count" : 1,
"sampled_sample_count" : 0,
"rejected_sample_count" : 0,
"accepted_sample_count" : 0,
"auto_annotation_sample_count" : 0
},
"auto_sync_dataset" : true
}, {
"dataset_id" : "WxCREuCkBSAlQr9xrde",
"task_id" : "iYZx7gScPUozOXner9k",
"task_name" : "task-e63f",
"status" : 1,
"create_time" : 1606184400278,
"update_time" : 1606184400278,
"repetition" : 1,
"workforces_config" : {
"workforces" : [ {
"workforce_id" : "q3ZFSwORu1ztKljDLYQ",
"workforce_name" : "modelarts-team",
"workers" : [ {
"email" : "xxx@xxx.com",
"worker_id" : "afdda13895bc66322ffbf36ae833bcf0",
"role" : 0
} ]
} ]
},
"synchronize_data" : false,
"synchronize_auto_labeling_data" : false,
"workforce_stats" : {
"workforce_count" : 1,
"labeler_count" : 1,
"reviewer_count" : 0
},
"sample_stats" : {
"total_sample_count" : 317,
"unannotated_sample_count" : 310,
"unreviewed_sample_count" : 0,
"uncheck_sample_count" : 0,
"sampled_sample_count" : 0,
"rejected_sample_count" : 0,
"accepted_sample_count" : 7,
"auto_annotation_sample_count" : 0
},
"checking_task_desc" : {
"checking_task_id" : "onSbri2oqYOmDjDyW17",
"action" : 0,
"overwrite_last_result" : false
},
"auto_sync_dataset" : true
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
错误码
请参见错误码。