azure-content-understanding について
このスキルは、Foundry Tools の Azure Content Understanding を扱う開発者やアーキテクト向けに、ドキュメントや視聴覚コンテンツの分析を案内します。ローカルの参照資料と最新ドキュメントの取得方法を組み合わせています。
主な機能
- 01REST API 診断によるトラブルシューティング
- 02信頼度と根拠による精度向上
- 03ツールとモデルデプロイの選定
- 04RAG と RPA の設計
- 05アナライザーとワークフローの設定
- 06セキュリティ、制限、連携の確認
活用シーン
- 01処理や設定の障害調査
- 02ドキュメント分析と RAG システムの計画
- 03カスタムアナライザーと分類の設定
- 04REST API や SDK のエージェントへの統合
MCP 対応
このスキルは Microsoft ドキュメント取得に mcp_microsoftdocs MCP ツールを推奨し、代替手段としてウェブページ取得を案内します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-content-understandingインストール後、Claude Code で/azure-content-understandingを入力して読み込まれたか確認します。
詳細
Foundry Tools の Azure Content Understanding スキル
このスキルでは、Foundry Tools の Azure Content Understanding に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターンを扱います。ローカルのクイックリファレンスコンテンツと、ドキュメントをリモートから取得する機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent:以下のカテゴリインデックスを使用して、関連するセクションを見つけてください。行範囲が示されているカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルへのリンクがあるカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください。
IMPORTANT for 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-L40 | Content Understanding REST API の診断機能を使用して、失敗を調査し、エラーコードを解釈し、処理や構成に関する問題をトラブルシューティングします。 |
| ベストプラクティス | L41-L46 | レイアウト、ラベル、フィードバックを使って Content Understanding の精度を高めるほか、信頼度スコアとグラウンディングを使ってドキュメント分析結果を検証し、改善します。 |
| 意思決定 | L47-L55 | Azure AI ツール、モデルのデプロイ、Studio と Foundry の選択、プレビューから GA への移行、Content Understanding のコスト見積もりと最適化に関するガイダンスです。 |
| アーキテクチャと設計パターン | L56-L62 | エージェントモードを使用するタイミング、RAG ベースのドキュメントソリューションの設計方法、Azure Content Understanding を使用した RPA ワークフローの構築方法に関するガイダンスです。 |
| 制限とクォータ | L63-L68 | Content Understanding の同期呼び出しを安全に使用するためのガイダンスと、使用計画やトラブルシューティングに役立つ詳細なクォータと制限(スループット、ペイロードサイズ、同時実行数)です。 |
| セキュリティ | L69-L74 | Content Understanding のセキュリティを構成します。アナライザーの出力にガードレールを設定し、アナライザーとデータを保護し、アクセスを制御し、機密コンテンツを安全に扱います。 |
| 構成 | L75-L88 | カスタムアナライザーと Foundry リソースの作成、コピー、管理を含め、Content Understanding のアナライザー、分類器、ワークフロー、音声・映像および Markdown の出力を構成およびカスタマイズします。 |
| 統合とコーディングパターン | L89-L94 | REST/SDK 経由で Content Understanding を呼び出すパターンとコードサンプル、Microsoft Agent Framework/LangChain との統合、エージェント型ワークフローの実装方法です。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Content Understanding REST API の診断機能を使用する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/retrieve-diagnostics |
ベストプラクティス
| トピック | URL |
|---|---|
| Content Understanding の精度を高めるためのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/best-practices |
| 信頼度とグラウンディングを使ってドキュメント分析を改善する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/document/analyzer-improvement |
意思決定
| トピック | URL |
|---|---|
| ドキュメント処理に適した Azure AI ツールを選択する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/choosing-right-ai-tool |
| Content Understanding アナライザーに使用するモデルのデプロイを選択する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/models-deployments |
| Content Understanding Studio と Foundry のどちらを選ぶか | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/foundry-vs-content-understanding-studio |
| Content Understanding をプレビュー版から GA に移行する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/how-to/migration-preview-to-ga |
| Azure Content Understanding のコストを見積もり、最適化する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/pricing-explainer |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| ドキュメントにエージェントモードを使用するタイミングを判断する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/agentic-mode |
| Content Understanding を使用して RAG ソリューションを設計する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/tutorial/build-rag-solution |
| Content Understanding を使用して RPA ワークフローを設計する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/tutorial/robotic-process-automation |
制限とクォータ
| トピック | URL |
|---|---|
| Content Understanding の同期操作を安全に使用する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/quickstart/use-synchronous-rest-api |
| Content Understanding のクォータと制限を確認する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/service-limits |
セキュリティ
| トピック | URL |
|---|---|
| Content Understanding の結果に対するガードレールを構成する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/guardrails |
| Content Understanding のアナライザーとデータを保護する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/concepts/secure-communications |
構成
統合とコーディングパターン
| トピック | URL |
|---|---|
| Content Understanding を Microsoft Agent Framework と統合する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/integrations/agent-framework |
| Content Understanding を LangChain のドキュメントローダーとして使用する | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/integrations/langchain |
| Content Understanding REST API と SDK を呼び出す | https://learn.microsoft.com/en-us/azure/ai-services/content-understanding/quickstart/use-rest-api |