Skip to content

選項高亮

AI 輔助高亮離散標註任務中最可能正確的選項。

選項高亮是一項 AI 輔助功能，幫助標註者識別離散標註任務中最可能正確的選項。使用 LLM，系統分析內容和任務描述來預測 top-k 個最可能的選項，以完全不透明度顯示它們，同時淡化不太可能的選項。

概述

啟用後，選項高亮：

  1. 使用 LLM 分析實例內容
  2. 根據任務上下文識別最可能的選項
  3. 用星標指示器高亮可能的選項
  4. 淡化不太可能的選項（可配置不透明度）
  5. 保持所有選項完全可點選——這是引導而非限制

這對於有很多選項的任務、培訓新標註者、減少認知負擔和提供"第二意見"以增強標註信心特別有用。

配置

在配置中的 ai_support 下新增 option_highlighting 部分：

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

配置參考

選項類型預設值描述
enabledbooleanfalse啟用選項高亮
top_kinteger3高亮的選項數量（1-10）
dim_opacityfloat0.4淡化選項的不透明度（0.1-0.9）
auto_applybooleantrue頁面載入時自動應用
schemaslist/nullnull限制到特定模式，或 null 表示所有
prefetch_countinteger20預取的項目數

支援的標註類型

選項高亮適用於離散選擇類型：

  • radio - 單選
  • multiselect - 多選核取方塊
  • likert - Likert 量表評分
  • select - 下拉選擇

不適用於：span、textbox、slider、image_annotation 或 video_annotation。

視覺外觀

  • 高亮選項：完全不透明度，帶金色星標指示器和微妙的背景高亮
  • 淡化選項：降低不透明度（可配置），懸停時亮度增至 0.7，仍然完全可點選
  • 表單指示器：啟用高亮的標註表單左側有金色邊框，小"AI"徽章

預取

由於 LLM 查詢可能較慢，選項高亮使用積極的預取：

  1. 預熱：伺服器啟動時預取前 N 個項目
  2. 導航時：使用者前進/後退時預取下一批項目
  3. 後臺處理：預取非同步進行
  4. 快取：結果快取到磁碟以供重用

最佳實踐

  1. 使用快速模型 - gpt-4o-mini 在速度和準確性之間提供良好平衡
  2. 設定適當的 top_k - 二選一使用 1，4-5 個選項使用 2-3
  3. 啟用預取 - 較高的 prefetch_count（20+）確保流暢的導航
  4. 培訓標註者 - 說明高亮是建議而非要求

延伸閱讀

有關實現細節，請參閱原始碼文件。