azure-digital-twins

Azure Digital Twins 技能

此技能提供 Azure Digital Twins 专业指导，涵盖故障排除、最佳实践、决策、架构与设计模式、限制与配额、安全性、配置、集成与编码模式，以及部署。它结合了本地快速参考内容与远程文档获取功能。

如何使用此技能

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

IMPORTANT for 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。

类别索引

类别	行	描述
故障排除	L37-L46	诊断并解决常见的 Azure Digital Twins 问题：403/404 错误、Explorer 身份验证问题、CLI 解析失败、已知错误和性能故障排除。
最佳实践	L47-L52	模型设计最佳实践指南：将 RDF/OWL 本体转换为 DTDL、扩展 Azure Digital Twins 的 DTDL，以及为孪生图设计有效的标记模式。
决策	L53-L57	为孪生模型选择基于 DTDL 的行业本体的指南，以及将 Azure Digital Twins 预览版控制平面 API 迁移到当前 API 的说明。
架构与设计模式	L58-L63	设计具有弹性的 Digital Twins 解决方案（HA/DR），并将行业本体转换为 DTDL 模型，以构建可互操作的孪生图。
限制与配额	L64-L69	Azure Digital Twins 查询单元用量详情，以及服务限制、限制流量行为，还有如何查看或申请更改可调整的配额。
安全性	L70-L78	Azure Digital Twins 安全指南：使用 Entra 应用注册进行身份验证、客户端身份验证、设置 Private Link，以及处理客户个人数据和最佳实践。
配置	L79-L103	配置和运行 Azure Digital Twins：实例设置、安全性、终结点/路由、数据历史记录、监视、图/孪生/模型管理、Explorer/3D 工具和查询语言用法。
集成与编码模式	L104-L120	使用 SDK、REST/CLI、查询和插件，将 Azure Digital Twins 与 IoT Hub、Azure Data Explorer、Functions、Power Platform 和 .NET 客户端集成，其中包括查询和 DTDL 模型模式。
部署	L121-L124	将 Azure Digital Twins 实例迁移到其他区域的指南，包括先决条件、支持的场景和分步迁移流程。

故障排除

主题	URL
修复 Azure Digital Twins 403 Forbidden 错误	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-403-digital-twins
修复 Azure Digital Twins 404 子域未找到错误	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-404-digital-twins
解决 Azure Digital Twins Explorer 身份验证错误	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-azure-digital-twins-explorer-authentication
解决 Azure Digital Twins CLI 解析失败错误	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-cli-parse
解决 Azure Digital Twins 中的已知问题	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-known-issues
排查 Azure Digital Twins 性能问题	https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-performance

最佳实践

主题	URL
扩展 Azure Digital Twins 的 DTDL 本体	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-extend
为 Azure Digital Twins 实施标记模式	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-tags

决策

主题	URL
从 Azure Digital Twins 预览版控制平面 API 迁移	https://learn.microsoft.com/en-us/azure/digital-twins/resources-migrate-from-preview-apis

架构与设计模式

主题	URL
为 Digital Twins 规划高可用性和灾难恢复	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-high-availability-disaster-recovery
将行业本体转换为 Azure Digital Twins 的 DTDL	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-convert

限制与配额

主题	URL
了解 Digital Twins 中的查询单位消耗	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-query-units
Azure Digital Twins 服务限制和可调整配额	https://learn.microsoft.com/en-us/azure/digital-twins/reference-service-limits

安全性

主题	URL
将安全最佳实践应用于 Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-security
为 Azure Digital Twins 实施客户端身份验证	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-authenticate-client
为 Azure Digital Twins 创建 Entra 应用注册	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-app-registration
为 Azure Digital Twins 启用 Private Link	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-enable-private-link
处理 Azure Digital Twins 中的客户个人数据	https://learn.microsoft.com/en-us/azure/digital-twins/resources-customer-data-requests

配置

主题	URL
解读 Azure Digital Twins 事件通知	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-event-notifications
在 Digital Twins 中配置终结点和事件路由	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-route-events
设置 Azure Digital Twins 数据历史记录连接	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-data-history-connection
配置 Azure Digital Twins 事件终结点	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-endpoints
在 Azure Digital Twins 中配置事件路由和筛选器	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-routes
管理 Azure Digital Twins 图和关系	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-graph
在 Azure Digital Twins 中管理 DTDL 模型	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-model
通过 API/SDK 管理单个数字孪生	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-manage-twin
配置 Azure Digital Twins 的监视、指标和日志	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-monitor
通过 CLI 预配并保护 Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-set-up-instance-cli
在门户中设置 Azure Digital Twins 实例	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-set-up-instance-portal
在 Digital Twins 中使用 3D Scenes Studio 功能	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-3d-scenes-studio
使用 Azure Digital Twins Explorer 功能	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-azure-digital-twins-explorer
在 Azure Digital Twins 查询语言中使用 FROM 子句	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-from
在 Azure Digital Twins 图查询中使用 JOIN 子句	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-join
使用 MATCH 子句在 Azure Digital Twins 中遍历图	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-match
在 Azure Digital Twins 查询语言中使用 SELECT 子句	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-select
在 Azure Digital Twins 查询中使用 WHERE 子句	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-clause-where
在 Azure Digital Twins 查询语言中使用函数	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-functions
在 Azure Digital Twins 查询语言中使用运算符	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-operators
Azure Digital Twins 查询语言中的保留关键字	https://learn.microsoft.com/en-us/azure/digital-twins/reference-query-reserved

集成与编码模式

主题	URL
使用 Azure Digital Twins API 和 SDK	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-apis-sdks
使用 Azure Digital Twins CLI 命令集	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-cli
使用 Azure Data Explorer 插件查询 Azure Digital Twins 数据	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-explorer-plugin
使用 Azure Data Explorer 配置数据历史记录	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-data-history
使用 Azure Digital Twins 查询语言	https://learn.microsoft.com/en-us/azure/digital-twins/concepts-query-language
将 IoT Hub 遥测数据引入 Azure Digital Twins	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-ingest-iot-hub-data
使用 .NET 解析和验证 DTDL 模型	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-parse-models
通过示例查询 Azure Digital Twins 图	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-query-graph
使用 Azure Functions 设置孪生到孪生的事件传播	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-send-twin-to-twin-events
使用 .http 文件调用 Azure Digital Twins REST API	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-apis
将 Power Platform 连接器与 Azure Digital Twins 配合使用	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-power-platform-logic-apps-connector
为 Azure Digital Twins 编写 .NET 客户端	https://learn.microsoft.com/en-us/azure/digital-twins/tutorial-code
将 Azure CLI 命令与 Digital Twins 配合使用	https://learn.microsoft.com/en-us/azure/digital-twins/tutorial-command-line-cli

部署

主题	URL
将 Azure Digital Twins 实例迁移到其他区域	https://learn.microsoft.com/en-us/azure/digital-twins/how-to-move-regions