Destaque de Opções

O destaque de opções com IA no Potato pré-seleciona os rótulos provavelmente corretos usando LLMs, reduzindo a carga cognitiva e acelerando a produtividade em tarefas de anotação discreta.

O Destaque de Opções é um recurso assistido por IA que ajuda os anotadores a identificar as opções mais provavelmente corretas em tarefas de anotação discreta. Usando um LLM, o sistema analisa o conteúdo e a descrição da tarefa para prever as top-k opções mais prováveis, exibindo-as com opacidade total e atenuando as opções menos prováveis.

Visão geral

Quando ativado, o Destaque de Opções:

Analisa o conteúdo da instância usando um LLM
Identifica as opções mais prováveis com base no contexto da tarefa
Destaca as opções prováveis com um indicador de estrela
Atenua as opções menos prováveis (opacidade configurável)
Mantém todas as opções totalmente clicáveis - isto é orientação, não restrição

Isto é especialmente útil em tarefas com muitas opções, no treinamento de novos anotadores, na redução da carga cognitiva e ao fornecer uma "segunda opinião" para aumentar a confiança na anotação.

Configuração

Adicione a seção option_highlighting sob ai_support na sua configuração:

yaml

ai_support:
  enabled: true
  endpoint_type: "openai"
  ai_config:
    model: "gpt-4o-mini"
    api_key: "${OPENAI_API_KEY}"
    temperature: 0.3
 
  option_highlighting:
    enabled: true
    top_k: 3                    # Number of options to highlight (1-10)
    dim_opacity: 0.4            # Opacity for non-highlighted options (0.1-0.9)
    auto_apply: true            # Apply on page load vs manual trigger
    schemas: null               # null = all schemas, or ["schema1", "schema2"]
    prefetch_count: 20          # Items to prefetch
 
  cache_config:
    disk_cache:
      enabled: true
      path: annotation_output/ai_cache.json
    prefetch:
      warm_up_page_count: 10
      on_next: 3
      on_prev: 1

Referência de configuração

Opção	Tipo	Padrão	Descrição
`enabled`	boolean	`false`	Ativa o destaque de opções
`top_k`	integer	`3`	Número de opções a destacar (1-10)
`dim_opacity`	float	`0.4`	Opacidade das opções atenuadas (0.1-0.9)
`auto_apply`	boolean	`true`	Aplica automaticamente ao carregar a página
`schemas`	list/null	`null`	Limita a esquemas específicos, ou `null` para todos
`prefetch_count`	integer	`20`	Número de itens a pré-carregar antecipadamente

Tipos de anotação suportados

O destaque de opções funciona com tipos de escolha discreta:

radio - Seleção de escolha única
multiselect - Seleção de múltiplas caixas de seleção
likert - Avaliações em escala Likert
select - Seleção em menu suspenso

Ele não se aplica a: span, textbox, slider, image_annotation ou video_annotation.

Aparência visual

Opções destacadas: Opacidade total com um indicador de estrela dourada e um realce de fundo sutil
Opções atenuadas: Opacidade reduzida (configurável), clareiam para 0.7 ao passar o mouse, ainda totalmente clicáveis
Indicador no formulário: Borda esquerda dourada nos formulários de anotação com destaque ativo, um pequeno selo "AI"

Pré-carregamento

Como as consultas a LLMs podem ser lentas, o destaque de opções usa pré-carregamento agressivo:

Aquecimento: Os primeiros N itens são pré-carregados ao iniciar o servidor
Na navegação: Os próximos itens são pré-carregados quando o usuário avança/retrocede
Processamento em segundo plano: O pré-carregamento ocorre de forma assíncrona
Cache: Os resultados são armazenados em disco para reutilização

Boas práticas

Use um modelo rápido - gpt-4o-mini oferece um bom equilíbrio entre velocidade e precisão
Defina um top_k adequado - para escolhas binárias use 1, para 4-5 opções use 2-3
Ative o pré-carregamento - um prefetch_count mais alto (20+) garante uma navegação fluida
Treine os anotadores - explique que os destaques são sugestões, não requisitos

Leitura adicional

Suporte de IA - Configuração geral do assistente de IA
Ordenação por Diversidade - Recurso de IA complementar para ordenação de itens

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