Build Azure Document Intelligence Workflows

技能简介

Build Azure Document Intelligence Workflows 是一款面向 TypeScript 开发者的 Azure 文档智能工作流技能。企业在处理发票、合同、表单、收据等大量文档时，往往需要从非结构化 PDF 或图像文件中提取结构化数据。Azure Document Intelligence（前称 Form Recognizer）提供了强大的预训练模型来应对这一挑战，但正确调用 Azure REST SDK、处理异步操作、管理自定义模型并不简单——该技能为此提供经过安全审计的 TypeScript 实践指南。

技能覆盖从客户端配置、文档分析、分类器训练到异步轮询的完整链路，帮助开发者在 AI 编码助手中快速搭建生产级文档提取流程。

核心能力

• 多认证方式配置：支持 DefaultAzureCredential（托管身份）和 API Key 两种认证方式适配不同部署环境。
• 远程与本地文档分析：既可分析 Azure Blob 远程 URL 文档，也可处理本地文件，灵活满足各类业务场景。
• 多模型支持：内置对预构建模型的支持，包括发票（invoice）、收据（receipt）、通用布局（layout）、文档（document）等，并支持自定义模型。
• 自定义模型训练：基于 Azure Blob Storage 中的标注数据，训练文档分类器和自定义模板/神经网络模型。
• 异步长运行操作处理：正确使用 Azure SDK 的 Long-Running Operation Poller 处理分析任务的异步完成。
• 结构化结果提取：从分析结果中提取页面信息、表格数据、关键字段（发票号、金额、日期等）及置信度评分。

安装配置

环境要求

• Node.js 18+ 和 npm/yarn
• Azure Document Intelligence 资源（端点 + 密钥）
• 必需的 npm 包：@azure-rest/ai-document-intelligence 或 @azure/ai-form-recognizer
• 适合的 AI 助手：Claude、Codex、Claude Code

安装步骤

1. 安装技能：

   npx skillstore add sickn33/azure-ai-document-intelligence-ts

2. 安装 Azure SDK：

   npm install @azure-rest/ai-document-intelligence

3. 配置环境变量：在 .env 中添加：

   DOCUMENT_INTELLIGENCE_ENDPOINT=https://.cognitiveservices.azure.com/
   DOCUMENT_INTELLIGENCE_API_KEY=

4. 在 AI 助手中加载技能：通过 prompt 模板引用技能，AI 将提供对应的代码模式和配置指导。
5. 准备测试文档：将待分析的 PDF 或图像文件准备好，技能将引导完成从配置到结果提取的完整流程。

使用步骤

1. 配置客户端：使用 prompt 模板获取 TypeScript 客户端初始化代码，选择适合的认证方式（DefaultAzureCredential 或 API Key）。
2. 执行文档分析：提供文档路径（本地或远程 URL），调用预构建模型进行分析，等待异步操作完成。
3. 提取结构化数据：从分析结果中读取关键字段（如发票金额、供应商名称、日期）和表格数据，结合置信度进行数据质量判断。
4. 构建分类流程：如需处理多类型文档，使用技能指导构建文档分类器，先分类再选择对应模型分析。
5. 错误处理与重试：应用技能中的 isUnexpected 错误检查模式和重试逻辑，构建健壮的生产流程。

适用场景

• 财务发票自动化：将大量供应商发票自动提取结构化数据，导入财务系统或 ERP，减少人工录入成本。
• 合同关键条款提取：从 PDF 合同中自动提取签署方、日期、金额、终止条款等关键字段，供法务或审计系统使用。
• 人力资源文档处理：自动提取简历、入职表格、证明文件中的结构化信息，提升 HR 流程效率。
• 医疗单据处理：从医疗表单、检查报告等文档中提取患者信息和诊断数据，支持医疗信息化系统。

适用人群

• TypeScript 全栈开发者：需要快速集成 Azure 文档智能服务的 Node.js/TypeScript 工程师。
• 企业数字化转型团队：负责将纸质文档流程数字化的技术实施人员。
• AI 应用架构师：设计智能文档处理流程，需要可靠 SDK 使用参考的架构师。

工作原理

该技能本质上是一份经过安全审计的 TypeScript/Azure SDK 实践指南。Azure Document Intelligence 的分析操作是异步的——提交文档后，服务返回一个 Operation-Location URL，客户端需要轮询该端点直到状态变为 succeeded。技能中的核心模式包括：

认证配置 → 创建客户端 → 提交分析任务（返回 poller）→ 轮询直到完成 → 读取结构化结果 → 错误处理与置信度过滤。

对于自定义模型，技能指导通过 Azure Blob Storage 上传标注数据、触发模型训练、轮询训练完成，然后使用训练好的模型 ID 进行分析。所有示例代码均使用 TypeScript 强类型接口，避免了运行时类型错误。

官方链接

• 技能主页：https://skillstore.io/skills/sickn33-azure-ai-document-intelligence-ts
• 安装命令：npx skillstore add sickn33/azure-ai-document-intelligence-ts
• 源码仓库：https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-ai-document-intelligence-ts
• 支持工具：Claude、Codex、Claude Code
• 风险评级：safe（已通过安全审计）