Skip to content

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.

Seleção múltipla hierárquica do Potato com uma taxonomia de tópicos expansívelSeleção múltipla hierárquica no Potato

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

CampoTipoPadrãoDescrição
annotation_typestringObrigatórioDeve ser "hierarchical_multiselect"
namestringObrigatórioIdentificador único deste esquema
descriptionstringObrigatórioInstruções exibidas aos anotadores
taxonomyobjectObrigatórioObjeto aninhado que define a hierarquia de categorias
auto_select_childrenbooleanfalseQuando um pai é selecionado, seleciona automaticamente todos os seus filhos
auto_select_parentbooleanfalseQuando todos os filhos são selecionados, seleciona automaticamente o pai
show_searchbooleanfalseExibe uma caixa de busca para filtrar a árvore de taxonomia
max_selectionsinteger/nullnullNúmero máximo de categorias que podem ser selecionadas (null para ilimitado)
expand_depthinteger1Número de níveis da árvore a expandir por padrão
label_requirement.requiredbooleanfalseSe 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

  1. Mantenha as taxonomias gerenciáveis - evite mais de 4 níveis de aninhamento; árvores profundas são difíceis de navegar
  2. Ative a busca para taxonomias grandes - quando houver mais de 30 categorias, show_search: true melhora bastante a usabilidade
  3. 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
  4. Defina a profundidade de expansão adequada - expanda níveis suficientes para que os anotadores vejam a estrutura sem se sentirem sobrecarregados
  5. Limite as seleções quando apropriado - use max_selections para evitar que os anotadores marquem categorias em excesso

Leitura Complementar

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