Multisseleção Hierárquica

Crie seletores de taxonomia expansíveis em árvore no Potato para classificação hierárquica, marcação de tópicos e tarefas de anotação de categorias em vários níveis.

O esquema de anotação de multisseleção hierárquica oferece uma interface de árvore expansível para selecionar categorias de uma taxonomia aninhada. Esse esquema é ideal para tarefas em que os rótulos estão organizados em uma hierarquia, como classificação de tópicos, categorização de produtos ou qualquer tarefa de marcação em vários níveis.

Visão Geral

O esquema de multisseleção hierárquica apresenta uma visualização em árvore recolhível em que:

Nós pai se expandem para revelar categorias filhas
Nós folha podem ser selecionados individualmente
A seleção automática opcional propaga as seleções para cima ou para baixo na árvore
A busca permite que os anotadores encontrem categorias rapidamente em taxonomias grandes

Início Rápido

yaml

annotation_schemes:
  - annotation_type: hierarchical_multiselect
    name: topic_tags
    description: Select all applicable topic categories.
    taxonomy:
      Science:
        Physics:
          - Quantum Mechanics
          - Thermodynamics
        Biology:
          - Genetics
          - Ecology
      Technology:
        - Software
        - Hardware

Opções de Configuração

Campo	Tipo	Padrão	Descrição
`annotation_type`	string	Obrigatório	Deve ser `"hierarchical_multiselect"`
`name`	string	Obrigatório	Identificador único deste esquema
`description`	string	Obrigatório	Instruções exibidas aos anotadores
`taxonomy`	object	Obrigatório	Objeto aninhado que define a hierarquia de categorias
`auto_select_children`	boolean	`false`	Quando um pai é selecionado, seleciona automaticamente todos os seus filhos
`auto_select_parent`	boolean	`false`	Quando todos os filhos são selecionados, seleciona automaticamente o pai
`show_search`	boolean	`false`	Exibe uma caixa de busca para filtrar a árvore de taxonomia
`max_selections`	integer/null	`null`	Número máximo de categorias que podem ser selecionadas (`null` para ilimitado)
`expand_depth`	integer	`1`	Número de níveis da árvore a expandir por padrão
`label_requirement.required`	boolean	`false`	Se pelo menos uma seleção é obrigatória antes de enviar

Exemplos

Classificação de Tópicos

yaml

annotation_schemes:
  - annotation_type: hierarchical_multiselect
    name: topic_classification
    description: Select all topics that apply to this document.
    show_search: true
    max_selections: 5
    taxonomy:
      Politics:
        Domestic:
          - Elections
          - Legislation
          - Policy
        International:
          - Diplomacy
          - Trade
          - Conflict
      Sports:
        - Football
        - Basketball
        - Tennis
      Entertainment:
        Film:
          - Reviews
          - Industry News
        Music:
          - Reviews
          - Concerts

Categorização de Produtos com Seleção Automática

yaml

annotation_schemes:
  - annotation_type: hierarchical_multiselect
    name: product_category
    description: Categorize this product listing.
    auto_select_children: true
    auto_select_parent: true
    expand_depth: 2
    taxonomy:
      Electronics:
        Computers:
          - Laptops
          - Desktops
          - Tablets
        Audio:
          - Headphones
          - Speakers
      Clothing:
        Men:
          - Shirts
          - Pants
        Women:
          - Dresses
          - Tops

Codificação Médica

yaml

annotation_schemes:
  - annotation_type: hierarchical_multiselect
    name: diagnosis_codes
    description: Select all applicable diagnosis categories.
    show_search: true
    label_requirement:
      required: true
    taxonomy:
      Cardiovascular:
        Hypertension:
          - Primary
          - Secondary
        Arrhythmia:
          - Atrial Fibrillation
          - Ventricular Tachycardia
      Respiratory:
        Obstructive:
          - Asthma
          - COPD
        Infectious:
          - Pneumonia
          - Bronchitis

Formato de Saída

json

{
  "topic_tags": {
    "labels": ["Science > Physics > Quantum Mechanics", "Technology > Software"]
  }
}

As categorias selecionadas são armazenadas como strings de caminho completo da raiz até a folha.

Boas Práticas

Mantenha as taxonomias gerenciáveis - evite mais de 4 níveis de aninhamento; árvores profundas são difíceis de navegar
Ative a busca para taxonomias grandes - quando houver mais de 30 categorias, show_search: true melhora bastante a usabilidade
Use a seleção automática com cuidado - selecionar automaticamente os filhos é útil quando as categorias pai implicam todos os filhos, mas pode confundir em outros casos
Defina a profundidade de expansão adequada - expanda níveis suficientes para que os anotadores vejam a estrutura sem se sentirem sobrecarregados
Limite as seleções quando apropriado - use max_selections para evitar que os anotadores marquem categorias em excesso

Leitura Complementar

Radio e Multisseleção - Seleção de rótulos plana
Dropdown de Seleção - Dropdown de seleção única
Controle de Qualidade - Verificações de atenção e padrões de referência

Para detalhes de implementação, consulte a documentação de origem.