tencentcloud-ocr-questionmarkagent

name	tencentcloud-ocr-questionmarkagent
description	腾讯云试题批改Agent(SubmitQuestionMarkAgentJob/DescribeQuestionMarkAgentJob)接口调用技能。当用户需要对试卷图片或试题图片中的K12试卷或试题进行自动批改、手写答案识别、知识点分析时,应使用此技能。支持整卷图片批改和单题图片批改,提供题目切题、正误判定、答案对比、错误分析、知识点输出等结构化评估结果。异步接口,先提交任务再轮询查询结果。
version	1.0.3
display_name	腾讯云试题批改Agent
display_name_en	Tencent Cloud Question Mark Agent
description_zh	调用腾讯云试题批改Agent接口，面向K12教育场景，支持整卷/单题端到端批改，包含试卷切题、手写答案识别、正误判定、错误分析和知识点输出。支持深度思考模式和多种图片/PDF格式输入。
description_en	Tencent Cloud Question Mark Agent for K12 education. Supports full-paper and single-question grading with handwriting recognition, answer comparison, error analysis, and knowledge point extraction.
visibility	public

腾讯云试题批改Agent (SubmitQuestionMarkAgentJob / DescribeQuestionMarkAgentJob)

用途

调用腾讯云OCR试题批改Agent接口，面向K12教育场景的试题批改产品，支持整卷/单题端到端处理（试卷切题+题目批改+手写坐标回显），聚焦试题批改（含手写答案）和试题解析（不含手写答案）。精准输出题目、正误判定、答案对比、错误分析及知识点等结构化评估结果。低年级算式批改效果优于线上数学作业批改。

核心能力：

• 异步双接口模式：Submit 提交任务获取 JobId → Describe 轮询查询结果（DONE/FAIL 时完成）
• 整卷批改：自动切题后逐题批改，返回每道题目的批改信息
• 单题批改：跳过切题环节，直接对单题进行批改，支持传入参考答案
• 深度思考：可选开启深度思考模式，进行更深层次推理分析（速度更慢）
• 知识点输出：可配置输出题目关联的知识点信息
• 正确答案输出：可配置输出题目的正确答案
• 手写答案坐标：可配置输出手写答案在原图中的坐标位置
• 多格式输入：支持 PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、TIFF、HEIF 及 PDF 格式

官方文档：

• 提交任务：https://cloud.tencent.com/document/api/866/128273
• 查询任务：https://cloud.tencent.com/document/api/866/128274

使用时机

当用户提出以下需求时触发此技能：

• 需要对试卷图片/PDF进行自动批改
• 需要识别手写答案并判断正误
• 需要对K12试题进行批改分析
• 需要获取试题的知识点信息
• 需要获取试题的正确答案
• 需要对单道题目进行批改（含参考答案）
• 涉及试卷切题、试题解析的任何场景

环境要求

• Python 3.6+
• 依赖：tencentcloud-sdk-python（通过 pip install tencentcloud-sdk-python 安装）
• 环境变量：
  • TENCENTCLOUD_SECRET_ID：腾讯云API密钥ID
  • TENCENTCLOUD_SECRET_KEY：腾讯云API密钥Key

使用方式

运行 scripts/main.py 脚本完成试题批改。该接口为异步接口，脚本会自动提交任务并轮询查询结果。

请求参数

提交任务 (SubmitQuestionMarkAgentJob) 参数

参数	类型	必填	说明
ImageBase64	str	否(二选一)	图片/PDF的Base64值，编码后不超过10M，分辨率建议600*800以上，支持PNG/JPG/JPEG/BMP/PDF格式
ImageUrl	str	否(二选一)	图片/PDF的URL地址，下载时间不超过3秒。都提供时只使用ImageUrl。建议存储于腾讯云
PdfPageNumber	int	否	PDF页码，仅支持单页识别，默认1
BoolSingleQuestion	bool	否