Skip to content

Resaltado de Opciones

Resaltado asistido por IA de las opciones más probables para tareas de anotación discretas.

El Resaltado de Opciones es una función asistida por IA que ayuda a los anotadores a identificar las opciones más probablemente correctas para tareas de anotación discretas. Usando un LLM, el sistema analiza el contenido y la descripción de la tarea para predecir las top-k opciones más probables, mostrándolas a opacidad completa mientras atenúa las opciones menos probables.

Descripción General

Cuando está habilitado, el Resaltado de Opciones:

  1. Analiza el contenido de la instancia usando un LLM
  2. Identifica las opciones más probables basándose en el contexto de la tarea
  3. Resalta las opciones probables con un indicador de estrella
  4. Atenúa las opciones menos probables (opacidad configurable)
  5. Mantiene todas las opciones completamente clicables — esto es orientación, no restricción

Esto es particularmente útil para tareas con muchas opciones, entrenar nuevos anotadores, reducir la carga cognitiva y proporcionar una "segunda opinión" para aumentar la confianza en la anotación.

Configuración

Agrega la sección option_highlighting bajo ai_support en tu configuración:

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

Referencia de Configuración

OpciónTipoPor defectoDescripción
enabledbooleanfalseHabilitar resaltado de opciones
top_kinteger3Número de opciones a resaltar (1-10)
dim_opacityfloat0.4Opacidad para opciones atenuadas (0.1-0.9)
auto_applybooleantrueAplicar automáticamente al cargar la página
schemaslist/nullnullLimitar a esquemas específicos, o null para todos
prefetch_countinteger20Número de elementos a pre-cargar

Tipos de Anotación Soportados

El resaltado de opciones funciona con tipos de selección discreta:

  • radio - Selección de opción única
  • multiselect - Selección múltiple con casillas de verificación
  • likert - Calificaciones en escala Likert
  • select - Selección desplegable

No se aplica a: span, textbox, slider, image_annotation o video_annotation.

Apariencia Visual

  • Opciones resaltadas: Opacidad completa con un indicador de estrella dorada y un sutil resaltado de fondo
  • Opciones atenuadas: Opacidad reducida (configurable), se iluminan a 0.7 al pasar el cursor, siguen siendo completamente clicables
  • Indicador de formulario: Borde izquierdo dorado en formularios de anotación con resaltado activo, pequeña insignia "AI"

Pre-carga

Dado que las consultas al LLM pueden ser lentas, el resaltado de opciones usa pre-carga agresiva:

  1. Calentamiento: Los primeros N elementos se pre-cargan al iniciar el servidor
  2. En navegación: Los siguientes elementos se pre-cargan cuando el usuario avanza/retrocede
  3. Procesamiento en segundo plano: La pre-carga ocurre de forma asíncrona
  4. Caché: Los resultados se almacenan en disco para reutilización

Mejores Prácticas

  1. Usa un modelo rápido - gpt-4o-mini proporciona un buen equilibrio entre velocidad y precisión
  2. Establece un top_k apropiado - para opciones binarias usa 1, para 4-5 opciones usa 2-3
  3. Habilita la pre-carga - un prefetch_count más alto (20+) asegura una navegación fluida
  4. Entrena a los anotadores - explica que los resaltados son sugerencias, no requisitos

Lecturas Adicionales

Para detalles de implementación, consulta la documentación fuente.