azure-immersive-reader

Azure AI Immersive Reader スキル

このスキルでは、Azure AI Immersive Reader に関する専門的なガイダンスを提供します。ベストプラクティス、制限とクォータ、セキュリティ、構成、統合とコーディングパターンを扱います。ローカルのクイックリファレンスと、リモートドキュメントを取得する機能を組み合わせています。

このスキルの使用方法

エージェントへの重要な注意：関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が記載されたカテゴリ（例：L35-L120）では、指定された行を指定して read_file を使用してください。ファイルへのリンクがあるカテゴリ（例：[security.md](security.md)）では、リンク先のリファレンスファイルに対して read_file を使用してください。

エージェントへの重要な注意：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 が返されます。

カテゴリインデックス

カテゴリ	行	説明
ベストプラクティス	L33-L37	認証トークンのキャッシュ、トークンの再利用パターン、認証のオーバーヘッド削減など、Immersive Reader のパフォーマンスを向上させるためのガイダンスです。
制限とクォータ	L38-L42	Immersive Reader でサポートされる言語と機能の利用可否（読み上げ、翻訳、その他の機能に対応する言語など）です。
セキュリティ	L43-L49	Entra 認証を使用したリソースの作成、Entra ロールの割り当て管理、Cookie ポリシーとユーザーの同意の設定など、Immersive Reader のセキュリティ構成です。
構成	L50-L56	読み上げの音声と速度、翻訳の言語と動作、ユーザーごとの読書および言語設定の保存と管理など、Immersive Reader の動作を構成します。
統合とコーディングパターン	L57-L66	Web／iOS アプリへの Immersive Reader の実装（起動フロー、JS SDK の使用、HTML／MathML の準備、カスタムボタン、複数リソースの設定、Vision Read の統合など）です。

ベストプラクティス

トピック	URL
パフォーマンス向上のために Immersive Reader の認証トークンをキャッシュする	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-cache-token

制限とクォータ

トピック	URL
Immersive Reader の機能でサポートされる言語を確認する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/language-support

セキュリティ

トピック	URL
Immersive Reader リソースを作成し、Entra 認証を構成する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-create-immersive-reader
Immersive Reader の Cookie ポリシーと同意を構成する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/set-cookie-policy
セキュリティのために Immersive Reader の Entra ロールの割り当てを更新する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/security-how-to-update-role-assignment

構成

トピック	URL
Immersive Reader の読み上げオプションを構成する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-read-aloud
Immersive Reader の翻訳設定を構成する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-configure-translation
Immersive Reader のユーザー設定を保存および管理する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-store-user-preferences

統合とコーディングパターン

トピック	URL
Immersive Reader の起動ボタンをカスタマイズする	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-customize-launch-button
アプリケーションコードから Azure Immersive Reader を起動する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-launch-immersive-reader
1 つのアプリで複数の Immersive Reader リソースを使用する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-multiple-resources
Immersive Reader との統合に向けて HTML コンテンツを準備する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-prepare-html
Immersive Reader で MathML 式をレンダリングする	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/display-math
Immersive Reader JavaScript SDK API を使用する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/reference
Vision Read と Immersive Reader を統合する iOS アプリを構築する	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/tutorial-ios-picture-immersive-reader