As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Arquivo de configuração de categorias de rotulagem com referência de atributos de categorias e quadros de rótulo
Ao criar um trabalho de rotulagem de nuvem de pontos 3D ou quadro de vídeo usando a operação de SageMaker API da Amazon`CreateLabelingJob`, você usa um arquivo de configuração de categoria de etiqueta para especificar suas etiquetas e instruções de trabalho. Opcionalmente, você pode fornecer o seguinte em seu arquivo de atributo de categoria de rótulo:
+ Você pode fornecer *atributos de categoria de rótulo* para quadros de vídeo e rastreamento de objetos de nuvem de pontos 3D e tipos de tarefas de detecção de objetos. Os operadores podem usar um ou mais atributos para fornecer mais informações sobre esse objeto. Por exemplo, você pode querer usar o atributo *obstruído* para que os operadores identifiquem quando um objeto está parcialmente obstruído. É possível especificar um atributo de categoria de rótulo para um único rótulo usando o parâmetro `categoryAttributes` ou para todos os rótulos que usam o parâmetro `categoryGlobalAttributes`.
+ Você pode fornecer *atributos de quadro* para de rótulo para rastreamento de objetos quadros de vídeo de nuvem de pontos 3D e tipos de tarefas de detecção de objetos usando `frameAttributes`. Quando você cria um atributo de quadro, ele aparece em cada quadro ou nuvem de pontos na tarefa do operador. Em trabalhos de rotulagem de quadros de vídeo, esses são atributos que os operadores atribuem a um quadro de vídeo inteiro. Para trabalhos de rotulagem de nuvem de pontos 3D, esses atributos são aplicados a uma única nuvem de pontos. Use atributos de quadro para que os operadores forneçam mais informações sobre a cena em um quadro específico ou nuvem de pontos.
+ Para trabalhos de rotulagem de quadros de vídeo, você usa o arquivo de configuração da categoria de rótulo para especificar o tipo de tarefa (caixa delimitadora, linha poligonal, polígono ou ponto-chave) enviada aos operadores.
Para operadores, especificar valores para atributos de categoria de rótulo e atributos de quadro será opcional.
**Importante**
Você só deverá fornecer um nome de atributo de rótulo em `auditLabelAttributeName` se estiver executando um trabalho de auditoria para verificar ou ajustar rótulos. Use esse parâmetro para inserir o [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)usado no trabalho de etiquetagem que gerou as anotações que você deseja que seu trabalhador ajuste. Quando você cria um trabalho de rotulagem no console, se você não especificou um nome de atributo de rótulo, o **nome** do seu trabalho é usado como LabelAttributeName o.
Os tópicos a seguir mostram exemplos de um arquivo de configuração de categoria de rótulo para diferentes tipos de trabalhos de rotulagem. Eles também explicam o esquema e as cotas de um arquivo de configuração de categoria.
**Topics**
+ [Exemplos: arquivos de configuração de categoria de rótulo para trabalhos de rotulagem de nuvem de pontos 3D](#sms-label-cat-config-attributes-3d-pc)
+ [Exemplo: arquivos de configuração de categoria de rótulos para trabalhos de rotulagem de quadros de vídeo](#sms-label-cat-config-attributes-vid-frame)
+ [Esquema do arquivo de configuração da categoria de rótulos](#sms-label-cat-config-attributes-schema)
+ [Cotas de rótulo e de atributo da categoria de rótulo](#sms-point-cloud-label-cat-limits)
## Exemplos: arquivos de configuração de categoria de rótulo para trabalhos de rotulagem de nuvem de pontos 3D
Os seguintes tópicos evidenciam exemplos de arquivos de configuração de categorias de rótulos de nuvem de pontos 3D para trabalhos de rotulagem de detecção de objetos, rastreamento de objetos, segmentação semântica, ajuste e verificação:
**Topics**
+ [Exemplo: rastreamento de objetos de nuvem de pontos 3D e detecção de objetos](#example-3d-point-cloud-object)
+ [Exemplo: Segmentação semântica da nuvem de pontos 3D](#example-3d-point-cloud-semantic)
+ [Exemplo: ajuste da nuvem de pontos 3D](#example-3d-point-cloud-adjustment)
+ [Exemplo: verificação da nuvem de pontos 3D](#example-3d-point-cloud-verification)
### Exemplo: rastreamento de objetos de nuvem de pontos 3D e detecção de objetos
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo que inclui atributos de categoria de rótulo para uma tarefa de detecção de objetos de nuvem de pontos 3D ou de rotulagem de rastreamento de objetos. Este exemplo inclui dois atributos de quadro, que serão adicionados a todas as nuvens de pontos enviadas ao trabalho de rotulagem. O rótulo `Car` incluirá quatro atributos de categoria de rótulo - `X`,`Y`,`Z` e o atributo global, `W`.
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"{{count players}}",
"description":"{{How many players to you see in the scene?}}",
"type":"{{number}}"
},
{
"name":"{{select one}}",
"description":"{{describe the scene}}",
"type":"{{string}}",
"enum":["{{clear}}","{{blurry}}"],
"isRequired":{{true}}
},
],
"categoryGlobalAttributes": [
{
"name":"{{W}}",
"description":"{{label-attributes-for-all-labels}}",
"type":"{{string}}",
"enum": ["{{foo}}", "{{buzz}}", "{{biz}}"]
}
],
"labels": [
{
"label": "{{Car}}",
"categoryAttributes": [
{
"name":"{{X}}",
"description":"{{enter a number}}",
"type":"{{number}}",
},
{
"name":"{{Y}}",
"description":"{{select an option}}",
"type":"{{string}}",
"enum":["{{y1}}", "{{y2}}"]
},
{
"name":"{{Z}}",
"description":"{{submit a free-form response}}",
"type":"{{string}}",
}
]
},
{
"label": "Pedestrian",
"categoryAttributes": [{{...}}]
}
],
"instructions": {"shortInstruction":"{{Draw a tight Cuboid}}", "fullInstruction":"{{}}"}
}
```
### Exemplo: Segmentação semântica da nuvem de pontos 3D
Veja a seguir um exemplo um arquivo de configuração de categoria de rótulo para um trabalho de rotulagem de segmentação semântica de nuvem de pontos 3D.
Os atributos da categoria de rótulo não são compatíveis para tipos de tarefas de segmentação semântica de nuvem de pontos 3D. Os atributos do quadro são compatíveis. Se você fornecer atributos da categoria de rótulo para um trabalho de rotulagem de segmentação semântica, eles serão ignorados.
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"{{count players}}",
"description":"{{How many players to you see in the scene?}}",
"type":"{{number}}"
},
{
"name":"{{select one}}",
"description":"{{describe the scene}}",
"type":"{{string}}",
"enum":["{{clear}}","{{blurry}}"]
},
],
"labels": [
{
"label": "Car",
},
{
"label": "Pedestrian",
},
{
"label": "Cyclist",
}
],
"instructions": {"shortInstruction":"Select the appropriate label and paint all objects in the point cloud that it applies to the same color", "fullInstruction":""}
}
```
### Exemplo: ajuste da nuvem de pontos 3D
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo para uma tarefa de rotulagem de detecção de objetos em nuvem de pontos 3D ou ajuste de rastreamento de objetos. Não há compatibilidade com trabalhos de rotulagem de segmentação semântica de nuvem de pontos 3D `categoryGlobalAttributes` e `categoryAttributes`.
Você deve incluir `auditLabelAttributeName` para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de ajuste. Opcionalmente, você pode usar o parâmetro `editsAllowed` para especificar se um atributo de rótulo ou quadro pode ou não ser editado.
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"{{count players}}",
"description":"{{How many players to you see in the scene?}}",
"type":"{{number}}"
},
{
"name":"{{select one}}",
"editsAllowed":"{{none}}",
"description":"{{describe the scene}}",
"type":"{{string}}",
"enum":["{{clear}}","{{blurry}}"]
},
],
"categoryGlobalAttributes": [
{
"name":"{{W}}",
"editsAllowed":"{{any}}",
"description":"{{label-attributes-for-all-labels}}",
"type":"{{string}}",
"enum": ["{{foo}}", "{{buzz}}", "{{biz}}"]
}
],
"labels": [
{
"label": "{{Car}}",
"editsAllowed":"{{any}}",
"categoryAttributes": [
{
"name":"{{X}}",
"description":"{{enter a number}}",
"type":"{{number}}"
},
{
"name":"{{Y}}",
"description":"{{select an option}}",
"type":"{{string}}",
"enum":["{{y1}}", "{{y2}}"],
"editsAllowed":"{{any}}"
},
{
"name":"{{Z}}",
"description":"{{submit a free-form response}}",
"type":"{{string}}",
"editsAllowed":"{{none}}"
}
]
},
{
"label": "Pedestrian",
"categoryAttributes": [{{...}}]
}
],
"instructions": {"shortInstruction":"{{Draw a tight Cuboid}}", "fullInstruction":"{{}}"},
// include auditLabelAttributeName for label adjustment jobs
"auditLabelAttributeName": "{{myPrevJobLabelAttributeName}}"
}
```
### Exemplo: verificação da nuvem de pontos 3D
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo que você pode usar para um trabalho de identificação de detecção de objetos em nuvem de pontos 3D ou verificação de rastreamento de objetos. Não há compatibilidade com trabalhos de rotulagem de verificação de segmentação semântica de nuvem de pontos 3D `categoryGlobalAttributes` e `categoryAttributes`.
Você deve incluir `auditLabelAttributeName` para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de verificação. Além disso, você deve usar o parâmetro `editsAllowed` para especificar que nenhum rótulo pode ser editado.
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"{{count players}}",
"editsAllowed":"{{any}}",
"description":"{{How many players to you see in the scene?}}",
"type":"{{number}}"
},
{
"name":"{{select one}}",
"editsAllowed":"{{any}}",
"description":"{{describe the scene}}",
"type":"{{string}}",
"enum":["{{clear}}","{{blurry}}"]
},
],
"categoryGlobalAttributes": [
{
"name":"{{W}}",
"editsAllowed":"{{none}}",
"description":"{{label-attributes-for-all-labels}}",
"type":"{{string}}",
"enum": ["{{foo}}", "{{buzz}}", "{{biz}}"]
}
],
"labels": [
{
"label": "{{Car}}",
"editsAllowed":"{{none}}",
"categoryAttributes": [
{
"name":"{{X}}",
"description":"{{enter a number}}",
"type":"{{number}}",
"editsAllowed":"{{none}}"
},
{
"name":"{{Y}}",
"description":"{{select an option}}",
"type":"{{string}}",
"enum":["{{y1}}", "{{y2}}"],
"editsAllowed":"{{any}}"
},
{
"name":"{{Z}}",
"description":"{{submit a free-form response}}",
"type":"{{string}}",
"editsAllowed":"{{none}}"
}
]
},
{
"label": "Pedestrian",
"editsAllowed":"{{none}}",
"categoryAttributes": [{{...}}]
}
],
"instructions": {"shortInstruction":"{{Draw a tight Cuboid}}", "fullInstruction":"{{}}"},
// include auditLabelAttributeName for label verification jobs
"auditLabelAttributeName": "{{myPrevJobLabelAttributeName}}"
}
```
## Exemplo: arquivos de configuração de categoria de rótulos para trabalhos de rotulagem de quadros de vídeo
As ferramentas de anotação disponíveis para seu operador e o tipo de tarefa usado dependem do valor que você especifica para `annotationType`. Por exemplo, se você quiser que os operadores usem pontos-chave para rastrear alterações na pose de objetos específicos em vários quadros, você especificaria `Keypoint` para `annotationType`. Se você não especificar um tipo de anotação, `BoundingBox` será usado por padrão.
Os tópicos a seguir evidenciam exemplos de arquivos de configuração da categoria de quadros de vídeo.
**Topics**
+ [Exemplo: ponto-chave de quadros de vídeo](#example-video-frame-keypoint)
+ [Exemplo: ajuste do quadro de vídeo](#example-video-frame-adjustment)
+ [Exemplo: verificação de quadros de vídeo](#example-video-frame-verification)
### Exemplo: ponto-chave de quadros de vídeo
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo de ponto-chave de quadro de vídeo com atributos de categoria de rótulo. Este exemplo inclui dois atributos de quadro, que serão adicionados a todos os quadros enviados ao trabalho de rotulagem. O rótulo `Car` incluirá quatro atributos de categoria de rótulo - `X`, `Y`, `Z` e o atributo global, `W`.
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"{{count players}}",
"description":"{{How many players to you see in the scene?}}",
"type":"{{number}}"
},
{
"name":"{{select one}}",
"description":"{{describe the scene}}",
"type":"{{string}}",
"enum":["{{clear}}","{{blurry}}"]
},
],
"categoryGlobalAttributes": [
{
"name":"{{W}}",
"description":"{{label-attributes-for-all-labels}}",
"type":"{{string}}",
"enum": ["{{foo}}", "{{buz}}", "{{buz2}}"]
}
],
"labels": [
{
"label": "{{Car}}",
"categoryAttributes": [
{
"name":"{{X}}",
"description":"{{enter a number}}",
"type":"{{number}}",
},
{
"name":"{{Y}}",
"description":"{{select an option}}",
"type":"{{string}}",
"enum": ["{{y1}}", "{{y2}}"]
},
{
"name":"{{Z}}",
"description":"{{submit a free-form response}}",
"type":"{{string}}",
}
]
},
{
"label": "Pedestrian",
"categoryAttributes": [{{...}}]
}
],
"annotationType":"{{Keypoint}}",
"instructions": {"shortInstruction":"{{add example short instructions here}}", "fullInstruction":"{{}}"}
}
```
### Exemplo: ajuste do quadro de vídeo
A seguir está um exemplo de um arquivo de configuração de categoria de rótulo que você pode usar para um trabalho de rotulagem de ajuste de quadro de vídeo.
Você deve incluir `auditLabelAttributeName` para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de verificação. Opcionalmente, você pode usar o parâmetro `editsAllowed` para especificar se rótulos, atributos de categoria e rótulo ou atributos de quadro podem ou não ser editados.
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"{{count players}}",
"editsAllowed":"{{none}}",
"description":"{{How many players to you see in the scene?}}",
"type":"{{number}}"
},
{
"name":"{{select one}}",
"description":"{{describe the scene}}",
"type":"{{string}}",
"enum":["{{clear}}","{{blurry}}"]
},
],
"categoryGlobalAttributes": [
{
"name":"{{W}}",
"editsAllowed":"{{any}}",
"description":"{{label-attributes-for-all-labels}}",
"type":"{{string}}",
"enum": ["{{foo}}", "{{buz}}", "{{buz2}}"]
}
],
"labels": [
{
"label": "{{Car}}",
"editsAllowed":"{{any}}",
"categoryAttributes": [
{
"name":"{{X}}",
"description":"{{enter a number}}",
"type":"{{number}}",
"editsAllowed":"{{any}}"
},
{
"name":"{{Y}}",
"description":"{{select an option}}",
"type":"{{string}}",
"enum": ["{{y1}}", "{{y2}}"],
"editsAllowed":"{{any}}"
},
{
"name":"{{Z}}",
"description":"{{submit a free-form response}}",
"type":"{{string}}",
"editsAllowed":"{{none}}"
}
]
},
{
"label": "Pedestrian",
"editsAllowed":"{{none}}",
"categoryAttributes": [{{...}}]
}
],
"annotationType":"{{Keypoint}}",
"instructions": {"shortInstruction":"{{add example short instructions here}}", "fullInstruction":"{{}}"},
// include auditLabelAttributeName for label adjustment jobs
"auditLabelAttributeName": "{{myPrevJobLabelAttributeName}}"
}
```
### Exemplo: verificação de quadros de vídeo
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo para um trabalho de rotulagem de quadros de vídeo.
Você deve incluir `auditLabelAttributeName` para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de verificação. Além disso, você deve usar o parâmetro `editsAllowed` para especificar que nenhum rótulo pode ser editado.
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"{{count players}}",
"editsAllowed":"{{none}}",
"description":"{{How many players to you see in the scene?}}",
"type":"{{number}}"
},
{
"name":"{{select one}}",
"editsAllowed":"{{any}}",
"description":"{{describe the scene}}",
"type":"{{string}}",
"enum":["{{clear}}","{{blurry}}"]
},
],
"categoryGlobalAttributes": [
{
"name":"{{W}}",
"editsAllowed":"{{none}}",
"description":"{{label-attributes-for-all-labels}}",
"type":"{{string}}",
"enum": ["{{foo}}", "{{buz}}", "{{buz2}}"]
}
],
"labels": [
{
"label": "{{Car}}",
"editsAllowed":"{{none}}",
"categoryAttributes": [
{
"name":"{{X}}",
"description":"{{enter a number}}",
"type":"{{number}}",
"editsAllowed":"{{any}}"
},
{
"name":"{{Y}}",
"description":"{{select an option}}",
"type":"{{string}}",
"enum": ["{{y1}}", "{{y2}}"],
"editsAllowed":"{{any}}"
},
{
"name":"{{Z}}",
"description":"{{submit a free-form response}}",
"type":"{{string}}",
"editsAllowed":"{{none}}"
}
]
},
{
"label": "Pedestrian",
"editsAllowed":"{{none}}",
"categoryAttributes": [{{...}}]
}
],
"annotationType":"{{Keypoint}}",
"instructions": {"shortInstruction":"{{add example short instructions here}}", "fullInstruction":"{{}}"},
// include auditLabelAttributeName for label adjustment jobs
"auditLabelAttributeName": "{{myPrevJobLabelAttributeName}}"
}
```
## Esquema do arquivo de configuração da categoria de rótulos
A tabela a seguir lista os elementos que você pode e deve incluir no arquivo de configuração da categoria de rótulo.
**nota**
O parâmetro `annotationType` só é compatível com trabalhos de rotulagem de quadros de vídeo.
****
| Parâmetro | Obrigatório | Valores aceitos | Description |
| --- | --- | --- | --- |
| frameAttributes | Não | Uma lista de objetos JSON. **Parâmetros necessários em cada objeto JSON:** `name`, `type`, `description` `minimum` e `maximum` são necessários se `type` for `"number"` **Parâmetros opcionais em cada objeto JSON:** `enum`, `editsAllowed`, `isRequired` | Use esse parâmetro para criar um atributo de quadro que seja aplicado a todos os quadros ou nuvens de pontos 3D em seu trabalho de rotulagem.Consulte a terceira tabela nesta seção para obter mais informações. |
| categoryGlobalAttributes | Não | Uma lista de objetos JSON. **Parâmetros necessários em cada objeto JSON:** `name`, `type` `minimum` e `maximum` são necessários se `type` for `"number"` **Parâmetros opcionais em cada objeto JSON:** `description`, `enum`, `editsAllowed`, `isRequired` | Use esse parâmetro para criar atributos da categoria de rótulo que são aplicados a todos os rótulos especificados em `labels`. Consulte a terceira tabela nesta seção para obter mais informações. |
| labels | Sim | Uma lista de até 30 objetos JSON **Parâmetros necessários em cada objeto JSON:** `label` **Parâmetros opcionais em cada objeto JSON:** `categoryAttributes`, `editsAllowed` | Use esse parâmetro para especificar os rótulos, ou classes. Adicione um `label` para cada classe. Para adicionar um atributo da categoria de rótulo a um rótulo, adicione `categoryAttributes` a esse rótulo. Use `editsAllowed` para especificar se um rótulo pode ou não ser editado em uma tarefa de ajuste de rotulagem. Defina `editsAllowed` como `"none"` para trabalhos de rotulagem de verificação. Consulte a tabela a seguir para obter mais informações. |
| annotationType(compatível somente com trabalhos de rotulagem de quadros de vídeo) | Não | String **Parâmetros aceitos:** `BoundingBox`, `Polyline`, `Polygon`, `Keypoint` **Padrão**: `BoundingBox` | Use isso para especificar o tipo de tarefa para seus trabalhos de rotulagem de quadros de vídeo. Por exemplo, para uma tarefa de detecção de objetos de quadro de vídeo poligonal, escolha `Polygon`. Se você não especificar um `annotationType` ao criar um trabalho de rotulagem de quadros de vídeo, o Ground Truth usará `BoundingBox` por padrão. |
| instructions | Não | Um objeto JSONParâmetros necessários em cada objeto JSON:`"shortInstruction"`, `"fullInstruction"` | Use esse parâmetro para adicionar instruções do operador para ajudar os operadores a concluir suas tarefas. Para obter mais informações sobre instruções do operador, consulte [Instruções do operador](sms-point-cloud-general-information.md#sms-point-cloud-worker-instructions-general). As instruções curtas devem ter menos de 255 caracteres e a instrução longa deve ter menos de 2.048 caracteres. Para obter mais informações, consulte [Criar páginas de instrução](sms-creating-instruction-pages.md). |
| auditLabelAttributeName | Necessário para tipos de tarefas de ajuste e verificação | String | Insira o [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)usado na tarefa de etiquetagem da qual você deseja ajustar as anotações. Use esse parâmetro somente se estiver criando um trabalho de ajuste para quadro de vídeo e detecção de objeto de nuvem de pontos 3D ou segmentação semântica de nuvem de pontos 3D. |
### Esquema de objetos de rótulos
A tabela a seguir descreve os parâmetros que você pode e deve usar para criar uma lista de `Labels`. Cada parâmetro deve ser incluído em um objeto JSON.
****
| Parâmetro | Obrigatório | Valores aceitos | Description |
| --- | --- | --- | --- |
| label | Sim | String | O nome da categoria de rótulo que é exibida para os operadores. O nome de cada categoria de rótulo deve ser exclusivo. |
| categoryAttributes | Não | Uma lista de objetos JSON. **Parâmetros necessários em cada objeto JSON:** `name`, `type` `minimum` e `maximum` são necessários se `type` for `"number"` **Parâmetros opcionais em cada objeto JSON:** `description`, `enum`, `editsAllowed`, `isRequired` | Use esse parâmetro para adicionar atributos da categoria de rótulo a rótulos específicos determinados em `labels`. Para adicionar um ou mais atributos de categoria de rótulo a um rótulo, inclua o objeto JSON `categoryAttributes` no mesmo objeto `labels` JSON que está `label`.Consulte a tabela a seguir para obter mais informações. |
| editsAllowed | Não | String **Valores compatíveis:** `"none"`: nenhuma modificação não é permitida. ou `"any"`(Padrão): todas as modificações são permitidas. | Especifica se um rótulo pode ou não ser editado pelos operadores. Para trabalhos de rotulagem de *ajuste* de quadros de vídeo ou nuvem de pontos 3D, adicione esse parâmetro a um ou mais objetos JSON na lista `labels` para especificar se um operador pode ou não editar um rótulo. Para trabalhos de rotulagem de nuvem de pontos 3D e *verificação* de quadros de vídeo, adicione esse parâmetro com o valor `"none"` de cada objeto JSON na lista `labels`. Isso fará com que todos os rótulos sejam não editáveis. |
### FrameAttributes e esquema categoryGlobalAttributes
A tabela a seguir descreve os parâmetros que você pode e deve usar para criar atributos de quadro usando `frameAttributes` e atributo de categoria de rótulo usando os parâmetros `categoryGlobalAttributes` e `categoryAttributes`.
****
| Parâmetro | Obrigatório | Valores aceitos | Description |
| --- | --- | --- | --- |
| name | Sim | String | Use esse parâmetro para atribuir um nome ao atributo da categoria de rótulo ou quadro. Esse é o nome de atributo que os operadores veem. Cada nome de atributo de categoria de rótulo em seu arquivo de configuração de categoria de rótulo deve ser exclusivo. Os atributos globais da categoria do rótulo e os atributos específicos da categoria do rótulo não podem ter o mesmo nome. |
| type | Sim | String **Valores obrigatórios**: `"string"` ou `"number"` | Use esse parâmetro para definir o tipo de atributo da categoria de rótulo ou quadro. Se você especificar `"string"` para `type` e fornecer um valor `enum` para esse atributo, os operadores poderão escolher uma das opções fornecidas por você. Se você especificar `"string"` para `type` e não fornecer um `enum` valor, os operadores poderão inserir texto em formato livre. Se você especificar `number` para `type`, o operador poderá inserir um número entre os números `minimum` e `maximum`que você especificar. |
| enum | Não | Lista de strings | Use esse parâmetro para definir opções que os operadores podem escolher para essa categoria de rótulo ou atributo de quadro. Os operadores podem escolher um valor especificado em `enum`. Por exemplo, se você especificar `["foo", "buzz", "bar"`] para`enum`, os operadores podem escolher um de `foo`, `buzz` ou `bar`. Você deve especificar `"string"` para `type` para usar uma lista `enum`. |
| description | `frameAttributes`: Sim `categoryAttributes` ou `categoryGlobalAttributes`: Não | String | Use esse parâmetro para adicionar uma descrição da categoria de rótulo ou atributo de quadro. Você pode usar esse campo para fornecer aos operadores mais informações sobre o atributo. Esse campo só é obrigatório para atributos de quadro. |
| minimum e maximum | Necessário se o atributo type for "number" | Números inteiros | Use esses parâmetros para especificar valores mínimos e máximos (inclusivos) que os operadores podem inserir para categoria de rótulo ou atributos de quadro numéricos. Você deve especificar `"number"` para `type` para usar `minimum` e `maximum`. |
| editsAllowed | Não | String **Valores obrigatórios**: `"none"`: nenhuma modificação não é permitida. ou `"any"`(Padrão): todas as modificações são permitidas. | Especifica se uma categoria de rótulo ou atributo de quadro pode ou não ser editado pelos operadores. Para trabalhos de *ajuste* e rotulagem de *verificação* de quadros de vídeo ou nuvem de pontos 3D, adicione esse parâmetro aos objetos JSON de categoria de rótulo e atributo de quadro para especificar se um operador pode ou não editar um atributo. |
| isRequired | Não | Booleano | Especifica se os operadores precisam anotar um atributo. Os operadores não podem enviar o trabalho até que todos os atributos necessários sejam anotados. |
## Cotas de rótulo e de atributo da categoria de rótulo
É possível especificar até 10 atributos da categoria de rótulo por classe. Essas cotas de 10 atributos incluem atributos da categoria de rótulo global. Por exemplo, se você criar quatro atributos da categoria de rótulo global e, depois, atribuir três atributos da categoria de rótulo ao rótulo `X`, esse rótulo terá 4\+3=7 atributos da categoria de rótulo no total. Para todas as categorias de rótulo e todos os limites de atributo da categoria de rótulo, consulte a tabela a seguir.
****
| Tipo | Mín. | Máx |
| --- | --- | --- |
| Rótulos (`Labels`) | 1 | 30 |
| Quota de caracteres do nome do rótulo | 1 | 16 |
| Atributos da categoria de rótulo por rótulo (soma de `categoryAttributes` e`categoryGlobalAttributes`) | 0 | 10 |
| Atributos da categoria da rótulo de entrada de texto em formato livre por rótulo (soma de `categoryAttributes` e `categoryGlobalAttributes`). | 0 | 5 |
| Atributos de quadro | 0 | 10 |
| Atributos de entrada de texto em formato livre em `frameAttributes`. | 0 | 5 |
| Quota de caracteres do nome do atributo (`name`) | 1 | 16 |
| Quota de caracteres da descrição do atributo (`description`) | 0 | 128 |
| Quota de caracteres do tipo de atributo (`type`) | 1 | 16 |
| Valores permitidos na lista `enum` para um atributo `string` | 1 | 10 |
| Cota de caracteres para um valor na lista `enum` | 1 | 16 |
| Máximo de caracteres na resposta de texto de formato livre para texto de formato livre frameAttributes | 0 | 1000 |
| Máximo de caracteres na resposta de texto de formato livre para texto de formato livre categoryAttributes e categoryGlobalAttributes | 0 | 80 |