Consulta de detalles acerca de una tarea de etiquetado de equipo
Función
Esta API se utiliza para consultar los detalles sobre una tarea de etiquetado de equipo.
URI
GET /v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}
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. |
workforce_task_id |
Sí |
String |
ID de una tarea de etiquetado de equipo. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
label_stats |
No |
Boolean |
Si se devuelven las estadísticas de etiquetas. Opciones:
|
sample_stats |
No |
Boolean |
Si se devuelven las estadísticas de muestra. Opciones:
|
workforce_stats |
No |
Boolean |
Si se deben devolver las estadísticas de personal. Opciones:
|
Parámetros de solicitud
Ninguno
Parámetros de respuesta
Código de estado: 200
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:
|
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 |
Condiciones de búsqueda de muestra al crear tareas. |
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:
|
synchronize_data |
Boolean |
Si se sincronizan los datos agregados de una tarea de etiquetado de equipo. Opciones:
|
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. |
worker_stats |
Array of WorkerTask objects |
Estadísticas de progreso de etiquetado de miembros de la tarea de etiquetado de equipo. |
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. |
Parámetro |
Tipo |
Descripción |
---|---|---|
action |
Integer |
Acción después de la aceptación. Opciones:
|
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:
|
total_stats |
CheckTaskStats object |
Informe general de las tareas de aceptación históricas. |
Parámetro |
Tipo |
Descripción |
---|---|---|
accepted_sample_count |
Integer |
Muestras aceptadas. |
checked_sample_count |
Integer |
Muestras comprobadas. |
pass_rate |
Double |
Tasa de aprobación de las muestras. |
rejected_sample_count |
Integer |
Muestras rechazadas. |
sampled_sample_count |
Integer |
Número de muestras muestreadas. |
sampling_num |
Integer |
Muestras 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. |
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:
|
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:
|
values |
Array of LabelAttributeValue objects |
Lista de valores de atributo de etiqueta. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
ID de valor de atributo de etiqueta. |
value |
String |
Valor del atributo de etiqueta. |
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:
|
@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. |
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:
|
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. |
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:
|
Parámetro |
Tipo |
Descripción |
---|---|---|
name |
String |
Nombre de la etiqueta. |
op |
String |
Tipo de operación entre múltiples atributos. Opciones:
|
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:
|
Parámetro |
Tipo |
Descripción |
---|---|---|
op |
String |
Relación entre valores de atributo. Opciones:
|
props |
Map<String,Array<String>> |
Criterios de búsqueda de un atributo. Se pueden establecer varios criterios de búsqueda. |
Parámetro |
Tipo |
Descripción |
---|---|---|
accepted_sample_count |
Integer |
Número de muestras aceptadas por el owner. |
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 owner. |
sampled_sample_count |
Integer |
Número de muestras que deben ser aceptadas por el owner y muestreadas. |
total_sample_count |
Integer |
Número total de muestras. |
unannotated_sample_count |
Integer |
Número de muestras sin etiquetar. |
uncheck_sample_count |
Integer |
Número de muestras que han sido aprobadas por el revisor y deben ser aceptadas por el owner. |
unreviewed_sample_count |
Integer |
Número de muestras que han sido etiquetadas por el etiquetador pero que no han sido revisadas por el revisor. |
Parámetro |
Tipo |
Descripción |
---|---|---|
create_time |
Long |
Hora en que se crea la tarea de un miembro del equipo de etiquetado. |
dataset_id |
String |
ID de un conjunto de datos asociado a la tarea de un miembro del equipo de etiquetado. |
dataset_type |
Integer |
Tipo de etiquetado de la tarea de un miembro del equipo. |
|
String |
Dirección de correo electrónico de un miembro del equipo de etiquetado. |
email_status |
Integer |
Estado de notificación por correo electrónico de la tarea de etiquetado de un miembro del equipo de etiquetado. Opciones:
|
last_notify_time |
Long |
Marca de tiempo del último correo electrónico de notificación enviado a un miembro del equipo de etiquetado. |
pass_rate |
Double |
Tasa de aprobación de la revisión de aceptación de tareas para un miembro del equipo de etiquetado. |
role |
Integer |
Rol de un miembro del equipo de etiquetado. |
sample_stats |
SampleStats object |
Estadísticas de ejemplo de la tarea de un miembro del equipo de etiquetado. |
score |
Double |
Puntuación promedio de aceptación de las muestras de tareas de los miembros del equipo de etiquetado. |
task_id |
String |
ID de tarea de etiquetado de equipo asociado a la tarea de un miembro. |
task_status |
Integer |
Estado de la tarea de un miembro del equipo de etiquetado. Opciones:
|
update_time |
Long |
Hora en que se actualiza la tarea de un miembro del equipo de etiquetado. |
worker_id |
String |
ID de un miembro del equipo de etiquetado. |
workforce_task_name |
String |
Nombre de tarea de etiquetado de equipo asociado a la tarea de un miembro. |
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. |
Parámetro |
Tipo |
Descripción |
---|---|---|
agency |
String |
Administrador del equipo. |
workforces |
Array of WorkforceConfig objects |
Lista de equipos que ejecutan tareas de etiquetado. |
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:!<>=&"' |
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: ^!<>=&"' |
|
String |
Dirección de correo electrónico de un miembro del equipo de etiquetado. |
role |
Integer |
Rol. Opciones:
|
status |
Integer |
Estado actual de inicio de sesión de un miembro del equipo de etiquetado. Opciones:
|
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 detalles acerca de una tarea de etiquetado de equipo
GET https://{endpoint}/v2/{project_id}/datasets/{dataset_id}/workforce-tasks/{workforce_task_id}
Ejemplo de respuestas
Código de estado: 200
OK
{ "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", "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, "worker_stats" : [ { "email" : "xxx@xxx.com", "worker_id" : "afdda13895bc66322ffbf36ae833bcf0", "role" : 0, "task_id" : "iYZx7gScPUozOXner9k", "workforce_task_name" : "task-e63f", "dataset_id" : "WxCREuCkBSAlQr9xrde", "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 }, "create_time" : 1606184400278, "update_time" : 1606184795050, "email_status" : 3, "last_notify_time" : 0 } ] }
Códigos de estado
Código de estado |
Descripción |
---|---|
200 |
OK |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
Códigos de error
Consulte Códigos de error.