azure-document-intelligence について
azure-document-intelligenceは、Azure AI Document Intelligenceの利用者向けエージェントスキルです。ローカルのクイックリファレンスとリモート文書を用いて、モデル選択、設定、連携、問題診断、デプロイを案内します。
主な機能
- 01モデル選択と移行の案内
- 02カスタムモデルの学習ガイダンス
- 03APIエラーと遅延の診断
- 04コンテナーとセキュリティの設定
- 05SDK、REST、ワークフロー連携
活用シーン
- 01適切な文書分析モデルの選択
- 02カスタムモデルの精度向上
- 03APIエラーやサービス遅延の調査
- 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 に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートのドキュメント取得機能を組み合わせています。
このスキルの使用方法
Agent への重要な注意:関連するセクションを探すには、以下のカテゴリインデックスを使用してください。行範囲が示されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルへのリンクが示されているカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください
Agent への重要な注意:
metadata.generated_atが3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに案内してください。mcp_microsoftdocsツールを利用できない場合は、インストールするようユーザーに案内してください:インストールガイド
このスキルでは、ドキュメントの内容を取得するためにネットワークアクセスが必要です:
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown が返されます。 - 代替手段:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L36-L42 | レイテンシーの診断、Document Intelligence API のエラーコードの理解と修正、既知のサービスの問題や制限への対処について説明します。 |
| ベストプラクティス | L43-L54 | Document Intelligence の精度と信頼度を最大化するために、カスタムモデル、分類モデル、テンプレートモデルの設計、トレーニング、ラベル付け、構成、保守を行う方法を説明します |
| 意思決定 | L55-L61 | 適切な Document Intelligence モデルの選択、使用量とコストの見積もりおよび最適化、旧バージョンから v4.0 への移行計画や実行について説明します。 |
| 制限とクォータ | L62-L72 | 容量制限、クォータ、サポートされる言語とロケール、バッチ分析やアドオンを使用したスケーリング、Azure Document Intelligence を異なる階層でデプロイするためのコンテナーイメージタグに関するドキュメントです。 |
| セキュリティ | L73-L80 | SAS トークンの作成、カスタマー マネージド キーを使用した保存データの暗号化の構成、セキュアなアクセスのためのマネージド ID と VNET の使用など、Document Intelligence リソースの保護について説明します。 |
| 構成 | 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 |
| マネージド ID と 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 のマネージド ID を構成する | 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 |
|---|---|
| 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 Sample Labeling ツールをデプロイする | https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/v21/deploy-label-tool?view=doc-intel-2.1.0 |