前言¶
合同、發票、報告一類材料往往以掃描件或 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 。
