关于 azure-document-intelligence
azure-document-intelligence 是面向 Azure AI Document Intelligence 使用者的 Agent 技能,涵盖模型选择、配置、集成和部署指导,并结合本地速查内容与远程文档获取。
主要功能
- 01模型选择与迁移指导
- 02自定义模型训练建议
- 03API 错误与延迟排查
- 04容器与安全配置
- 05SDK、REST 和工作流集成
适用场景
- 01选择适合的文档分析模型
- 02改进自定义模型的准确度
- 03排查 API 错误或服务延迟
- 04规划容器或离线部署
MCP 相关
技能可通过 mcp_microsoftdocs 的 microsoft_docs_fetch 获取远程文档;也可使用 fetch_webpage 作为备用方式。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-document-intelligence安装后在 Claude Code 中输入/azure-document-intelligence确认已加载。
详细介绍
Azure AI Document Intelligence 技能
此技能提供有关 Azure AI Document Intelligence 的专业指导,涵盖故障排除、最佳实践、决策、限制和配额、安全性、配置、集成和编码模式,以及部署。它结合了本地快速参考内容与远程文档获取功能。
如何使用此技能
IMPORTANT for Agent:使用下方的类别索引查找相关部分。对于带有行范围的类别(例如
L35-L120),使用read_file读取指定行。对于带有文件链接的类别(例如[security.md](security.md)),使用read_file读取链接的参考文件
IMPORTANT for Agent:如果
metadata.generated_at已超过 3 个月,请建议用户从存储库拉取最新版本。如果mcp_microsoftdocs工具不可用,请建议用户安装:安装指南
此技能需要网络访问权限来获取文档内容:
- 首选:使用
mcp_microsoftdocs:microsoft_docs_fetch,并添加查询字符串from=learn-agent-skill。返回 Markdown。 - 备用:使用
fetch_webpage,并添加查询字符串from=learn-agent-skill&accept=text/markdown。返回 Markdown。
类别索引
| 类别 | 行 | 描述 |
|---|---|---|
| 故障排除 | L36-L42 | 诊断延迟、理解并修复 Document Intelligence API 错误代码,以及处理已知服务问题和限制。 |
| 最佳实践 | L43-L54 | 有关设计、训练、标注、组合和维护自定义模型、分类模型及模板模型的指导,以最大限度地提高 Document Intelligence 的准确性和置信度 |
| 决策 | L55-L61 | 选择合适的 Document Intelligence 模型、估算和优化用量/成本,以及规划或执行从早期版本迁移到 v4.0。 |
| 限制和配额 | L62-L72 | 有关容量限制、配额、支持的语言/区域设置、通过批量分析和附加功能进行扩展,以及用于在不同层级部署 Azure Document Intelligence 的容器映像标记的文档。 |
| 安全性 | L73-L80 | 保护 Document Intelligence 资源:创建 SAS 令牌、配置使用客户管理密钥进行静态数据加密,以及使用托管标识和 VNET 实现安全访问。 |
| 配置 | L81-L85 | 如何在容器中配置并运行 Azure Document Intelligence,包括环境设置、网络、存储、许可,以及本地或混合场景的部署选项。 |
| 集成和编码模式 | L86-L95 | 使用 Document Intelligence API/SDK、解读 AnalyzeDocument/Markdown 输出,以及与 Azure Functions 或 Logic Apps 集成,以构建端到端文档处理工作流 |
| 部署 | L96-L102 | 在 Docker 中或脱机运行 Document Intelligence、部署标注工具,以及为模型和服务设置具备韧性且可应对灾难的部署 |
故障排除
| 主题 | URL |
|---|---|
| 排查 Azure Document Intelligence 延迟问题 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/troubleshoot-latency?view=doc-intel-4.0.0 |
| 查阅并解决 Document Intelligence API 错误 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/resolve-errors?view=doc-intel-4.0.0 |
| 处理 Azure Document Intelligence 中的已知问题 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/reference/known-issues?view=doc-intel-4.0.0 |
最佳实践
决策
| 主题 | URL |
|---|---|
| 选择合适的 Azure Document Intelligence 模型 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/choose-model-feature?view=doc-intel-4.0.0 |
| 估算 Document Intelligence 用量和成本 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/estimate-cost?view=doc-intel-4.0.0 |
| 决定是否迁移到 Document Intelligence v4.0 并完成迁移 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/versioning/migration-guide-overview?view=doc-intel-4.0.0 |
限制和配额
安全性
| 主题 | URL |
|---|---|
| 为 Document Intelligence 存储创建 SAS 令牌 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/create-sas-tokens?view=doc-intel-4.0.0 |
| 管理 Document Intelligence 的静态数据加密和 CMK | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/encrypt-data-at-rest?view=doc-intel-4.0.0 |
| 使用托管标识和 VNET 保护 Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/managed-identities-secured-access?view=doc-intel-4.0.0 |
| 为 Document Intelligence 配置托管标识 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/managed-identities?view=doc-intel-4.0.0 |
配置
| 主题 | URL |
|---|---|
| 配置 Azure Document Intelligence 容器 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/configuration?view=doc-intel-4.0.0 |
集成与编码模式
| 主题 | URL |
|---|---|
| 有效使用 AnalyzeDocument API 响应对象 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/analyze-document-response?view=doc-intel-4.0.0 |
| 使用 Document Intelligence Markdown 输出 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/markdown-elements?view=doc-intel-4.0.0 |
| 通过 SDK 和 REST 集成 Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/use-sdk-rest-api?view=doc-intel-4.0.0 |
| 使用 Document Intelligence SDK 和 REST API | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/quickstarts/get-started-sdks-rest-api?view=doc-intel-4.0.0 |
| 使用 Azure Functions 和 Document Intelligence 处理文档 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/tutorial/azure-function?view=doc-intel-4.0.0 |
| 将 Document Intelligence 集成到 Azure Logic Apps | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/tutorial/logic-apps?view=doc-intel-4.0.0 |
部署
| 主题 | URL |
|---|---|
| 离线运行 Document Intelligence 容器 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/disconnected?view=doc-intel-4.0.0 |
| 安装并运行 Document Intelligence Docker 容器 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/install-run?view=doc-intel-4.0.0 |
| 为 Document Intelligence 模型实现灾难恢复 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/disaster-recovery?view=doc-intel-4.0.0 |
| 部署 Document Intelligence 示例标注工具 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/v21/deploy-label-tool?view=doc-intel-2.1.0 |
评论
支持 Markdown