Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ ModelArts/ Referencia de la API/ Gestión de datos/ Gestión de tareas de etiquetado/ Consulta de la lista de tareas de etiquetado de equipos de un conjunto de datos

Actualización más reciente 2022-11-14 GMT+08:00

Ver PDF

Consulta de la lista de tareas de etiquetado de equipos de un conjunto de datos

Función

Esta API se utiliza para consultar la lista de tareas de etiquetado de equipos de un conjunto de datos.

URI

GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
dataset_id	Sí	String	ID de conjunto de datos.
project_id	Sí	String	ID del proyecto. Para obtener más información sobre cómo obtener el ID de proyecto, consulte Obtención de un ID de proyecto.

**Tabla 2** Parámetros de Query
Parámetro	Obligatorio	Tipo	Descripción
offset	No	Integer	Página de inicio para la visualización de paginación. El valor predeterminado es 0.
limit	No	Integer	Número máximo de registros devueltos en cada página. El valor varía de 1 a 1000. El valor predeterminado es 1000.

Parámetros de solicitud

Ninguno

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
count	Integer	Número total de tareas de etiquetado del equipo.
tasks	Array of WorkforceTask objects	Lista de tareas de etiquetado de equipo consultada por página.

**Tabla 4** WorkforceTask
Parámetro	Tipo	Descripción
auto_sync_dataset	Boolean	Si se sincroniza automáticamente el resultado de una tarea de etiquetado de equipo con el conjunto de datos. Opciones: true: Sincroniza automáticamente el resultado de una tarea de etiquetado de equipo con el conjunto de datos. false: No sincronice automáticamente el resultado de una tarea de etiquetado de equipo con el conjunto de datos.
check_rate	Double	Ratio de aceptación de una tarea de etiquetado de equipo.
checking_task_desc	WorkforceSamplingTaskDesc object	Detalles sobre la tarea de aceptación actual de una tarea de etiquetado de equipo.
create_time	Long	Hora en la que se crea una tarea de etiquetado.
dataset_id	String	ID de conjunto de datos.
description	String	Descripción de una tarea de etiquetado.
label_stats	Array of LabelStats objects	Estadísticas de etiquetas de una tarea de etiquetado.
pass_rate	Double	Tasa de aprobación de aceptación de una tarea de etiquetado de equipo.
repetition	Integer	Número de personas que etiquetan cada muestra en una tarea de etiquetado de equipo. El valor mínimo es 1.
sample_search_conditions	Array of SearchCondition objects	Criterios de búsqueda de ejemplo al crear una tarea.
sample_stats	SampleStats object	Estadísticas de ejemplo de una tarea de etiquetado.
score	Double	Puntuación promedio de aceptación de una tarea de etiquetado de equipo.
status	Integer	Estado de una tarea de etiquetado de equipo. Opciones:- 6: Creado. La tarea ha sido creada por el propietario pero no se ha iniciado. Solo el propietario y el administrador pueden ver la lista de tareas.- 0: Inicio. El propietario o el administrador está iniciando la tarea y los archivos que se van a etiquetar siguen siendo asignados. El propietario, el administrador, el anotador y el revisor pueden ver la lista de tareas. Puesto que la asignación de tareas no se ha completado, no se puede iniciar ninguna otra tarea.- 1: en ejecución. El anotador o revisor realiza el etiquetado o revisa la tarea, y el propietario realiza la aceptación. Por ejemplo, los nuevos archivos necesitan ser asignados de nuevo si los archivos de etiquetado automático se agregan o sincronizan, o los archivos sin etiqueta se importan.- 2: Aceptando. El propietario inicia una tarea de aceptación, pero la aceptación no se ha completado. En este estado, una nueva tarea de aceptación se puede iniciar solo después de que se complete la actual.- 3: Aceptado. La tarea de etiquetado del equipo se ha completado.- 4: Rechazado. El administrador vuelve a iniciar la tarea. En este estado, las muestras deben ser etiquetadas y la tarea debe ser revisada de nuevo.- 5: Sincronizando del resultado de la aceptación. Este estado se agrega cuando una tarea de aceptación cambia para ser asíncrona. En este estado, no se puede iniciar ninguna nueva tarea de aceptación y no se puede continuar la tarea de aceptación actual. En el área de nombre de tarea, el sistema muestra un mensaje indicando que el resultado de la aceptación está siendo sincronizado.- 7: Muestreo de aceptación. Este estado se agrega cuando una tarea de aceptación cambia para ser asíncrona. En este estado, no se puede iniciar ninguna nueva tarea de aceptación y no se puede continuar la tarea de aceptación actual. En el área de nombre de tarea, el sistema muestra un mensaje que indica que el muestreo de aceptación está en curso.
synchronize_auto_labeling_data	Boolean	Si se sincroniza el resultado de etiquetado automático de una tarea de etiquetado de equipo. Opciones: true: Sincroniza los resultados que se confirmarán a los miembros del equipo una vez finalizado el etiquetado automático. false: No sincronice los resultados de etiquetado automático. (Valor predeterminado)
synchronize_data	Boolean	Si se sincronizan los datos agregados de una tarea de etiquetado de equipo. Opciones: true: Sincroniza los archivos cargados, las fuentes de datos y los archivos importados sin etiquetar a los miembros del equipo. false: no sincronizar los datos agregados. (Valor predeterminado)
task_id	String	ID de una tarea de etiquetado.
task_name	String	Nombre de una tarea de etiquetado.
update_time	Long	Hora en la que se actualiza una tarea de etiquetado.
version_id	String	ID de versión del conjunto de datos asociado a una tarea de etiquetado.
workforce_stats	WorkforceStats object	Estadísticas sobre los miembros de la tarea de etiquetado del equipo.
workforces_config	WorkforcesConfig object	Información de tareas de etiquetado de equipo: Las tareas pueden ser asignadas por el administrador del equipo o un equipo especificado.

