azure-document-intelligence
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure AI Document Intelligence Skill
Azure AI Document Intelligence Skill
This skill provides expert guidance for Azure AI Document Intelligence. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
本Skill为Azure AI Document Intelligence提供专业指导,涵盖故障排查、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地速查内容与远程文档获取功能。
How to Use This Skill
如何使用本Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
Agent注意事项:使用下方的分类索引定位相关章节。对于带有行范围的分类(例如),使用L35-L120读取指定行内容;对于带有文件链接的分类(例如read_file),使用[security.md](security.md)读取链接的参考文件read_file
本Skill需要网络访问权限来获取文档内容:
- 推荐方式:使用,并携带查询字符串
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备选方式:使用,并携带查询字符串
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L42 | Diagnosing and fixing Document Intelligence latency problems, plus interpreting service error codes, causes, and recommended resolutions. |
| Best Practices | L43-L53 | Improving custom model accuracy and confidence, labeling and table-tagging best practices, training/classification workflows, and managing the full Document Intelligence model lifecycle |
| Decision Making | L54-L60 | Choosing the right Document Intelligence model, understanding version changes, and migrating or updating apps to API v3.1 based on changelog and migration guidance |
| Architecture & Design Patterns | L61-L65 | Guidance on designing disaster recovery, redundancy, and failover strategies for Azure AI Document Intelligence models and deployments. |
| Limits & Quotas | L66-L75 | Quotas, rate limits, capacity add-ons, batch processing scale, and supported languages/locales for OCR, prebuilt, and custom Document Intelligence models. |
| Security | L76-L83 | Securing Document Intelligence: creating SAS tokens, configuring data-at-rest encryption, and using managed identities and VNets to lock down access to resources. |
| Configuration | L84-L89 | Configuring Document Intelligence containers and building, training, and composing custom models for tailored document processing workflows. |
| Integrations & Coding Patterns | L90-L99 | Using SDKs/REST to call Document Intelligence, handle AnalyzeDocument/Markdown outputs, and integrate with apps, Azure Functions, and Logic Apps for end‑to‑end document workflows |
| Deployment | L100-L106 | Deploying Document Intelligence via Docker/containers, including image tags, offline/disconnected setups, and installing/running the service and sample labeling tool. |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排查 | L37-L42 | 诊断并修复Document Intelligence延迟问题,解读服务错误代码、原因及推荐解决方案。 |
| 最佳实践 | L43-L53 | 提升自定义模型的准确性与置信度,标注和表格标记的最佳实践,训练/分类工作流,以及管理Document Intelligence模型的完整生命周期 |
| 决策制定 | L54-L60 | 选择合适的Document Intelligence模型,了解版本变更,根据更新日志和迁移指南将应用迁移或升级至API v3.1。 |
| 架构与设计模式 | L61-L65 | 为Azure AI Document Intelligence模型和部署设计灾难恢复、冗余与故障转移策略的指导。 |
| 限制与配额 | L66-L75 | OCR、预构建和自定义Document Intelligence模型的配额、速率限制、容量附加组件、批量处理规模以及支持的语言/区域设置。 |
| 安全 | L76-L83 | 保障Document Intelligence安全:创建SAS令牌,配置静态数据加密,使用托管标识和VNet锁定资源访问权限。 |
| 配置 | L84-L89 | 配置Document Intelligence容器,构建、训练和组合自定义模型以实现定制化文档处理工作流。 |
| 集成与编码模式 | L90-L99 | 使用SDK/REST调用Document Intelligence,处理AnalyzeDocument/Markdown输出,并与应用、Azure Functions和Logic Apps集成以实现端到端文档工作流 |
| 部署 | L100-L106 | 通过Docker/容器部署Document Intelligence,包括镜像标签、离线/断开连接环境设置,以及安装和运行服务与示例标注工具。 |
Troubleshooting
故障排查
| Topic | URL |
|---|---|
| Troubleshoot Azure Document Intelligence latency issues | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/troubleshoot-latency?view=doc-intel-4.0.0 |
| Interpret and resolve Document Intelligence error codes | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/resolve-errors?view=doc-intel-4.0.0 |
| 主题 | 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错误代码 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/resolve-errors?view=doc-intel-4.0.0 |
Best Practices
最佳实践
Decision Making
决策制定
| Topic | URL |
|---|---|
| Select the right Document Intelligence model for workflows | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/choose-model-feature?view=doc-intel-4.0.0 |
| Use Document Intelligence changelog and migration guidance | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/versioning/changelog-release-history?view=doc-intel-4.0.0 |
| Migrate Document Intelligence apps to API v3.1 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/versioning/v3-1-migration-guide?view=doc-intel-4.0.0 |
| 主题 | URL |
|---|---|
| 为工作流选择合适的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/versioning/changelog-release-history?view=doc-intel-4.0.0 |
| 将Document Intelligence应用迁移至API v3.1 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/versioning/v3-1-migration-guide?view=doc-intel-4.0.0 |
Architecture & Design Patterns
架构与设计模式
| Topic | URL |
|---|---|
| Design disaster recovery for Document Intelligence models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/disaster-recovery?view=doc-intel-4.0.0 |
| 主题 | URL |
|---|---|
| 为Document Intelligence模型设计灾难恢复方案 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/disaster-recovery?view=doc-intel-4.0.0 |
Limits & Quotas
限制与配额
Security
安全
| Topic | URL |
|---|---|
| Create SAS tokens for Document Intelligence storage | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/create-sas-tokens?view=doc-intel-4.0.0 |
| Configure data-at-rest encryption for Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/encrypt-data-at-rest?view=doc-intel-4.0.0 |
| Secure Document Intelligence with managed identities and VNets | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/managed-identities-secured-access?view=doc-intel-4.0.0 |
| Configure managed identities for Document Intelligence | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/authentication/managed-identities?view=doc-intel-4.0.0 |
Configuration
配置
| Topic | URL |
|---|---|
| Configure Azure Document Intelligence containers | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/configuration?view=doc-intel-4.0.0 |
| Create and compose Document Intelligence custom models | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/compose-custom-models?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 |
| 创建并组合Document Intelligence自定义模型 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/how-to-guides/compose-custom-models?view=doc-intel-4.0.0 |
Integrations & Coding Patterns
集成与编码模式
| 主题 | 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 |
| 从应用中调用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 |
| 通过SDK与REST集成Document Intelligence | 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 |
Deployment
部署
| Topic | URL |
|---|---|
| Run Document Intelligence containers in disconnected environments | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/disconnected?view=doc-intel-4.0.0 |
| Use Document Intelligence container image tags and releases | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/image-tags?view=doc-intel-4.0.0 |
| Install and run Document Intelligence Docker containers | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/install-run?view=doc-intel-4.0.0 |
| Deploy the Document Intelligence Sample Labeling tool | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/v21/deploy-label-tool?view=doc-intel-2.1.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容器镜像标签与版本 | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/containers/image-tags?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/v21/deploy-label-tool?view=doc-intel-2.1.0 |