菜单
腾讯云实时文档抽取Agent(ExtractDocAgent)接口调用技能。当用户需要从图片或PDF中按自定义字段名称进行结构化信息抽取时，应使用此技能。支持自定义字段名称、字段类型（KV对或表格字段）和字段提示词，实现灵活的文档信息提取。适用于合同、发票、报告等各类文档的结构化数据抽取场景。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/infometa/workbuddyskills --skill tencentcloud-ocr-extractdocagent命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
快速生成公司一页纸概览（Tearsheet），涵盖业务描述、关键财务、估值、股东结构和近期催化。 触发词：公司速览、tearsheet、公司概况、一页纸、公司简介、company overview、快速了解、公司画像
构建DCF现金流折现模型和三表财务模型（利润表、资产负债表、现金流量表联动）。 触发词：DCF、现金流折现、财务建模、三表模型、估值模型、WACC、自由现金流、financial model、valuation model
盈利分析技能，支持两种模式： - Preview 模式：业绩发布前的前瞻分析、情景假设、关键观测指标 - Analysis 模式：业绩发布后的深度解读、Beat/Miss 分析、估计修正 触发词：earnings analysis、earnings preview、业绩分析、业绩前瞻、财报分析、季报解读、pre-earnings、post-earnings、Q1/Q2/Q3/Q4 results
| name | tencentcloud-ocr-extractdocagent |
| description | 腾讯云实时文档抽取Agent(ExtractDocAgent)接口调用技能。当用户需要从图片或PDF中按自定义字段名称进行结构化信息抽取时，应使用此技能。支持自定义字段名称、字段类型（KV对或表格字段）和字段提示词，实现灵活的文档信息提取。适用于合同、发票、报告等各类文档的结构化数据抽取场景。 |
| version | 1.0.3 |
| display_name | 腾讯云实时文档抽取Agent |
| display_name_en | Tencent Cloud Extract Doc Agent |
| description_zh | 调用腾讯云实时文档抽取Agent接口，支持从图片/PDF中按自定义字段名称进行结构化信息抽取。支持KV对和表格字段两种抽取类型，可通过字段提示词提升准确性。适用于合同、发票、报告等文档的自动信息提取。 |
| description_en | Tencent Cloud ExtractDocAgent API for structured information extraction from images/PDFs. Supports custom field names with KV-pair and table field extraction types. Ideal for contracts, invoices, and reports. |
| visibility | public |
调用腾讯云OCR实时文档抽取Agent接口，支持从图片/PDF中按用户自定义的字段名称进行结构化信息抽取。模型参数更小，速度更快，适用于对实时性要求高（30秒以内）且输入输出Token在2000以内的场景。
核心能力：
官方文档：https://cloud.tencent.com/document/api/866/126442
当用户提出以下需求时触发此技能：
tencentcloud-sdk-python（通过 pip install tencentcloud-sdk-python 安装）TENCENTCLOUD_SECRET_ID：腾讯云API密钥IDTENCENTCLOUD_SECRET_KEY：腾讯云API密钥Key运行 scripts/main.py 脚本完成文档结构化信息抽取。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ImageBase64 | str | 否(二选一) | 图片/PDF的Base64值，编码后不超过10M，分辨率建议600*800以上，支持PNG/JPG/JPEG/BMP/PDF，像素需介于20-10000px |
| ImageUrl | str | 否(二选一) | 图片/PDF的URL地址，都提供时只使用ImageUrl |
| ItemNames | list of ItemNames | 是 | 自定义抽取字段列表，至少提供一个 |
| PdfPageNumber | int | 否 | PDF页码，仅支持单页识别 |
ItemNames 结构：
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| KeyName | str | 是 | 要提取的字段名称，不能为空 |
| KeyType | int | 否 | 默认0；0=KV对，1=表格字段 |
| KeyPrompt | str | 否 | 字段描述/提示词，用于提升抄取准确性 |
| UserAgent |
| str |
| 否 |
请求来源标识(可选)，用于追踪调用来源，统一固定为Skills |
识别成功后返回 JSON 格式结果：
格式化输出模式（默认）：
{
"抽取结果": [
{
"组序号": 1,
"字段列表": [
{
"字段名(自动识别)": "合同编号",
"字段名(配置)": "合同编号",
"字段值": "HT-2024-001"
}
]
}
],
"旋转角度": 0.0,
"RequestId": "xxx"
}
原始输出模式（--raw）：
{
"Angle": 0.0,
"StructuralList": [
{
"Groups": [
{
"Lines": [
{
"Key": {
"AutoName": "合同编号",
"ConfigName": "合同编号"
},
"Value": {
"AutoContent": "HT-2024-001",
"Coord": { ... },
"PageIndex": "0"
}
}
]
}
]
}
],
"ErrorCode": "",
"ErrorMessage": "",
"RequestId": "xxx"
}
GroupInfo 结构：
| 字段 | 类型 | 说明 |
|---|---|---|
| Groups | list of LineInfo | 每一行的元素 |
LineInfo 结构：
| 字段 | 类型 | 说明 |
|---|---|---|
| Lines | list of ItemInfo | 每行的一个元素 |
ItemInfo 结构：
| 字段 | 类型 | 说明 |
|---|---|---|
| Key | Key | key信息组（可能返回null） |
| Value | Value | Value信息组（可能返回null） |
Key 结构：
| 字段 | 类型 | 说明 |
|---|---|---|
| AutoName | str | 自动识别的字段名称 |
| ConfigName | str | 定义的字段名称（传key的名称，可能返回null） |
Value 结构：
| 字段 | 类型 | 说明 |
|---|---|---|
| AutoContent | str | 自动识别的字段内容 |
| Coord | Polygon | 四点坐标（可能返回null） |
| PageIndex | str | 页数（可能返回null） |
| 错误码 | 含义 |
|---|---|
| FailedOperation.DownLoadError | 文件下载失败 |
| FailedOperation.ImageDecodeFailed | 图片解码失败 |
| FailedOperation.ImageSizeTooLarge | 图片尺寸过大，请确保编码后不超过10M，像素介于20-10000px |
| FailedOperation.OcrFailed | OCR识别失败 |
| FailedOperation.PDFParseFailed | PDF解析失败 |
| FailedOperation.ResponseParseFailed | 结果解析失败 |
| FailedOperation.UnKnowError | 未知错误 |
| FailedOperation.UnKnowFileTypeError | 未知的文件类型 |
| FailedOperation.UnOpenError | 服务未开通，请先在腾讯云控制台开通文档抽取Agent服务 |
| InvalidParameterValue.InvalidParameterValueLimit | 参数值错误 |
| LimitExceeded.TooLargeFileError | 文件内容太大 |
| ResourceUnavailable.InArrears | 账号已欠费 |
| ResourceUnavailable.ResourcePackageRunOut | 账号资源包耗尽 |
| ResourcesSoldOut.ChargeStatusException | 计费状态异常 |
# 通过URL抽取文档中的KV字段
python scripts/main.py --image-url "https://example.com/contract.jpg" \
--item-names '[{"KeyName":"合同编号","KeyType":0,"KeyPrompt":"文档中的合同编号"}]'
# 同时抽取KV字段和表格字段
python scripts/main.py --image-url "https://example.com/invoice.jpg" \
--item-names '[{"KeyName":"发票号码","KeyType":0},{"KeyName":"明细","KeyType":1,"KeyPrompt":"明细条目表格"}]'
# 通过文件路径(自动Base64编码)抽取
python scripts/main.py --image-base64 ./document.png \
--item-names '[{"KeyName":"姓名","KeyType":0},{"KeyName":"金额","KeyType":0}]'
# 识别PDF中的文档(指定页码)
python scripts/main.py --image-base64 ./document.pdf --pdf-page-number 2 \
--item-names '[{"KeyName":"总金额","KeyType":0}]'
# 输出原始JSON响应
python scripts/main.py --image-url "https://example.com/doc.jpg" \
--item-names '[{"KeyName":"标题","KeyType":0}]' --raw
# 指定地域
python scripts/main.py --image-url "https://example.com/doc.jpg" \
--item-names '[{"KeyName":"签署日期","KeyType":0}]' --region ap-beijing```