**Tabla 5** WorkforceSamplingTaskDesc
Parámetro	Tipo	Descripción
action	Integer	Acción después de la aceptación. Opciones: 0: Pasar todas las muestras cuando se complete la aceptación (incluidas las muestras de rechazo único) 1: Rechazar todas las muestras cuando se complete la aceptación (incluidas las muestras individuales aceptadas) 4: Pasar solo muestras aceptadas únicas y muestras no aceptadas. 5: Rechazar solo muestras de rechazo único y muestras no aceptadas.
checking_stats	CheckTaskStats object	Informe en tiempo real de las tareas de aceptación.
checking_task_id	String	ID de la tarea de aceptación actual.
overwrite_last_result	Boolean	Si se utiliza el resultado de aceptación para sobrescribir el resultado etiquetado si se ha etiquetado una muestra durante la aceptación. Opciones: true: Sobrescribir el resultado etiquetado. false: No sobrescribir el resultado etiquetado. (Valor predeterminado)
total_stats	CheckTaskStats object	Informe general de las tareas de aceptación históricas.

**Tabla 6** CheckTaskStats
Parámetro	Tipo	Descripción
accepted_sample_count	Integer	Muestras aceptadas.
checked_sample_count	Integer	Muestras comprobadas.
pass_rate	Double	Tasa de paso de las muestras.
rejected_sample_count	Integer	Muestras rechazadas.
sampled_sample_count	Integer	Número de muestras muestreadas.
sampling_num	Integer	Ejemplos de una tarea de aceptación.
sampling_rate	Double	Tasa de muestreo de una tarea de aceptación.
score	String	Puntuación de aceptación.
task_id	String	ID de una tarea de aceptación.
total_sample_count	Integer	Muestras totales.
total_score	Long	Puntuación total de aceptación.
unchecked_sample_count	Integer	Muestras no comprobadas.

**Tabla 7** LabelStats
Parámetro	Tipo	Descripción
attributes	Array of LabelAttribute objects	Atributo multidimensional de una etiqueta. Por ejemplo, si la etiqueta es música, se pueden incluir atributos como el estilo y el artista.
count	Integer	Número de etiquetas.
name	String	Nombre de la etiqueta.
property	LabelProperty object	Par clave-valor de atributo básico de una etiqueta, como el color y las teclas de método abreviado.
sample_count	Integer	Número de muestras que contienen la etiqueta.
type	Integer	Tipo de etiqueta. Opciones: 0: clasificación de imágenes 1: detección de objetos 3: segmentación de la imagen 100: Clasificación del texto 101: reconocimiento de entidad nombrada 102: Relación de trillizos de texto 103: Entidad triplete de texto 200: clasificación de sonido 201: Etiquetado de voz 202: Etiquetado de párrafo de discurso 600: etiquetado de vídeo

