Skip to content

Selezione multipla gerarchica

Costruisci in Potato selettori ad albero espandibili per tassonomie, classificazione gerarchica, tagging tematico e annotazione di categorie su più livelli.

Lo schema di annotazione a selezione multipla gerarchica offre un'interfaccia ad albero espandibile per scegliere categorie dentro una tassonomia annidata. È adatto ai compiti in cui le etichette sono organizzate in una gerarchia, come la classificazione tematica, la categorizzazione di prodotti o qualsiasi tagging su più livelli.

Selezione multipla gerarchica di Potato con una tassonomia tematica espandibileHierarchical multiselect in Potato

Panoramica

Lo schema presenta una vista ad albero comprimibile in cui:

  • I nodi genitore si espandono per mostrare le categorie figlie
  • I nodi foglia si possono selezionare uno per uno
  • La selezione automatica opzionale propaga le scelte verso l'alto o verso il basso nell'albero
  • La ricerca permette agli annotatori di trovare in fretta le categorie nelle tassonomie ampie

Avvio rapido

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

Opzioni di configurazione

CampoTipoPredefinitoDescrizione
annotation_typestringObbligatorioDeve essere "hierarchical_multiselect"
namestringObbligatorioIdentificatore univoco per questo schema
descriptionstringObbligatorioIstruzioni visualizzate agli annotatori
taxonomyobjectObbligatorioOggetto annidato che definisce la gerarchia delle categorie
auto_select_childrenbooleanfalseQuando si seleziona un genitore, seleziona in automatico tutti i suoi figli
auto_select_parentbooleanfalseQuando tutti i figli sono selezionati, seleziona in automatico il genitore
show_searchbooleanfalseMostra un campo di ricerca per filtrare l'albero della tassonomia
max_selectionsinteger/nullnullNumero massimo di categorie selezionabili (null per nessun limite)
expand_depthinteger1Numero di livelli dell'albero espansi in partenza
label_requirement.requiredbooleanfalseSe serve almeno una selezione prima di inviare

Esempi

Classificazione tematica

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

Categorizzazione di prodotti con selezione automatica

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

Codifica medica

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

Formato di output

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

Le categorie selezionate sono salvate come stringhe di percorso completo, dalla radice alla foglia.

Buone pratiche

  1. Tieni le tassonomie gestibili - evita più di 4 livelli di annidamento, gli alberi profondi sono difficili da percorrere
  2. Attiva la ricerca sulle tassonomie ampie - oltre le 30 categorie, show_search: true migliora molto l'usabilità
  3. Usa la selezione automatica con criterio - selezionare in automatico i figli è comodo quando la categoria genitore implica tutti i figli, ma altrimenti confonde
  4. Imposta una profondità di espansione adatta - espandi abbastanza livelli da far capire la struttura senza sommergere l'annotatore
  5. Limita le selezioni quando ha senso - usa max_selections per evitare che gli annotatori assegnino troppi tag

Ulteriori letture

Per i dettagli implementativi, vedi la documentazione sorgente.