前言¶
教育類產品裏常見需求是：用戶上傳試卷或單題照片，系統要完成切題、識別手寫答案、判斷對錯，並儘量給出解析與知識點。若只在對話裏讓大模型「看圖批改」，往往缺少穩定的切題座標、計費口徑和與雲側一致的字段結構。
下面介紹 SkillHub 上的 騰訊雲試題批改 Agent（@tencent-adm/tencentcloud-ocr-questionmarkagent）。它把騰訊雲 OCR 的 SubmitQuestionMarkAgentJob / DescribeQuestionMarkAgentJob 封裝成 Agent 可讀的 SKILL 說明與腳本入口，讓 Cursor、Claude Code 等在有 API 密鑰時按異步任務流程調用官方接口，而不是自行拼湊 HTTP 細節。
這是什麼¶
騰訊雲試題批改 Agent 是由 騰訊雲文字識別團隊 發佈的企業來源（enterprise）Skill，分類爲 ai-agent，當前版本 1.0.3，SkillHub 座標爲 @tencent-adm/tencentcloud-ocr-questionmarkagent。頁面標註 requires_api_key=true，調用前需配置騰訊雲 API 密鑰。
技能定位：當需要對試卷圖片或試題圖片中的 K12 試卷或試題進行自動批改、手寫答案識別、知識點分析時使用；支持整捲圖片批改和單題圖片批改，提供題目切題、正誤判定、答案對比、錯誤分析、知識點輸出等結構化結果。接口爲異步模式——先提交任務拿到 JobId，再輪詢查詢直至 JobStatus 爲 DONE 或 FAIL。
官方 Skill 入口：https://api.skillhub.cn/tencent-adm/tencentcloud-ocr-questionmarkagent
SkillHub 展示頁：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-ocr-questionmarkagent
核心功能¶
以下能力均來自技能說明與騰訊雲 API 文檔，可按需組合參數。
- 異步雙接口：
SubmitQuestionMarkAgentJob提交任務 →DescribeQuestionMarkAgentJob輪詢結果。 - 整卷批改：自動切題後逐題批改，返回每道題的批改信息；提交響應中含切題邊框等信息（單題模式時切題列表可爲空）。
- 單題批改：通過
BoolSingleQuestion跳過切題，可直接批改單題，並可傳入參考答案（ReferenceAnswer，僅單題場景有效）。 - 可配置輸出：
QuestionConfigMap可開啓知識點（KnowledgePoints）、正確答案（TrueAnswer）、手寫答案座標（ReturnAnswerPosition）等。 - 深度思考：
EnableDeepThink可選開啓更深推理（速度更慢）。 - 輸入格式：技能說明支持 PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、TIFF、HEIF 及 PDF；圖片可通過
ImageUrl或ImageBase64傳入（二者至少其一，同時提供時以ImageUrl爲準）。
接口域名與 Action 以官方文檔爲準：提交任務見 https://cloud.tencent.com/document/api/866/128273，查詢任務見 https://cloud.tencent.com/document/api/866/128274。騰訊雲文檔寫明默認請求併發限制爲 10 張/分鐘；技能說明中亦提到併發與計費相關約束（Submit 計費、Describe 不計費），上線前建議在控制台確認開通狀態與套餐。
安裝與啓用¶
SkillHub 頁面要求按 https://skillhub.cn/install/skillhub.md 安裝本技能。典型流程如下。
1、安裝 SkillHub CLI（若尚未安裝）
command -v skillhub && skillhub --version
未安裝時可執行完整安裝腳本（文檔推薦 CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝本技能到當前 Agent 的 skills 目錄
安裝時必須用 --dir 指向當前客戶端識別的 skills 路徑，否則默認落在 ./skills/ 可能不會被加載。文檔給出的常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令：
skillhub install @tencent-adm/tencentcloud-ocr-questionmarkagent --dir ~/.cursor/skills/
將 ~/.cursor/skills/ 換成你實際使用的目錄即可。安裝後按客戶端要求重啓或刷新技能列表。
3、配置騰訊雲密鑰與 Python 依賴
技能 SKILL.md 要求：
- Python 3.6+
pip install tencentcloud-sdk-python- 環境變量
TENCENTCLOUD_SECRET_ID、TENCENTCLOUD_SECRET_KEY
典型用法¶
技能包內提供 scripts/main.py，負責提交任務並輪詢，適合在 Agent 指導下本地試跑或集成到流水線。
整卷批改（URL，輸出知識點與正確答案）
python scripts/main.py --image-url "https://example.com/exam_paper.jpg" \
--question-config '{"KnowledgePoints":true,"TrueAnswer":true}'
單題批改並傳入參考答案
python scripts/main.py --image-url "https://example.com/single_question.jpg" \
--single-question --reference-answer "x=2"
開啓深度思考、或輸出原始 JSON
python scripts/main.py --image-url "https://example.com/exam.jpg" --enable-deep-think
python scripts/main.py --image-url "https://example.com/exam.jpg" --raw
在 Agent 對話中，當用戶描述「批改這張試卷」「識別手寫答案並判對錯」「輸出知識點」等意圖時，模型應加載本 Skill，按上述參數表選擇 ImageUrl/ImageBase64、BoolSingleQuestion、QuestionConfigMap 等字段。查詢接口可選傳 UserAgent，技能說明建議固定爲 Skills 以便來源追蹤。
格式化成功結果會包含任務 ID、任務狀態、切題數量、按題號組織的批改結果等；失敗時需結合 JobStatus、ErrorCode、ErrorMessage 以及文檔中的錯誤碼（如未開通服務 FailedOperation.UnOpenError、欠費等）排查。
適用場景與注意¶
適合誰
- 做 K12 作業批改、錯題本、教研輔助的開發者，希望 Agent 自動走騰訊雲官方 OCR Agent 接口。
- 需要在結構化 JSON 裏拿到正誤、解析、知識點、手寫區域座標，而不是純自然語言點評的團隊。
使用注意
- 必須先開通騰訊雲試題批改 Agent 相關服務並保證賬號計費正常；否則可能返回未開通或欠費類錯誤。
- 圖片建議分辨率不低於約 600×800，Base64 編碼後不超過 10M；
ImageUrl下載時間不宜超過約 3 秒，文檔建議優先使用騰訊雲 COS 地址。 - PDF 按頁識別時需指定
PdfPageNumber，技能說明爲單頁識別場景。 MarkInfo可能多層嵌套子題，解析結果時不要假設只有一層。- SkillHub 側該技能標籤爲需 API Key；請勿把密鑰寫入倉庫，僅通過環境變量或密鑰管理服務注入。
SkillHub 統計（抓取時點）：評分 100000，下載 4124，安裝 235。具體數據以 SkillHub 頁面實時顯示爲準。
結尾¶
若你的 Agent 工作流裏經常出現「上傳試卷 → 切題批改 → 結構化回傳」這一條鏈路，可以把 騰訊雲試題批改 Agent 當作對接騰訊雲 OCR 的固定技能：安裝到本機 skills 目錄、配置 TENCENTCLOUD_SECRET_ID / TENCENTCLOUD_SECRET_KEY，再按 Submit/Describe 異步模式調用即可。
官方地址：https://api.skillhub.cn/tencent-adm/tencentcloud-ocr-questionmarkagent