**Tabla 8** LabelAttribute
Parámetro	Tipo	Descripción
default_value	String	Valor predeterminado de un atributo de etiqueta.
id	String	ID de atributo de etiqueta.
name	String	Nombre del atributo de etiqueta.
type	String	Tipo de atributo de etiqueta. Opciones: text: texto select: lista desplegable de una sola opción
values	Array of LabelAttributeValue objects	Lista de valores de atributo de etiqueta.

**Tabla 9** LabelAttributeValue
Parámetro	Tipo	Descripción
id	String	ID de valor de atributo de etiqueta.
value	String	Valor del atributo de etiqueta.

**Tabla 10** LabelProperty
Parámetro	Tipo	Descripción
@modelarts:color	String	Atributo predeterminado: Color de etiqueta, que es un código hexadecimal del color. De forma predeterminada, este parámetro se deja en blanco. Ejemplo: #FFFFF0.
@modelarts:default_shape	String	Atributo predeterminado: forma predeterminada de una etiqueta de detección de objeto (atributo dedicado). De forma predeterminada, este parámetro se deja en blanco. Opciones: bndbox: rectángulo polygon: polígono circle: círculo line: línea recta dashed: línea de puntos point: punto polyline: polilínea
@modelarts:from_type	String	Atributo por defecto: Tipo de la entidad de cabecera en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete.
@modelarts:rename_to	String	Atributo predeterminado: el nuevo nombre de la etiqueta.
@modelarts:shortcut	String	Atributo predeterminado: Tecla de método abreviado de etiqueta. De forma predeterminada, este parámetro se deja en blanco. Por ejemplo: D.
@modelarts:to_type	String	Atributo por defecto: Tipo de la entidad de cola en la etiqueta de relación de triplete. Este atributo debe especificarse cuando se crea una etiqueta de relación. Este parámetro solo se utiliza para el conjunto de datos de texto triplete.

**Tabla 11** SearchCondition
Parámetro	Tipo	Descripción
coefficient	String	Filtrar por coeficiente de dificultad.
frame_in_video	Integer	Un cuadro en el vídeo.
hard	String	Si una muestra es una muestra dura. Opciones: 0: muestra no dura 1: muestra dura
import_origin	String	Filtrar por origen de datos.
kvp	String	Dosificación de CT, filtrada por dosificación.
label_list	SearchLabels object	Criterios de búsqueda de etiquetas.
labeler	String	Etiquetadora.
metadata	SearchProp object	Búsqueda por atributo de muestra.
parent_sample_id	String	ID de la muestra principal.
sample_dir	String	Directorio donde se almacenan muestras de datos (el directorio debe terminar con una barra diagonal (/)). Solo se buscan ejemplos en el directorio especificado. No se admite la búsqueda recursiva de directorios.
sample_name	String	Buscar por nombre de ejemplo, incluida la extensión del nombre de archivo.
sample_time	String	Cuando se agrega una muestra al conjunto de datos, se crea un índice basado en la última hora de modificación (exacta al día) de la muestra en OBS. Puede buscar la muestra en función de la hora. Opciones:- month: Búsqueda de muestras agregadas desde hace 30 días al día actual.- day: Búsqueda de muestras agregadas desde ayer (hace un día) al día actual.- yyyyMMdd-yyyyMMdd: Búsqueda de muestras agregadas en un período especificado (como máximo 30 días), en el formato de Start date-End date. Por ejemplo, 20190901-2019091501 indica que se buscan muestras generadas del 1 de septiembre al 15 de septiembre de 2019.
score	String	Búsqueda por confianza.
slice_thickness	String	Espesor de capa DICOM. Las muestras se filtran por el espesor de la capa.
study_date	String	Tiempo de escaneo DICOM.
time_in_video	String	Un punto de tiempo en el video.

**Tabla 12** SearchLabels
Parámetro	Tipo	Descripción
labels	Array of SearchLabel objects	Lista de criterios de búsqueda de etiquetas.
op	String	Si desea buscar varias etiquetas, debe especificarse op. Si busca solo una etiqueta, op puede dejarse en blanco. Opciones: OR: operación O AND: operación Y

