Azure 文档智能 .NET 技能
帮助 .NET 开发者从发票、收据、身份证件和表单中提取结构化信息。
技能明确列出端点、API 密钥、Entra 凭据和 Blob SAS 的配置，并建议生产环境使用 DefaultAzureCredential，具备基本数据流透明度；但示例直接支持 API 密钥和 SAS，未说明敏感文档、密钥轮换、最小 RBAC 权限、外部上传/读取影响、删除模型的确认或回滚，因此扣分。
文档覆盖安装、认证、分析、分类、训练、模型管理和基础异常处理，快乐路径较完整；但没有针对该技能的测试或可执行验证，未处理空环境变量、无效 URI、权限不足、长时间操作失败、字段缺失和版本兼容性，且删除模型示例没有保护措施，因此静态评分受限。
描述、触发词、主要用户场景和 .NET 包范围较清楚，覆盖发票、收据、身份证、表格及自定义模型；但未明确不适用场景、输入限制、输出契约、地区/服务可用性和中文文档支持，也没有说明中国大陆网络可达性，故扣分。
具备标准 SKILL.md 元数据、MIT 许可证、版本号、安装说明、分层章节、示例、最佳实践、错误处理、相关 SDK 和参考链接，维护入口基本可追溯；但缺少变更日志、明确维护责任、已知限制、故障排查、兼容矩阵和 FAQ，版本信息也未说明如何更新，因此未满分。
提供了可直接改写的 C# 片段，覆盖分析文本/表格、预置模型、自定义模型、分类和模型管理，能完成核心 SDK 导向任务；但示例依赖外部文档 URI、未提供完整可运行项目或输入校验，敏感数据治理、分页、重试和结果持久化缺失，且没有该技能的输出验证证据，因此静态评分保守。
技能给出 NuGet、API 文档、样例和模型参考链接，具备一定可追溯性；但本次材料未提供该路径的提交测试、CI 覆盖或第三方执行结果，仓库测试证据是通用 harness 而非该技能的关键路径，无法支持更高分。
- 不要将 API 密钥、SAS URL 或身份证、发票等敏感文档硬编码或记录到日志；应使用最小权限凭据、轮换机制和安全存储。
- 执行 DeleteModelAsync 前应增加明确的用户确认、权限检查和可恢复备份/替代方案。
- 在采用示例前，请依据锁定的 Azure.AI.DocumentIntelligence 版本核对 API 签名、字段类型、区域端点要求和服务配额，并补充失败重试与输入校验。
- 该技能未说明中国大陆网络可达性或中文资料支持；部署前应验证 Azure 服务端点、身份认证链路和文档数据合规要求。
它能做什么 & 适用场景
该技能为 Azure.AI.DocumentIntelligence .NET SDK 提供可直接参考的开发指导。它涵盖预构建模型和自定义模型，可提取文本、表格、字段、版面结构并分类文档。内容包括 Microsoft Entra 身份验证、API 密钥身份验证、长时间运行操作、自定义模型和分类器管理。适合已使用 Azure 文档智能服务、希望让编码代理生成相关 .NET 代码的团队。
指导安装 Azure.AI.DocumentIntelligence 和 Azure.Identity NuGet 包，配置文档智能端点、API 密钥、Blob 容器 SAS URL 和 Azure 凭据环境变量。它展示如何使用 DocumentIntelligenceClient 分析发票、收据、身份证件及一般版面，读取文本、行、单词、表格和字段；也展示如何使用 DocumentIntelligenceAdministrationClient 构建、查询、列出和删除自定义模型及文档分类器。示例代码调用 Azure 服务并产生 AnalyzeResult、模型详情、分类结果及置信度信息。
- 处理财务团队收到的发票，并提取供应商、明细项目和总额。
- 为零售或费用报销应用解析收据中的商户、金额和交易日期。
- 为身份验证流程提取身份证件中的姓名、出生日期和地址。
- 从 PDF 或表单中提取页面文本、表格、选择标记和版面结构。
- 企业拥有固定或可变版式文档时，构建并管理自定义模型和分类器。
优缺点一览
- 覆盖发票、收据、身份证件、版面分析、自定义模型和分类器等具体工作流。
- 同时提供 API 密钥和 Microsoft Entra 身份验证示例。
- 包含客户端类型、预构建模型、关键类型、构建模式和错误处理参考。
- 明确建议复用线程安全客户端并检查字段置信度。
- 内容聚焦 Azure.AI.DocumentIntelligence .NET SDK，不适合非 .NET 或非 Azure 文档分析项目。
- 需要可用的 Azure 文档智能端点；自定义模型训练还需要 Blob 容器 SAS URL。
- 源材料没有说明服务成本、配额、性能基准或具体代理平台的独立测试结果。
- 示例主要使用远程文档 URI，未提供本地文件输入示例。
如何安装
安装整个 Agent Skills 集合：
npx skills add microsoft/skills
随后在向导中选择需要的技能。该技能位于：.github/plugins/azure-sdk-dotnet/skills/azure-ai-document-intelligence-dotnet/SKILL.md。SDK 包安装命令为：
dotnet add package Azure.AI.DocumentIntelligence
dotnet add package Azure.Identity
具体编码代理的激活或配置步骤，源材料未单独说明。
如何使用
在编码代理中提出包含触发词的请求，例如："使用 DocumentIntelligenceClient 为 .NET 应用实现发票提取，并检查字段置信度。" 也可以请求实现 receipt OCR、文档版面提取、自定义文档模型或文档分类器。代码需要配置 DOCUMENT_INTELLIGENCE_ENDPOINT；API 密钥认证还需要 DOCUMENT_INTELLIGENCE_API_KEY，使用生产环境 DefaultAzureCredential 时需要配置 AZURE_TOKEN_CREDENTIALS=prod。Microsoft Entra 身份验证要求使用自定义子域端点，而不是区域端点。
对比同类
源材料明确将 Azure.AI.FormRecognizer 列为已弃用的旧 SDK，并建议新项目使用 Azure.AI.DocumentIntelligence。