Recursos de Produtividade

Acelere a anotação no Potato com atalhos de teclado, tooltips ao passar o mouse, destaque de palavras-chave com IA e sugestões inteligentes de rótulos para aumentar a produtividade dos anotadores.

O Potato inclui vários recursos para ajudar os anotadores a trabalhar com mais rapidez e precisão, incluindo atalhos de teclado, tooltips, destaques de palavras-chave e sugestões de rótulos.

Atalhos de Teclado

Atalhos Sequenciais

Para esquemas de anotação com no máximo 10 opções, os atalhos podem ser atribuídos sequencialmente por padrão:

yaml

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

A primeira opção corresponderá à tecla "1", a segunda à "2", e assim por diante.

Atalhos Personalizados

Para maior controle, configure atalhos personalizados em cada rótulo:

yaml

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

Destaques de Palavras-chave do Administrador

Ajude os anotadores a identificar palavras e frases relevantes com destaques coloridos ao redor do texto correspondente.

Configuração

yaml

keyword_highlights_file: data/keywords.tsv

Formato do Arquivo TSV

O arquivo de palavras-chave deve ser separado por tabulação com três colunas:

text

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

Coluna	Descrição
Word	Palavra-chave ou frase a destacar (aceita curingas `*`)
Label	Rótulo de anotação associado a esta palavra-chave
Schema	Nome do esquema de anotação

Comportamento de Correspondência

Sem distinção de maiúsculas: "Love" corresponde a "love", "LOVE", "Love"
Limites de palavra: "love" corresponde a "love", mas não a "lovely" (a menos que use curingas)
Curingas: Use * para correspondência de prefixo/sufixo:
- excel* corresponde a "excellent", "excels", "excel"
- *happy corresponde a "unhappy", "happy"

Configurando Cores

As cores são configuradas na seção ui.spans.span_colors:

yaml

ui:
  spans:
    span_colors:
      sentiment:
        positive: "(34, 197, 94)"    # Green
        negative: "(239, 68, 68)"    # Red
        neutral: "(156, 163, 175)"   # Gray

Configurações de Aleatorização

Para fins de pesquisa, configure a aleatorização do destaque de palavras-chave para evitar que os anotadores dependam apenas dos destaques:

yaml

keyword_highlights_file: data/keywords.tsv
 
keyword_highlight_settings:
  keyword_probability: 1.0       # Show 100% of keywords (0.0-1.0)
  random_word_probability: 0.05  # Highlight 5% random words as distractors
  random_word_label: "distractor"
  random_word_schema: "keyword"

Recursos Principais:

Persistência: As palavras destacadas ficam em cache por usuário + instância
Aleatorização determinística: Usa o hash de username + instance_id como semente
Rastreamento de comportamento: Registra quais palavras foram destacadas

Tooltips

Adicione explicações detalhadas para cada opção de resposta:

Tooltips em Texto Simples

yaml

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

Tooltips em HTML

Para tooltips formatados, aponte para um arquivo HTML:

yaml

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

Sugestões de Rótulos

Exiba sugestões para ajudar os anotadores com dois modos:

highlight: Destaca os rótulos sugeridos com cor
prefill: Pré-seleciona automaticamente os rótulos sugeridos

Configuração

yaml

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

Formato de Dados

Inclua sugestões nos seus itens de dados:

json

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

Atribuição Automática de Tarefas

Atribua facilmente tarefas de anotação a diferentes anotadores:

yaml

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

Integração com Aprendizado Ativo

Os recursos de produtividade se integram com o Aprendizado Ativo para priorizar as instâncias mais informativas:

yaml

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

Boas Práticas

Use atalhos de teclado em tarefas de grande volume — eles aceleram bastante a anotação
Adicione tooltips para rótulos complexos ou ambíguos a fim de reduzir inconsistências
Use destaques de palavras-chave para chamar atenção ao texto relevante, mas considere a aleatorização para manter a validade da pesquisa
Pré-preencha sugestões com cuidado — elas podem enviesar os anotadores se usadas em excesso

Leitura Adicional

Configuração da Interface - Personalize a interface
Aprendizado Ativo - Priorização baseada em ML
Atribuição de Tarefas - Configure estratégias de atribuição

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