1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-document-intelligence-MicrosoftDocs-Agent-Skills |
| 作者/维护者 | Microsoft（MicrosoftDocs 官方文档团队） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-document-intelligence |
| 许可证 | CC BY 4.0（仓库整体，来自 GitHub API） |
| GitHub Stars | 734（仓库整体；来自 GitHub API，合集仓库共享，不代表本技能自身热度） |
| Forks | 117（仓库整体，来自 GitHub API） |
| 最新版本 | 无独立版本号，随 Microsoft Learn 文档同步滚动生成；本子技能内容生成于 2026-08-31（来自 SKILL.md metadata），子目录最近一次提交同为 2026-08-31（来自 GitHub API） |
| 安装方式 | 插件市场一键安装，或手动克隆仓库后复制子目录 |
2. 功能介绍与亮点
这是一份把 Azure AI Document Intelligence（文档解析/表单识别/OCR 服务）官方文档蒸馏成的结构化专家知识库。SKILL.md 用分类索引表组织八大主题——故障排查、最佳实践、决策指南、限额与配额、安全、容器配置、集成与编码模式、部署，每个主题标注精确行号区间供 agent 按需读取；正文附带 28 条 Microsoft Learn 官方链接。
亮点：① 官方第一方出品，覆盖从自定义模型训练标注、模型选型与成本估算、迁移到 v4.0，到容器化离线部署、灾备方案的完整生命周期知识；② 集成章节专门给出 AnalyzeDocument API 返回结果解析、Markdown 输出消费方式，以及与 Azure Functions、Logic Apps 对接构建端到端文档处理流水线的具体做法；③ 安全章节涵盖 SAS 令牌、客户管理密钥的静态加密、托管标识与 VNET 接入等企业级安全配置指南；④ 限额章节列出批量分析、容器镜像版本与各预置模型的语言/区域支持范围，便于评估落地可行性；⑤ 内容生成于 2026-08-31，是该仓库内近期更新最及时的子技能之一。
3. 适用场景
所属分类：数据分析与可视化（技能内容围绕“从非结构化文档中抽取结构化数据”展开——自定义模型训练、AnalyzeDocument 输出解析、批量分析限额，本质是数据抽取与处理能力；不涉及连接/操作某个具体外部系统，也不是针对某一编码技术栈的通用编程指南，故不落集成或工程效率）。
适合需要从发票、合同、身份证件、表格等文档中自动抽取结构化数据的团队：训练自定义提取模型并优化准确率、把 AnalyzeDocument/Markdown 输出接入下游数据管道、评估容器化离线部署或迁移到 API v4.0 的工程与数据团队，可以用它快速定位官方操作步骤，减少在文档智能这一专业领域里来回查阅分散文档的成本。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——SKILL.md 格式原生识别，官方提供插件市场一键安装命令，文档抓取可用 mcp_microsoftdocs 或内置 WebFetch。
- Codex CLI：⚠️ 需适配——官方仓库列出 Codex CLI 安装路径，但 Codex 默认沙箱不带网络访问，本技能的文档抓取功能依赖联网，需用户显式开启网络权限才能完整发挥效果。
- OpenClaw：✅ 原生支持（格式层面）——SKILL.md 与 Claude Code 采用同一开放标准，可直接复制安装，但需自行确认平台是否提供等效的网页抓取工具。
- Hermes Agent：❓ 未验证——遵循同一 SKILL.md 开放标准，具体网络抓取能力未逐一核实。
5. 推荐理由
把分散在 Microsoft Learn 里的 Document Intelligence 自定义模型训练、限额规划、安全配置与容器化部署知识整理成可按需检索的结构化索引，尤其是“选对模型版本”“估算与优化调用成本”“解析 AnalyzeDocument 返回结果接入下游系统”这类文档抽取项目最容易踩坑的环节，一份索引即可定位齐全，帮助工程团队减少反复查阅官方文档的往返成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Microsoft 是 Azure Document Intelligence 所属产品的第一方所有者；所属仓库共 734 星（合集仓库整体数据，不代表本技能自身热度）；网络搜索仅见官方博客与文档更新说明，未见该子技能自身独立的第三方评测或讨论 |
| 可用性 | 9 | 插件市场一条命令即可安装，SKILL.md 索引结构完整、覆盖 8 大主题共 28 条官方链接，涵盖从模型训练到容灾部署的完整生命周期；内容与子目录均于 2026-08-31 生成/提交，维护及时；Document Intelligence 服务本身持续迭代（已推出 v4.0），非停滞项目 |
| 安全性 | 9 | 纯参考文档类内容，无代码执行；联网仅为抓取 Microsoft 官方文档页面，目标透明；License（CC BY 4.0）明确，未发现可疑指令或隐蔽外发 |
安全检查清单：①无 shell 命令执行；②仅联网抓取 learn.microsoft.com 官方文档页面，无其他数据外发；③无需 API key/凭据（技能本身不索取，实际调用 Document Intelligence 服务时的密钥管理属用户自行配置的 Azure 资源，不在本技能范围内）；④SKILL.md 全文为分类索引与官方链接表，未见 prompt injection 迹象；⑤作者为 Microsoft 官方团队，无造假迹象；⑥License 明确（CC BY 4.0）；⑦子目录最近提交与仓库最近整体推送时间接近，维护活跃。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| azure-ai-vision（同合集内） | 同一仓库参考技能，聚焦通用图像分析——物体检测、图像描述、OCR 文字读取 | 面向“看懂一张图片里有什么”；本技能面向“从结构化/半结构化文档中抽取字段与表格数据”，两者服务不同的输入类型与产出结构 |
| azure-custom-vision（同合集内） | 同一仓库参考技能，聚焦训练自定义图像分类/物体检测模型 | 面向通用视觉分类任务；本技能专精文档场景的字段级结构化抽取（发票、表单、身份证件），是更垂直的文档处理能力 |
| pdf-anthropics-skills（第三方产品，非本仓库） | 面向本地 PDF 文件的合并、拆分、表单填写等文件级操作 | 处理的是“这份 PDF 文件本身怎么改”；本技能是调用 Azure 云端 AI 服务从文档内容中抽取结构化数据的开发指南，服务对象是构建文档处理管道的工程团队而非直接操作文件的用户 |
8. 用户评价
该技能所属 SKILL.md 索引本身在第三方渠道尚无具名用户评价；针对其索引的底层产品 Azure AI Document Intelligence，网络搜索仅发现 Microsoft 官方文档与产品更新说明，未见独立第三方博客或论坛针对该产品的具名评测。
9. 其他补充
该仓库整体按 Compute、集成、数据与分析、AI/ML、安全与身份、网络、基础设施、管理、专项等类别组织了 200 余个同结构技能，覆盖 Azure 几乎全部主流服务；官方维护了一份 docs/BUNDLES.md 精选包清单，按场景打包常用技能组合。
10. 安装使用方式
- 插件市场（Claude Code）：
/plugin marketplace add MicrosoftDocs/agent-skills，再执行/plugin install azure-agent-skills@microsoft-agent-skills，随后运行/reload-plugins或重启生效，将安装该仓库全部技能。 - 插件市场（Codex）：
codex plugin marketplace add MicrosoftDocs/agent-skills，再从/plugins浏览器中选择安装azure-agent-skills；安装后需确认 Codex 的网络访问权限已开启（默认沙箱不联网），否则技能无法拉取文档正文。 - 手动安装（适用于 OpenClaw / Hermes Agent 等其他 agent）：克隆仓库后，将
skills/azure-document-intelligence/目录复制到本地 agent 的 skills 路径（如.claude/skills/、.hermes/skills/等，具体路径因 agent 而异）。 - 使用前无需额外认证或 API key；技能触发后会在需要时通过
mcp_microsoftdocs:microsoft_docs_fetch（如已安装 Microsoft Docs MCP）或普通网页抓取工具拉取具体文档正文。
11. 注意事项
- 技能内容为预编译的文档索引而非实时文档镜像，若
generated_at元数据显示的生成时间超过 3 个月，SKILL.md 会提示 agent 建议用户拉取仓库最新版本。 - 默认安装方式是整套插件（200 余个技能一次性安装），若只想安装
azure-document-intelligence单个技能，需改用手动复制目录的方式。 - 跨 Agent 兼容性仅确认 Claude Code 原生支持；Codex 需手动开启网络访问权限，OpenClaw、Hermes Agent 均需手动复制目录完成适配。
- 技能明确声明不适用于 Azure AI Vision、Azure AI Search、Azure AI Custom Vision、Azure AI Video Indexer，误用场景应改用仓库内对应的姊妹技能。
- 技能本身不执行任何本地代码，但依赖网络访问拉取 Microsoft Learn 页面，离线环境下只能使用 SKILL.md 内置的分类目录与直链列表，无法获取链接指向的具体文档正文。