azure-immersive-reader

Azure AI Immersive Reader 技能

此技能提供 Azure AI Immersive Reader 的专家指导，涵盖最佳实践、限制和配额、安全性、配置、集成与编码模式。它结合了本地快速参考内容和远程文档获取功能。

如何使用此技能

重要：Agent：使用下方的类别索引查找相关章节。对于带有行范围的类别（例如，L35-L120），请使用 read_file 并指定对应行。对于带文件链接的类别（例如，[security.md](security.md)），请使用 read_file 读取链接的参考文件。

重要：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。

类别索引

类别	行	描述
最佳实践	L33-L37	通过缓存身份验证令牌来提升 Immersive Reader 性能的指南，包括令牌重用模式和减少身份验证开销。
限制和配额	L38-L42	Immersive Reader 支持的语言和功能可用性（例如，哪些语言支持朗读、翻译和其他功能）。
安全性	L43-L49	配置 Immersive Reader 安全性的指南：使用 Entra 身份验证创建资源、管理 Entra 角色分配，以及设置 Cookie 策略和用户同意。
配置	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
自定义沉浸式阅读器启动按钮	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-customize-launch-button
从应用程序代码启动 Azure 沉浸式阅读器	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-launch-immersive-reader
在一个应用中使用多个沉浸式阅读器资源	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-multiple-resources
为沉浸式阅读器集成准备 HTML 内容	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to-prepare-html
在沉浸式阅读器中呈现 MathML 表达式	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/how-to/display-math
使用沉浸式阅读器 JavaScript SDK API	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/reference
构建集成 Vision Read 和沉浸式阅读器的 iOS 应用	https://learn.microsoft.com/en-us/azure/ai-services/immersive-reader/tutorial-ios-picture-immersive-reader