前言¶
教育类产品里常见需求是：用户上传试卷或单题照片，系统要完成切题、识别手写答案、判断对错，并尽量给出解析与知识点。若只在对话里让大模型「看图批改」，往往缺少稳定的切题坐标、计费口径和与云侧一致的字段结构。
下面介绍 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
