Funzionalità di Produttività

Potato include diverse funzionalità per aiutare gli annotatori a lavorare più velocemente e in modo più accurato, tra cui scorciatoie da tastiera, tooltip, evidenziazione di parole chiave e suggerimenti di etichette.

Scorciatoie da Tastiera

Associazioni di Tasti Sequenziali

Per gli schemi di annotazione con al massimo 10 opzioni, le associazioni di tasti possono essere assegnate sequenzialmente per impostazione predefinita:

annotation_schemes:
  - annotation_type: radio
    name: sentiment
    labels: [positive, neutral, negative]
    sequential_key_binding: true

La prima opzione corrisponderà al tasto "1", la seconda al "2", e così via.

Associazioni di Tasti Personalizzate

Per un maggiore controllo, configura associazioni di tasti personalizzate su ciascuna etichetta:

annotation_schemes:
  - annotation_type: multiselect
    labels:
      - name: "Option 1"
        key_value: "1"
      - name: "Option 2"
        key_value: "2"
      - name: "Skip"
        key_value: "s"

Evidenziazione di Parole Chiave Amministrative

Aiuta gli annotatori a identificare parole e frasi rilevanti con evidenziazioni colorate attorno al testo corrispondente.

Configurazione

keyword_highlights_file: data/keywords.tsv

Formato del File TSV

Il file delle parole chiave deve essere separato da tabulazione con tre colonne:

Word	Label	Schema
love	positive	sentiment
hate	negative	sentiment
excel*	positive	sentiment
disappoint*	negative	sentiment

Comportamento di Corrispondenza

• Senza distinzione maiuscole/minuscole: "Love" corrisponde a "love", "LOVE", "Love"
• Confini di parola: "love" corrisponde a "love" ma non a "lovely" (a meno che non si usino caratteri jolly)
• Caratteri jolly: Usa * per la corrispondenza di prefisso/suffisso:
  • excel* corrisponde a "excellent", "excels", "excel"
  • *happy corrisponde a "unhappy", "happy"

Configurazione dei Colori

I colori vengono configurati nella sezione ui.spans.span_colors:

ui:
  spans:
    span_colors:
      sentiment:
        positive: "(34, 197, 94)"    # Verde
        negative: "(239, 68, 68)"    # Rosso
        neutral: "(156, 163, 175)"   # Grigio

Impostazioni di Randomizzazione

Per scopi di ricerca, configura la randomizzazione dell'evidenziazione delle parole chiave per evitare che gli annotatori si affidino esclusivamente alle evidenziazioni:

keyword_highlights_file: data/keywords.tsv
 
keyword_highlight_settings:
  keyword_probability: 1.0       # Mostra il 100% delle parole chiave (0.0-1.0)
  random_word_probability: 0.05  # Evidenzia il 5% di parole casuali come distrattori
  random_word_label: "distractor"
  random_word_schema: "keyword"

Caratteristiche principali:

• Persistenza: Le parole evidenziate vengono memorizzate nella cache per utente+istanza
• Randomizzazione deterministica: Usa l'hash di username + instance_id come seed
• Tracciamento comportamentale: Registra quali parole sono state evidenziate

Tooltip

Aggiungi spiegazioni dettagliate per ogni opzione di risposta:

Tooltip in Testo Semplice

annotation_schemes:
  - annotation_type: multiselect
    name: "Question"
    labels:
      - name: "Label 1"
        tooltip: "This option means..."

Tooltip HTML

Per tooltip formattati, punta a un file HTML:

annotation_schemes:
  - annotation_type: multiselect
    name: "Question"
    labels:
      - name: "Label 1"
        tooltip_file: "config/tooltips/label1_tooltip.html"

Suggerimenti di Etichette

Visualizza suggerimenti per aiutare gli annotatori con due modalità:

• highlight: Evidenzia le etichette suggerite con il colore
• prefill: Preseleziona automaticamente le etichette suggerite

Configurazione

annotation_schemes:
  - annotation_type: multiselect
    name: "sentiment"
    description: "What sentiment does the text express?"
    labels: [positive, neutral, negative]
    label_suggestions: "highlight"  # o "prefill"
 
  - annotation_type: text
    name: "explanation"
    description: "Why do you think so?"
    multiline: true
    rows: 2
    label_suggestions: "prefill"

Formato dei Dati

Includi i suggerimenti nei tuoi elementi dati:

{
  "id": "1",
  "text": "Good Job!",
  "label_suggestions": {
    "sentiment": "positive",
    "explanation": "Because I think "
  }
}

Assegnazione Automatica dei Compiti

Assegna facilmente i compiti di annotazione a diversi annotatori:

automatic_assignment:
  on: true
  output_filename: "task_assignment.json"
  sampling_strategy: "random"
  labels_per_instance: 10
  instance_per_annotator: 50
  test_question_per_annotator: 2

Integrazione con l'Apprendimento Attivo

Le funzionalità di produttività si integrano con l'Apprendimento Attivo per dare priorità alle istanze più informative:

active_learning:
  enabled: true
  schema_names: ["sentiment"]
  min_annotations_per_instance: 2
  min_instances_for_training: 20
  update_frequency: 10

Best Practice

1. Usa le scorciatoie da tastiera per i compiti ad alto volume - accelerano significativamente l'annotazione
2. Aggiungi tooltip per etichette complesse o ambigue per ridurre l'incoerenza
3. Usa l'evidenziazione delle parole chiave per attirare l'attenzione sul testo rilevante, ma considera la randomizzazione per la validità della ricerca
4. Pre-compila i suggerimenti con cautela - possono influenzare gli annotatori se usati eccessivamente

Ulteriori Letture

• Configurazione UI - Personalizza l'interfaccia
• Apprendimento Attivo - Prioritizzazione basata su ML
• Assegnazione Compiti - Configura le strategie di assegnazione

Per i dettagli di implementazione, consulta la documentazione sorgente.