前言¶
合同、发票、报告一类材料往往以扫描件或 PDF 形式流转。要把其中的关键信息写进业务系统，常见做法是固定模板 OCR 或手写解析规则：版式一变就要改代码，表格和键值混排时维护成本更高。若希望由 Agent 在对话里按「字段名 + 类型 + 提示词」发起抽取，并把结果落成结构化数据，需要一套与腾讯云 ExtractDocAgent 对齐的调用说明。下面介绍 SkillHub 上的 腾讯云实时文档抽取 Agent（坐标 @tencent-adm/tencentcloud-ocr-extractdocagent），由腾讯云文字识别团队发布，当前版本 1.0.3，来源为 enterprise，分类 office-efficiency。
这是什么¶
该 Skill 面向 腾讯云实时文档抽取 Agent（ExtractDocAgent） 的接口调用：当用户需要从 图片或 PDF 中，按 自定义字段名称 做结构化信息抽取时，应使用此技能。它把「如何组织字段、如何区分 KV 与表格、如何写字段提示词」等约定写进 Agent 可遵循的 SKILL 文档，减少每次从零查云 API 文档的成本。
SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/tencentcloud-ocr-extractdocagent
技能 API 入口：https://api.skillhub.cn/tencent-adm/tencentcloud-ocr-extractdocagent
核心功能¶
以下能力均来自官方简介，安装后具体参数以技能包内 SKILL.md 为准。
- 输入形态：支持图片与 PDF 作为抽取源。
- 自定义字段：可按业务需要定义字段名称，而非绑定单一固定模板。
- 字段类型：支持 KV 对 与 表格字段 两类，便于同时处理「抬头信息」与「明细行」。
- 字段提示词：可为字段附带提示词，用于约束抽取语义或消歧。
- 场景覆盖：官方说明适用于合同、发票、报告等文档的结构化数据抽取。
技能标签标明 requires_api_key=true，使用前需准备腾讯云文字识别相关 API 凭证，并在 Agent 环境中按技能说明配置。
安装与启用¶
SkillHub 页面给出的安装方式是：让 AI 根据通用安装文档安装本坐标技能。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencentcloud-ocr-extractdocagent`。
若本机已安装 skillhub CLI，可按安装文档第三节将技能装到当前 Agent 的 skills 目录（必须使用 --dir，否则默认目录可能不被识别）：
command -v skillhub && skillhub --version
未安装 CLI 时，安装文档提供一键脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装指定技能示例（将 <skills 目录> 替换为当前环境路径）：
skillhub install @tencent-adm/tencentcloud-ocr-extractdocagent --dir <skills 目录>
安装文档列出的常用路径包括：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
不同客户端目录不同；装好后按各自产品说明刷新或重启 Agent，使技能生效。
典型用法¶
官方未在 SkillHub 摘要页展开完整请求示例，典型流程可按技能定位理解，并在对话中交给已启用该 Skill 的 Agent 执行：
- 提供待抽取的 图片或 PDF（本地路径或 Agent 可访问的地址，以技能内约定为准）。
- 说明要抽取的 字段列表：每个字段包含名称、类型（KV 或表格字段），必要时附上 字段提示词。
- Agent 按
SKILL.md调用 ExtractDocAgent，返回结构化结果（键值与表格分区），便于写入数据库或下游表单。
例如发票场景可定义「发票代码、开票日期」为 KV 字段，将「商品明细」定义为表格字段，并为「税率」字段写提示词以避免与金额混淆。具体字段 JSON 结构与鉴权头以安装后的技能文档与腾讯云 OCR 官方接口说明为准。
适用场景与注意¶
适合谁
- 需要在 Agent 工作流里做 非固定版式 文档抽取的开发者或业务自动化搭建者。
- 已使用或计划使用腾讯云文字识别 ExtractDocAgent，希望把调用规范固化成可复用 Skill 的团队。
使用注意
- API Key：
requires_api_key=true，未配置凭证时无法完成真实调用。 - 来源与合规：技能来源为 enterprise，由腾讯云文字识别团队维护；涉及文档上传与云侧处理时，需遵守企业数据与合规要求。
- 版本：SkillHub 当前展示版本为 1.0.3；升级可用
skillhub按同一坐标更新，并核对变更说明。 - 社区数据（SkillHub 页面，供选型参考）：评分 100000，下载 3252，安装 249。
结尾¶
腾讯云实时文档抽取 Agent Skill 把 ExtractDocAgent 的「自定义字段 + KV/表格 + 提示词」能力封装成 Agent 可执行的调用规范，适合合同、发票、报告等结构化抽取场景。安装与优先源配置见 https://skillhub.cn/install/skillhub.md ，技能详情见 https://www.skillhub.cn/skills/tencent-adm/tencentcloud-ocr-extractdocagent 。
