Skip to content

Gerenciamento de Usuários

Gerencie anotadores no Potato — configure listas de usuários, senhas, funções, atribuições de tarefas, configurações de sobreposição e autenticação OAuth ou SSO para o seu projeto.

O Potato oferece opções flexíveis de gerenciamento de usuários, desde acesso aberto até autenticação restrita.

Modos de Acesso

Acesso Aberto

Permita que qualquer pessoa anote sem login:

yaml
allow_all_users: true

Acesso Restrito

Limite a usuários específicos:

yaml
allow_all_users: false
authorized_users:
  - alice@example.com
  - bob@example.com
  - researcher@university.edu

Autenticação

Login por E-mail

Os usuários inserem seu e-mail para acessar a interface de anotação:

yaml
allow_all_users: false
authorized_users:
  - user1@example.com
  - user2@example.com

Integração com Crowdsourcing

Para trabalhadores do Prolific ou MTurk:

yaml
# Prolific integration
allow_all_users: true
prolific_integration: true
prolific_completion_code: "ABC123"
 
# Workers authenticated via URL parameter
# https://yourserver.com/?PROLIFIC_PID=xxx

Autenticação por Parâmetro de URL

Passe o ID do usuário pela URL:

yaml
url_user_id_param: user_id
# Access via: http://localhost:8000/?user_id=annotator1

Funções de Usuário

Anotadores

Usuários comuns que rotulam dados:

yaml
authorized_users:
  - annotator1@example.com
  - annotator2@example.com

Administradores

Usuários com acesso ao painel administrativo:

yaml
admin_users:
  - admin@example.com
  - lead_researcher@university.edu

Os administradores podem:

  • Visualizar todas as anotações
  • Monitorar o progresso
  • Exportar dados
  • Gerenciar usuários

Atribuição de Tarefas

Instâncias por Usuário

Limite quantos itens cada usuário anota:

yaml
instances_per_annotator: 100

Anotações por Instância

Exija vários anotadores por item:

yaml
annotation_per_instance: 3

Configurações de Sobreposição

Controle a sobreposição das anotações:

yaml
# Each instance gets exactly 2 annotations
annotation_per_instance: 2
 
# Assign same instances to specific users for IAA calculation
overlap_users:
  - user1@example.com
  - user2@example.com
overlap_percentage: 20  # 20% of instances shared

Controle de Qualidade

Verificações de Atenção

Insira perguntas de teste para verificar a atenção:

yaml
attention_checks:
  enabled: true
  frequency: 10  # Every 10 instances
  fail_threshold: 2  # Max failures before warning

Testes de Qualificação

Exija a aprovação em um teste antes da anotação principal:

yaml
qualification:
  enabled: true
  test_file: qualification_test.json
  min_score: 80  # Minimum percentage to pass

Gerenciamento de Sessão

Tempo Limite da Sessão

Encerre a sessão automaticamente após inatividade:

yaml
session_timeout: 3600  # seconds (1 hour)

Salvar Progresso

As anotações são salvas automaticamente, mas você pode configurar:

yaml
auto_save: true
auto_save_interval: 30  # seconds

Estatísticas de Usuário

Acompanhe o desempenho dos anotadores:

yaml
track_user_stats: true

Métricas disponíveis:

  • Anotações concluídas
  • Tempo por anotação
  • Concordância com outros
  • Desempenho nas verificações de atenção

Acesse pelo painel administrativo em /admin.

Fluxos de Trabalho com Múltiplos Anotadores

Atribuição Rotativa (Round-Robin)

Distribua as instâncias uniformemente:

yaml
assignment_strategy: round_robin

Atribuição Baseada em Prioridade

Atribua com base na expertise do anotador:

yaml
assignment_strategy: priority
user_priorities:
  expert@example.com: high
  novice@example.com: low

Configurações de Privacidade

Anonimizar Usuários

Oculte as identidades dos usuários nas exportações:

yaml
anonymize_users: true

Retenção de Dados

Configure por quanto tempo manter os dados:

yaml
data_retention:
  annotations: 365  # days
  user_data: 90     # days

Exemplo: Configuração de Equipe de Pesquisa

yaml
# Restricted to research team
allow_all_users: false
 
# Team members
authorized_users:
  - researcher1@university.edu
  - researcher2@university.edu
  - student1@university.edu
  - student2@university.edu
 
# Lead researcher is admin
admin_users:
  - researcher1@university.edu
 
# Each person annotates 200 items
instances_per_annotator: 200
 
# Each item gets 2 annotations for reliability
annotation_per_instance: 2
 
# Track performance
track_user_stats: true
 
# Auto-save every 30 seconds
auto_save: true
auto_save_interval: 30

Exemplo: Configuração de Crowdsourcing

yaml
# Open access for crowdworkers
allow_all_users: true
 
# Prolific integration
prolific_integration: true
prolific_completion_code: "POTATO2024"
 
# Limit per worker
instances_per_annotator: 50
 
# Quality control
attention_checks:
  enabled: true
  frequency: 10
 
# Multiple annotations per item
annotation_per_instance: 3

Leitura Adicional

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