**Tabla 13** SearchLabel
Parámetro	Tipo	Descripción
name	String	Nombre de la etiqueta.
op	String	Tipo de operación entre múltiples atributos. Opciones: OR: operación O AND: operación Y
property	Map<String,Array<String>>	El atributo de etiqueta que tiene el formato Object y almacena todos los pares clave-valor. key indica el nombre del atributo y value indica la lista de valores. Si value es null, la búsqueda no se realiza por valor. De lo contrario, el valor de búsqueda puede ser cualquier valor de la lista.
type	Integer	Tipo de etiqueta. Opciones: 0: clasificación de imágenes 1: detección de objetos 3: segmentación de la imagen 100: Clasificación del texto 101: reconocimiento de entidad nombrada 102: Relación de trillizos de texto 103: Entidad triplete de texto 200: clasificación de sonido 201: Etiquetado de voz 202: Etiquetado de párrafo de discurso 600: etiquetado de vídeo

**Tabla 14** SearchProp
Parámetro	Tipo	Descripción
op	String	Relación entre valores de atributo. Opciones: AND: relación Y OR: Relación O
props	Map<String,Array<String>>	Criterios de búsqueda de un atributo. Se pueden establecer varios criterios de búsqueda.

**Tabla 15** SampleStats
Parámetro	Tipo	Descripción
accepted_sample_count	Integer	Número de muestras aceptadas por el propietario.
auto_annotation_sample_count	Integer	Número de muestras a confirmar después del etiquetado inteligente.
deleted_sample_count	Integer	Número de muestras eliminadas.
rejected_sample_count	Integer	Número de muestras que no pasaron la aceptación del propietario.
sampled_sample_count	Integer	Número de muestras que deben ser aceptadas por el propietario y muestreadas.
total_sample_count	Integer	Número total de muestras.
unannotated_sample_count	Integer	Número de muestras sin marcar.
uncheck_sample_count	Integer	Número de muestras que han sido aprobadas por el revisor y deben ser aceptadas por el propietario.
unreviewed_sample_count	Integer	Número de muestras que han sido etiquetadas por el etiquetador pero que no han sido revisadas por el revisor.

**Tabla 16** WorkforceStats
Parámetro	Tipo	Descripción
labeler_count	Integer	Número de personas de etiquetado.
reviewer_count	Integer	Número de revisores.
workforce_count	Integer	Número de equipos.

**Tabla 17** WorkforcesConfig
Parámetro	Tipo	Descripción
agency	String	Administrador del equipo.
workforces	Array of WorkforceConfig objects	Lista de equipos que ejecutan tareas de etiquetado.

**Tabla 18** WorkforceConfig
Parámetro	Tipo	Descripción
workers	Array of Worker objects	Lista de miembros del equipo de etiquetado.
workforce_id	String	ID de un equipo de etiquetado.
workforce_name	String	Nombre de un equipo de etiquetado. El valor contiene de 0 a 1024 caracteres y no admite los siguientes caracteres especiales:!<>=&"'

**Tabla 19** Worker
Parámetro	Tipo	Descripción
create_time	Long	Tiempo de creación.
description	String	Descripción del miembro del equipo de etiquetado. El valor contiene de 0 a 256 caracteres y no admite los siguientes caracteres especiales: ^!<>=&"'
email	String	Dirección de correo electrónico de un miembro del equipo de etiquetado.
role	Integer	Rol. Opciones: 0: personal de etiquetado 1: revisor 2: administrador del equipo 3: propietario del conjunto de datos
status	Integer	Estado actual de inicio de sesión de un miembro del equipo de etiquetado. Opciones: 0: El correo electrónico de invitación no se ha enviado. 1: El correo electrónico de invitación se ha enviado pero el usuario no ha iniciado sesión. 2: El usuario ha iniciado sesión. 3: Se ha eliminado el miembro del equipo de etiquetado.
update_time	Long	Tiempo de actualización.
worker_id	String	ID de un miembro del equipo de etiquetado.
workforce_id	String	ID de un equipo de etiquetado.

Solicitudes de ejemplo

Consulta de la lista de tareas de etiquetado de equipos de un conjunto de datos

GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks

Ejemplo de respuestas

Código de estado: 200

{
  "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
  } ]
}