Entrada de Texto e Número

Colete respostas em texto livre e valores numéricos no Potato. Configure caixas de texto, campos numéricos, regras de validação, texto de espaço reservado e limites de caracteres.

As entradas de texto e número permitem que os anotadores forneçam respostas em formato livre, úteis para correções, explicações, contagens e medições.

Interface de anotação de entrada de texto Campos de entrada de texto livre e número para anotação aberta no Potato

Entrada de Texto

Campo de Texto Básico

Entrada de texto de linha única:

yaml

annotation_schemes:
  - annotation_type: text
    name: correction
    description: "Provide a corrected version of the text"

Entrada de Múltiplas Linhas

Para respostas mais longas, use multiline: true. Você também pode definir rows e cols para controlar as dimensões da área de texto, e allow_paste para controlar a colagem da área de transferência:

yaml

- annotation_type: text
  name: explanation
  description: "Explain your reasoning"
  multiline: true
  rows: 4
  cols: 50
  allow_paste: true

Texto de Espaço Reservado

Oriente os anotadores com uma entrada de exemplo:

yaml

- annotation_type: text
  name: summary
  description: "Write a one-sentence summary"
  placeholder: "Enter your summary here..."

Limites de Caracteres

Restrinja o comprimento da resposta usando min_chars e max_chars:

yaml

- annotation_type: text
  name: title
  description: "Suggest a title"
  min_chars: 10
  max_chars: 100

Texto Obrigatório

Torne o campo obrigatório:

yaml

- annotation_type: text
  name: justification
  description: "Why did you choose this label?"
  required: true

Entrada de Número

Campo de Número Básico

yaml

annotation_schemes:
  - annotation_type: number
    name: count
    description: "How many entities are mentioned?"

Restrições de Intervalo

Defina valores mínimo e máximo:

yaml

- annotation_type: number
  name: rating
  description: "Rate from 1 to 10"
  min: 1
  max: 10

Tamanho do Passo

Controle a precisão do incremento:

yaml

- annotation_type: number
  name: percentage
  description: "What percentage is relevant?"
  min: 0
  max: 100
  step: 5  # Increments of 5

Números Decimais

Permita valores de ponto flutuante:

yaml

- annotation_type: number
  name: score
  description: "Confidence score"
  min: 0.0
  max: 1.0
  step: 0.1

Valor Padrão

Preencha previamente com um padrão:

yaml

- annotation_type: number
  name: count
  description: "Number of errors"
  default: 0
  min: 0

Entrada de Controle Deslizante

Alternativa visual à entrada de número:

yaml

- annotation_type: slider
  name: confidence
  description: "How confident are you?"
  min: 0
  max: 100
  step: 1

Controle Deslizante com Rótulos

Adicione rótulos nas extremidades:

yaml

- annotation_type: slider
  name: agreement
  description: "How much do you agree?"
  min: 0
  max: 100
  min_label: "Strongly Disagree"
  max_label: "Strongly Agree"

Opções de Exibição do Controle Deslizante

Mostre o valor atual:

yaml

- annotation_type: slider
  name: rating
  min: 0
  max: 100
  show_value: true

Casos de Uso Comuns

Tarefa de Correção de Texto

yaml

annotation_schemes:
  - annotation_type: radio
    name: has_error
    description: "Does this text contain errors?"
    labels:
      - "Yes"
      - "No"
 
  - annotation_type: text
    name: corrected_text
    description: "Provide the corrected version"
    multiline: true
    show_if:
      scheme: has_error
      value: "Yes"

Qualidade de Tradução

yaml

annotation_schemes:
  - annotation_type: slider
    name: adequacy
    description: "How much meaning is preserved?"
    min: 0
    max: 100
    min_label: "None"
    max_label: "All"
 
  - annotation_type: slider
    name: fluency
    description: "How natural does it sound?"
    min: 0
    max: 100
    min_label: "Incomprehensible"
    max_label: "Perfect"
 
  - annotation_type: text
    name: improved_translation
    description: "Suggest a better translation (optional)"
    multiline: true
    required: false

Contagem de Entidades

yaml

annotation_schemes:
  - annotation_type: number
    name: person_count
    description: "How many people are mentioned?"
    min: 0
    max: 50
 
  - annotation_type: number
    name: org_count
    description: "How many organizations are mentioned?"
    min: 0
    max: 50
 
  - annotation_type: number
    name: location_count
    description: "How many locations are mentioned?"
    min: 0
    max: 50

Coleta de Feedback

yaml

annotation_schemes:
  - annotation_type: likert
    name: difficulty
    description: "How difficult was this task?"
    size: 5
    min_label: "Very Easy"
    max_label: "Very Hard"
 
  - annotation_type: text
    name: feedback
    description: "Any additional feedback?"
    multiline: true
    required: false
    placeholder: "Share your thoughts..."

Avaliação de Qualidade com Justificativa

yaml

annotation_schemes:
  - annotation_type: radio
    name: quality
    description: "Rate the quality"
    labels:
      - Excellent
      - Good
      - Fair
      - Poor
 
  - annotation_type: text
    name: justification
    description: "Explain your rating"
    multiline: true
    required: true
    min_chars: 20

Validação

Validação de Texto

yaml

- annotation_type: text
  name: email
  description: "Enter contact email"
  validation:
    pattern: "^[a-zA-Z0-9+_.-]+@[a-zA-Z0-9.-]+$"
    message: "Please enter a valid email address"

Validação de Número

Os números são validados automaticamente em relação a min/max:

yaml

- annotation_type: number
  name: year
  description: "Enter the year"
  min: 1900
  max: 2024
  validation_message: "Year must be between 1900 and 2024"

Navegação por Teclado

Os campos de texto e número suportam a navegação padrão por teclado:

Tab para se mover entre os campos
Enter para enviar (para texto de linha única)
Teclas de seta para incremento/decremento de número

Formato de Saída

As anotações de texto e número são salvas diretamente:

json

{
  "id": "doc1",
  "correction": "The corrected text goes here.",
  "count": 5,
  "confidence": 85
}

Exemplo Completo: Revisão de Documento

yaml

annotation_task_name: "Document Review"
 
annotation_schemes:
  # Quality rating
  - annotation_type: likert
    name: quality
    description: "Overall document quality"
    size: 5
    min_label: "Poor"
    max_label: "Excellent"
 
  # Error count
  - annotation_type: number
    name: error_count
    description: "Number of errors found"
    min: 0
    max: 100
    default: 0
 
  # Confidence slider
  - annotation_type: slider
    name: confidence
    description: "How confident are you in this assessment?"
    min: 0
    max: 100
    show_value: true
 
  # Detailed feedback
  - annotation_type: text
    name: errors_found
    description: "List the errors you found"
    multiline: true
    placeholder: "Describe each error..."
 
  # Summary
  - annotation_type: text
    name: summary
    description: "Brief summary of the document"
    max_chars: 280
    placeholder: "Summarize in one sentence..."

Boas Práticas

Use os tipos de entrada apropriados - controles deslizantes para valores contínuos, números para contagens precisas
Defina restrições razoáveis - valores de min/max evitam dados inválidos
Forneça espaços reservados - oriente os anotadores sobre o formato esperado
Deixe claros os campos opcionais - use required: false e indique na descrição
Use exibição condicional - mostre campos de texto apenas quando necessário
Considere a validação - use padrões para entradas estruturadas como e-mails ou IDs