基層主管 AI Agent 實作課你問,它答 → 你說,它做 → 你排,它動
15 / 19

你排,它動

11A

Codex 示範:用 Python 辨識掃描表單,低信心就停止輸出

先從這裡開始

這頁只做一件事

今天只觀察講師示範;學員不用安裝 Codex、Python 或 OCR 工具。

完成後你會帶走一張觀察紀錄:哪些被接受、哪些送人工複核、哪些選擇拒絕。
  1. 1看講師使用固定的合成資料重跑。
  2. 2只觀察 accepted、needs_review、abstained 三種狀態。
  3. 3在觀察表寫下人工最後怎麼決定。
什麼情況先停下來?不要把合成資料的測試數字外推成正式上線能力,也不要在學員電腦安裝工具。
先看懂這頁會出現的詞
OCR
把影像中的文字轉成可處理文字
OMR
判讀表單上的勾選或塗記
Null 不變性
不確定或拒絕時,value 必須保持空白或 null
參與層級
講師限定示範
建議時間
25 分鐘
主要工具
Codex/Python(講師端)
備援
已驗證 offline fallback pack
前置條件
學員不安裝;只用全新合成資料
預期產物
8 項正式下載、30 份樣本、結果與人工觀察表
保存檢查點
輸入 SHA → 對位 → ROI → 欄位狀態 → metrics → 人工核決
停止/退回
錯頁、缺錨點、嚴重模糊或信心不足時 value=null
版本與驗證狀態(講師/IT 需要時再看)

WP7 已完成:30 份固定 seed 合成掃描、可重跑程式、ground truth、結果、拒絕政策與八項正式下載均已實體驗證。

這一頁現在是一套真的能重跑、能被退件的教學 baseline。輸入是全新合成三頁表單,不複製私人 PDF;流程把影像品質、對位、頁碼、ROI、OMR、選用 OCR、規則與信心分開留證。結果不夠時不猜,正式值直接留空。

八項 WP7 交付已由 planned 轉為 ready

交付內容驗收
source form全新三頁 A4 合成 PDF,300 DPI template3 頁/2480×3508
starterREADME、AGENTS、schema、程式、測試與 scripts可由 Python 3.12 重跑
samples每頁 10 張,共 30 張,base seed 20260810逐檔 SHA-256
ground truthfields JSONL、documents CSV、dataset cardruntime 不讀真值
results30 JSON、review queue、overlay、metricsnull invariant 通過
script25 分鐘講師流程與三個觀察案例現場/離線兩路
policy門檻、互斥規則、停止與能力限制實測數字同步
screenshots清晰、模糊與裁切三種預期畫面A/R/X 不只靠顏色

全新合成資料與可追查流程

  1. 產生三頁中性訓練表單與空白 template。
  2. 以每筆 SHA-256 衍生 seed,建立旋轉、透視、低對比、陰影、模糊、含糊標記、壓縮雜訊、裁切與錯版。
  3. 先評估品質,再找四角定位標記與 3-bit page code。
  4. 對位後擷取 ROI;OMR 比較空白 template,文字欄交給可替換 OCR adapter。
  5. 套用 confidence、margin、互斥規則與最嚴格文件狀態。
  6. 輸出 JSON、人工佇列、疊圖與獨立 metrics。
全新合成表單的偵錯疊圖;欄位以 A、R、X 文字和顏色同時標示接受、覆核與棄答。
示意結果來自固定合成樣本;A/R/X 與色彩同時標示狀態。

基線實測:零誤接受不等於零風險

指標結果怎麼讀
documents/fields30/120固定 seed 合成資料
false acceptance0/70(0.00%)只計正式接受欄位;不外推
clear OMR coverage100.00%清晰 OMR 不靠全數棄答取巧
review/abstention31.67%/10.00%保守門檻會增加人工量
registration failure6.67%旋轉、裁切、陰影等安全失敗可見
document result15 accepted、12 needs_review、3 abstainedOCR composite 與 hard gate 採版本化規則,文件取最嚴格狀態

這些數字只描述 shipped synthetic dataset;不代表繁中、手寫、任意表單或生產掃描能力。

正式值只出現在 accepted

證據狀態valuecandidates下一步
門檻、margin、品質、對位與規則全過accepted正式值可保留依風險抽查
有候選但信心/品質/規則不足needs_reviewnull可見人工確認
錯頁、缺錨點、嚴重模糊或低信心abstainednull[]重掃或退回

講師重跑三條命令

python -m unittest discover -s tests -v
python -m src.cli run --input data/samples --output outputs --config config --template data/template --seed 20260810 --ocr auto
python scripts/evaluate.py --ground-truth data/ground_truth/fields.jsonl --results outputs/results --output outputs/metrics --fail-on-false-acceptance

沒有 Tesseract 時使用 --ocr none;OMR、對位、拒絕輸出與 metrics 仍可跑,文字欄會 abstain。講師若無法現場執行,要明說使用預產 fallback,不可冒充 live run。

正式下載

檔案清單與備援(需要時再展開)

本頁成果:人工觀察與核決

本頁成果

Codex 示範觀察表

尚未修改

先記證據,再寫結論;不要用「看起來差不多」代替 ground truth。

下載檔名:P11A_CODEX_OBSERVATION.md

能力邊界:沒有資料安全核准、真實代表樣本、錯誤成本、校準、人工責任與回復方案,就不得把本教學 baseline 接到生產流程。

非生產禁用:不得用於客戶資格判定、任何金融決策、法規遵循判斷、正式帳務處理或生產系統寫入。

收好再往下走

今天只要記住這三件事

  • 學員只觀察,不安裝。
  • Codex 負責程式與測試流程,不是 OCR 引擎。
  • 低信心要停下來,不能猜答案。

我真的學會了嗎?