Inicio de tareas inteligentes
Función
Esta API se utiliza para iniciar una tarea inteligente, que puede ser una tarea de etiquetado automático, una tarea de implementación de modelo con un clic o una tarea de agrupación automática. Puede especificar task_type en el cuerpo de la solicitud para iniciar un tipo de tareas. Los conjuntos de datos cuya ruta de datos o ruta de trabajo es una ruta OBS en un KMS cifrado bucket soporte de pre-etiquetado y un solo clic de la implementación del modelo, pero no admite el aprendizaje activo y la agrupación automática.- Auto labeling: Aprendizaje y formación se realizan en función de las etiquetas seleccionadas y se selecciona un modelo existente para etiquetar rápidamente las imágenes restantes. El etiquetado automático incluye aprendizaje activo y pre-etiquetado. Active learning: El sistema utiliza aprendizaje semisupervisado y filtrado de ejemplos duros para realizar el etiquetado automático, reduciendo la carga de trabajo de etiquetado manual y ayudándole a encontrar ejemplos difíciles. Pre-labeling: Seleccione un modelo que se muestra en la página Model Management para el etiquetado automático.- One-click model deployment: Utilice esta función para crear trabajos de formación para un conjunto de datos etiquetados, importar un modelo, y desplegar el modelo como un servicio en tiempo real todo en un solo paso.- Auto grouping: Las imágenes sin etiqueta se agrupan utilizando un algoritmo de clustering y luego se procesan en función del resultado de clustering. Las imágenes se pueden etiquetar o limpiar por grupo.
URI
POST /v2/{project_id}/datasets/{dataset_id}/tasks
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. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
collect_key_sample |
No |
Boolean |
Si recoger muestras clave. Opciones:
|
config |
No |
SmartTaskConfig object |
Configuración de tareas. |
model_id |
No |
String |
ID de modelo. |
task_type |
No |
String |
Tipo de tarea. Opciones:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
algorithm_type |
No |
String |
Tipo de algoritmo para etiquetado automático. Opciones:
|
ambiguity |
No |
Boolean |
Si se realiza la agrupación basada en el grado de desenfoque de la imagen. |
annotation_output |
No |
String |
Ruta de salida del resultado de etiquetado de aprendizaje activo. |
collect_rule |
No |
String |
Regla de recopilación de muestra. El valor predeterminado es all, lo que indica la colección completa. Actualmente, solo el valor all está disponible. |
collect_sample |
No |
Boolean |
Si habilitar la recopilación de muestras. Opciones:
|
confidence_scope |
No |
String |
Rango de confianza de muestras clave. Los valores mínimo y máximo están separados por guiones (-). Ejemplo: 0.10-0.90. |
description |
No |
String |
Descripción de la tarea. |
engine_name |
No |
String |
Nombre del motor. |
export_format |
No |
Integer |
Formato del directorio exportado. Opciones:
|
export_params |
No |
ExportParams object |
Parámetros de una tarea de exportación de conjunto de datos. |
flavor |
No |
Flavor object |
Variante de recursos de entrenamiento. |
image_brightness |
No |
Boolean |
Si se realiza la agrupación basada en el brillo de la imagen. |
image_colorfulness |
No |
Boolean |
Si se debe realizar la agrupación basada en el color de la imagen. |
inf_cluster_id |
No |
String |
ID de un clúster dedicado. Este parámetro se deja en blanco de forma predeterminada, lo que indica que no se utiliza un clúster dedicado. Cuando utilice el clúster dedicado para implementar servicios, asegúrese de que el estado del clúster sea normal. Después de establecer este parámetro, se utiliza la configuración de red del clúster y el parámetro vpc_id no tiene efecto. |
inf_config_list |
No |
Array of InfConfig objects |
Lista de configuración necesaria para ejecutar una tarea de inferencia, que es opcional y se deja en blanco de forma predeterminada. |
inf_output |
No |
String |
Ruta de salida de la inferencia en el aprendizaje activo. |
infer_result_output_dir |
No |
String |
Directorio OBS para almacenar resultados de predicción de muestra. Este parámetro es opcional. El subdirectorio {service_id}-infer-result en el directorio output_dir se utiliza de forma predeterminada. |
key_sample_output |
No |
String |
Ruta de salida de ejemplos duros en el aprendizaje activo. |
log_url |
No |
String |
OBS URL de los registros de un trabajo de entrenamiento. De forma predeterminada, este parámetro se deja en blanco. |
manifest_path |
No |
String |
Ruta del archivo de manifest, que se utiliza como entrada para el entrenamiento y la inferencia. |
model_id |
No |
String |
ID de modelo. |
model_name |
No |
String |
Nombre del modelo. |
model_parameter |
No |
String |
Parámetro del modelo. |
model_version |
No |
String |
Versión modelo. |
n_clusters |
No |
Integer |
Número de clústeres. |
name |
No |
String |
Nombre de la tarea. |
output_dir |
No |
String |
Ruta de salida de muestra. El formato es el siguiente: Dataset output path/Dataset name-Dataset ID/annotation/auto-deploy/. Ejemplo: /test/work_1608083108676/dataset123-g6IO9qSu6hoxwCAirfm/annotation/auto-deploy/. |
parameters |
No |
Array of TrainingParameter objects |
Parámetros de tiempo de ejecución de un trabajo de entrenamiento |
pool_id |
No |
String |
ID de un grupo de recursos. |
property |
No |
String |
Nombre del atributo. |
req_uri |
No |
String |
Ruta de inferencia de un trabajo por lotes. |
result_type |
No |
Integer |
Modo de procesamiento de resultados de agrupación automática. Opciones:
|
samples |
No |
Array of SampleLabels objects |
Lista de información de etiquetado para las muestras que deben etiquetarse automáticamente. |
stop_time |
No |
Integer |
Intervalo de tiempo de espera, en minutos. El valor predeterminado es 15 minutos. Este parámetro solo se utiliza en el escenario de etiquetado automático de vídeos. |
time |
No |
String |
Marca de tiempo en el aprendizaje activo. |
train_data_path |
No |
String |
Ruta para almacenar conjuntos de datos de entrenamiento existentes. |
train_url |
No |
String |
URL de la ruta OBS donde se genera el archivo de un trabajo de entrenamiento. De forma predeterminada, este parámetro se deja en blanco. |
version_format |
No |
String |
Formato de una versión de conjunto de datos. Opciones:
|
worker_server_num |
No |
Integer |
Número de workers en un trabajo de entrenamiento. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
clear_hard_property |
No |
Boolean |
Si se deben borrar los atributos de ejemplo duro. Opciones:
|
export_dataset_version_format |
No |
String |
Formato de la versión del conjunto de datos a la que se exportan los datos. |
export_dataset_version_name |
No |
String |
Nombre de la versión del conjunto de datos a la que se exportan los datos. |
export_dest |
No |
String |
Destino de exportación. Opciones:
|
export_new_dataset_name |
No |
String |
Nombre del nuevo conjunto de datos al que se exportan los datos. |
export_new_dataset_work_path |
No |
String |
Directorio de trabajo del nuevo conjunto de datos al que se exportan los datos. |
ratio_sample_usage |
No |
Boolean |
Si se asigna aleatoriamente el conjunto de entrenamiento y el conjunto de validación en función de la relación especificada. Opciones:
|
sample_state |
No |
String |
Estado de la muestra. Opciones:
|
samples |
No |
Array of strings |
Lista de ID de muestras exportadas. |
search_conditions |
No |
Array of SearchCondition objects |
Condiciones de búsqueda exportadas. La relación entre múltiples condiciones de búsqueda es O. |
train_sample_ratio |
No |
String |
Relación de división entre el conjunto de entrenamiento y el conjunto de verificación durante la liberación de la versión especificada. El valor predeterminado es 1.00, lo que indica que todas las versiones publicadas son conjuntos de entrenamiento. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
coefficient |
No |
String |
Filtrar por coeficiente de dificultad. |
frame_in_video |
No |
Integer |
Un cuadro en el vídeo. |
hard |
No |
String |
Si una muestra es una muestra dura. Opciones:
|
import_origin |
No |
String |
Filtrar por origen de datos. |
kvp |
No |
String |
Dosificación de CT, filtrada por dosificación. |
label_list |
No |
SearchLabels object |
Criterios de búsqueda de etiquetas. |
labeler |
No |
String |
Etiquetadora. |
metadata |
No |
SearchProp object |
Búsqueda por atributo de muestra. |
parent_sample_id |
No |
String |
ID de la muestra principal. |
sample_dir |
No |
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 |
No |
String |
Buscar por nombre de ejemplo, incluida la extensión del nombre de archivo. |
sample_time |
No |
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 |
No |
String |
Búsqueda por confianza. |
slice_thickness |
No |
String |
Espesor de capa DICOM. Las muestras se filtran por el espesor de la capa. |
study_date |
No |
String |
Tiempo de escaneo DICOM. |
time_in_video |
No |
String |
Un punto de tiempo en el video. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
labels |
No |
Array of SearchLabel objects |
Lista de criterios de búsqueda de etiquetas. |
op |
No |
String |
Si desea buscar varias etiquetas, debe especificarse op. Si busca solo una etiqueta, op puede dejarse en blanco. Opciones:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
No |
String |
Nombre de la etiqueta. |
op |
No |
String |
Tipo de operación entre múltiples atributos. Opciones:
|
property |
No |
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 |
No |
Integer |
Tipo de etiqueta. Opciones:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
op |
No |
String |
Relación entre valores de atributo. Opciones:
|
props |
No |
Map<String,Array<String>> |
Criterios de búsqueda de un atributo. Se pueden establecer varios criterios de búsqueda. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
code |
No |
String |
Código de atributo de una especificación de recurso, que se utiliza para la creación de tareas. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
envs |
No |
Map<String,String> |
(Opcional) Par clave-valor de variable de entorno requerido para ejecutar un modelo. De forma predeterminada, este parámetro se deja en blanco. Para garantizar la seguridad de los datos, no introduzca información confidencial, como contraseñas de texto sin formato, en las variables de entorno. |
instance_count |
No |
Integer |
Número de instancia de implementación del modelo, es decir, el número de nodos informáticos. |
model_id |
No |
String |
ID de modelo. |
specification |
No |
String |
Especificaciones de recursos de los servicios en tiempo real. Para obtener más información, consulte Implementación de servicios. |
weight |
No |
Integer |
Peso de tráfico asignado a un modelo. Este parámetro es obligatorio solo cuando infer_type se establece en real-time. La suma de los pesos debe ser 100. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
label |
No |
String |
Nombre del parámetro. |
value |
No |
String |
Valor del parámetro. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
labels |
No |
Array of SampleLabel objects |
Lista de etiquetas de muestra. Si este parámetro se deja en blanco, se eliminan todas las etiquetas de ejemplo. |
metadata |
No |
SampleMetadata object |
Par clave-valor del atributo de muestra metadata. |
sample_id |
No |
String |
ID de muestra. |
sample_type |
No |
Integer |
Tipo de muestra. Opciones:
|
sample_usage |
No |
String |
Uso de la muestra. Opciones:
|
source |
No |
String |
Dirección de origen de los datos de muestra. |
worker_id |
No |
String |
ID de un miembro del equipo de etiquetado. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
annotated_by |
No |
String |
Método de etiquetado de vídeo, que se utiliza para distinguir si un vídeo se etiqueta manualmente o automáticamente. Opciones:
|
id |
No |
String |
ID de la etiqueta. |
name |
No |
String |
Nombre de la etiqueta. |
property |
No |
SampleLabelProperty object |
Par de atributo clave-valor de la etiqueta de ejemplo, como la forma del objeto y características de forma. |
score |
No |
Float |
Confianza. |
type |
No |
Integer |
Tipo de etiqueta. Opciones:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
@modelarts:content |
No |
String |
Contenido de texto de voz, que es un atributo predeterminado dedicado a la etiqueta de voz . (incluido el contenido del habla y los puntos de inicio y final del habla). |
@modelarts:end_index |
No |
Integer |
Posición final del texto, que es un atributo predeterminado dedicado a la etiqueta de entidad con nombre. La posición final no incluye el carácter correspondiente al valor de end_index. Los ejemplos son los siguientes.- Si el contenido del texto es "Barack Hussein Obama II (born August 4, 1961) is an American attorney and politician.", los valores start_index y end_index de "Barack Hussein Obama II" son 0 y 23, respectivamente.- Si el contenido del texto es "By the end of 2018, the company has more than 100 employees.", los valores start_index y end_index de "By the end of 2018" son 0 y 18, respectivamente. |
@modelarts:end_time |
No |
String |
Tiempo de finalización de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz, en el formato de hh:mm:ss.SSS. (hh indica la hora; mm indica el minuto; ss indica el segundo; y SSS indica el milisegundo.) |
@modelarts:feature |
No |
Object |
Característica de forma, que es un atributo predeterminado dedicado a la etiqueta de detección de objetos, con tipo de List. La esquina superior izquierda de una imagen se utiliza como el origen de coordenadas [0,0]. Cada punto de coordenada está representado por [x, y]. x indica la coordenada horizontal e y indica la coordenada vertical . (tanto x como y son mayores o iguales a 0). El formato de cada forma es el siguiente: - bndbox: consta de dos puntos, por ejemplo, [[0,10],[50,95]]. El primer punto se encuentra en la esquina superior izquierda del rectángulo y el segundo punto se encuentra en la esquina inferior derecha del rectángulo. Es decir, la coordenada X del primer punto debe ser menor que la del segundo punto, y la coordenada Y del segundo punto debe ser menor que la del primer punto.- polygon: consiste en múltiples puntos que están conectados en secuencia para formar un polígono, por ejemplo, [[0,100],[50,95],[10,60],[500,400]].- circle: consiste en el punto central y el radio, por ejemplo, [[100,100],[50]].- line: consta de dos puntos, por ejemplo, [[0,100],[50,95]]. El primer punto es el punto de inicio, y el segundo punto es el punto final.- dashed: consta de dos puntos, por ejemplo, [[0,100],[50,95]]. El primer punto es el punto inicial, y el segundo punto es el punto final.- point: consiste en un punto, por ejemplo, [[0,100]].- polyline: consiste en múltiples puntos, por ejemplo, [[0,100],[50,95],[10,60],[500,400]]. |
@modelarts:from |
No |
String |
ID de la entidad de cabeza en la etiqueta de relación de triplete, que es un atributo por defecto dedicado a la etiqueta de relación de triplete. |
@modelarts:hard |
No |
String |
Muestra etiquetada como muestra dura o no, que es un atributo predeterminado. Opciones:
|
@modelarts:hard_coefficient |
No |
String |
Coeficiente de dificultad de cada nivel de etiqueta, que es un atributo predeterminado. El rango de valores es [0,1]. |
@modelarts:hard_reasons |
No |
String |
Razones por las que la muestra es una muestra dura, que es un atributo predeterminado. Utilice un guion (-) para separar cada dos ID de motivos de muestra dura, por ejemplo, 3-20-21-19. Opciones:
|
@modelarts:shape |
No |
String |
Forma de objeto, que es un atributo predeterminado dedicado a la etiqueta de detección de objetos y se deja vacía de forma predeterminada. Opciones:
|
@modelarts:source |
No |
String |
Fuente de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz y que puede ajustarse a un altavoz o narrador. |
@modelarts:start_index |
No |
Integer |
Posición inicial del texto, que es un atributo predeterminado dedicado a la etiqueta de entidad con nombre. El valor inicial comienza desde 0, incluyendo el carácter correspondiente al valor de start_index. |
@modelarts:start_time |
No |
String |
Tiempo de inicio de voz, que es un atributo por defecto dedicado a la etiqueta de punto de inicio/fin de voz, en el formato de hh:mm:ss.SSS. (hh indica la hora; mm indica el minuto; ss indica el segundo; y SSS indica el milisegundo.) |
@modelarts:to |
No |
String |
ID de la entidad de cola en la etiqueta de relación de triplete, que es un atributo por defecto dedicado a la etiqueta de relación de triplete. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
@modelarts:import_origin |
No |
Integer |
Fuente de ejemplo, que es un atributo integrado. |
@modelarts:hard |
No |
Double |
Si la muestra está etiquetada como muestra dura, que es un atributo predeterminado. Opciones:
|
@modelarts:hard_coefficient |
No |
Double |
Coeficiente de dificultad de cada nivel de muestra, que es un atributo predeterminado. El rango de valores es [0,1]. |
@modelarts:hard_reasons |
No |
Array of integers |
ID de una razón de ejemplo difícil, que es un atributo predeterminado. Opciones:
|
@modelarts:size |
No |
Array of objects |
Tamaño de la imagen (ancho, alto y profundidad de la imagen), que es un atributo predeterminado, con tipo de List. En la lista, el primer número indica la anchura (píxeles), el segundo número indica la altura (píxeles) y el tercer número indica la profundidad . (la profundidad puede dejarse en blanco y el valor predeterminado es 3). Por ejemplo, [100,200,3] y [100,200] son válidos. Nota: Este parámetro sólo es obligatorio cuando la lista de etiquetas de ejemplo contiene la etiqueta de detección de objetos. |
Parámetros de respuesta
Código de estado: 200
Parámetro |
Tipo |
Descripción |
---|---|---|
task_id |
String |
ID de tarea. |
Solicitudes de ejemplo
- Inicio de una tarea de etiquetado automático (aprendizaje activo)
{ "task_type" : "auto-label", "collect_key_sample" : true, "config" : { "algorithm_type" : "fast" } }
- Inicio de una tarea de etiquetado automático (preetiquetado)
{ "task_type" : "pre-label", "model_id" : "c4989033-7584-44ee-a180-1c476b810e46", "collect_key_sample" : true, "config" : { "inf_config_list" : [ { "specification" : "modelarts.vm.cpu.2u", "instance_count" : 1 } ] } }
- Inicio de una tarea de agrupación automática
{ "task_type" : "auto-grouping", "config" : { "n_clusters" : "2", "ambiguity" : false, "image_brightness" : false, "image_colorfulness" : false, "property" : "size", "result_type" : 1 } }
Ejemplo de respuestas
Código de estado: 200
OK
{ "task_id" : "r0jT2zwxBDKf8KEnSuZ" }
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.