关于 azure-iot-operations
azure-iot-operations 是为 Azure IoT Operations 提供指导的 Agent 技能，面向 IoT 部署的规划、开发与运维。它结合本地速查内容和联网文档获取，覆盖 MQTT、OPC UA、安全、数据流与部署。
主要功能
- 01排查 WASM、连接和健康状态问题
- 02规划部署拓扑、容量与持久化
- 03配置 MQTT、OPC UA 和数据流
- 04安全、证书与访问控制指导
- 05集成、编码和部署模式
适用场景
- 01诊断私有连接或 MQTT 通信问题
- 02规划边缘部署资源与高可用性
- 03构建数据流并配置连接器和安全
MCP 相关
文档获取可优先使用 mcp_microsoftdocs 的 microsoft_docs_fetch 工具；也可通过 fetch_webpage 获取内容。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/azure-iot-operations确认已加载。
详细介绍
Azure IoT Operations 技能
此技能为 Azure IoT Operations 提供专业指导，涵盖故障排除、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式，以及部署。它结合了本地快速参考内容与远程文档获取功能。
如何使用此技能
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 IoT Operations 问题：调试 WASM 模块、解读运行状况原因代码、解决专用连接问题，以及使用工具排查已知问题。 |
| 最佳实践 | L47-L54 | Azure IoT Operations 生产就绪指南：MQTT 代理高可用设计、边缘持久状态存储，以及 MQTT 连接的测试与故障排除。 |
| 决策制定 | L55-L65 | Azure IoT Operations 架构规划与选择指南：数据流与图、部署拓扑和规模、MQTT 代理诊断、缓冲与持久化，以及 OPC UA 资产发现模式。 |
| 架构与设计模式 | L66-L71 | 使用 ISA-95 统一命名空间概念设计 Azure IoT 架构，并规划分层、分段的网络拓扑，以实现安全且可扩展的 IoT Operations 部署。 |
| 限制与配额 | L72-L78 | OPC UA 会话和高可用性的容量规划、基线资源使用量估算，以及 Azure IoT Operations 中 MQTT 代理的功能、数据包和吞吐量限制。 |
| 安全 | L79-L96 | 保护 Azure IoT Operations：TLS 和证书、MQTT 身份验证与授权、OPC UA 信任、专用网络、RBAC/ABAC 角色、机密管理和映像真实性。 |
| 配置 | L97-L133 | 配置 IoT Operations 数据流、终结点、转换、MQTT/OPC UA 功能、可观测性和资源管理，包括存储、分析、WASM 和连接器设置。 |
| 集成与编码模式 | L134-L158 | Azure IoT Operations 数据流连接模式与代码：表达式、筛选器、路由、节流、窗口聚合、WASM/Dapr/ONNX、状态存储、架构，以及连接器（MQTT/HTTP/媒体/SSE/Fabric）。 |
| 部署 | L159-L172 | 在启用了 Arc 的 Kubernetes 上部署、升级、克隆和移除 Azure IoT Operations，包括安全/生产环境设置、专用网络/注册表和 Dapr MQTT 组件。 |
故障排除
| 主题 | URL |
|---|---|
| 在 VS Code 中调试 Azure IoT WASM 模块 | https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/howto-debug-wasm-modules |
| 排查 Azure IoT Operations 中的专用连接问题 | https://learn.microsoft.com/en-us/azure/iot-operations/manage-layered-network/howto-troubleshoot-private-connectivity |
| 解读 Azure IoT Operations 健康状态原因代码 | https://learn.microsoft.com/en-us/azure/iot-operations/reference/health-status-reason-codes |
| 诊断 Azure IoT Operations 中的已知问题 | https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/known-issues |
| 使用工具排查 Azure IoT Operations 问题 | https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/tips-tools |
| 诊断并修复 Azure IoT Operations 问题 | https://learn.microsoft.com/en-us/azure/iot-operations/troubleshoot/troubleshoot |
最佳实践
| 主题 | URL |
|---|---|
| 应用 Azure IoT Operations 生产部署指南 | https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-guidelines |
| 使用 Azure IoT Operations MQTT 代理设计高可用边缘应用 | https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-edge-apps |
| 使用 Azure IoT Operations 状态存储保存持久化边缘数据 | https://learn.microsoft.com/en-us/azure/iot-operations/develop-edge-apps/overview-state-store |
| 测试 Azure IoT Operations 中的 MQTT 代理连接 | https://learn.microsoft.com/en-us/azure/iot-operations/manage-mqtt-broker/howto-test-connection |
决策
| 主题 | URL |
|---|---|
| 在数据流和数据流图之间进行选择 | https://learn.microsoft.com/en-us/azure/iot-operations/connect-to-cloud/overview-dataflow-comparison |
| 规划生产规模的 Azure IoT Operations 部署 | https://learn.microsoft.com/en-us/azure/iot-operations/deploy-iot-ops/concept-production-examples |
| 规划 Azure IoT Operations 部署拓扑和规模 | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning |
| 规划 MQTT 代理诊断配置 | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-diagnostics |
| 规划 MQTT 代理的磁盘支持消息缓冲 | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-disk-buffer |
| 决定 IoT Operations 的 MQTT 代理持久化策略 | https://learn.microsoft.com/en-us/azure/iot-operations/deployment-plan/deployment-planning-persistence |
| 选择 Azure IoT 中的 OPC UA 资产发现模式 | https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/concept-opc-ua-asset-discovery |
架构与设计模式
| 主题 | URL |
|---|---|
| 使用 Azure IoT 构建 ISA-95 统一命名空间 | https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-build-unified-namespace |
| 为 Azure IoT Operations 部署设计分层网络 | https://learn.microsoft.com/en-us/azure/iot-operations/manage-layered-network/concept-layered-network |
限制与配额
| 主题 | URL |
|---|---|
| 规划 OPC UA 会话共享和高可用容量 | https://learn.microsoft.com/en-us/azure/iot-operations/discover-manage-assets/howto-configure-opc-ua-sessions-high-availability |
| 规划 Azure IoT Operations 基线资源用量 | https://learn.microsoft.com/en-us/azure/iot-operations/reference/concept-resource-profiles |
| 查看 Azure IoT Operations 代理中的 MQTT 功能和数据包限制 | https://learn.microsoft.com/en-us/azure/iot-operations/reference/mqtt-support |
安全
配置
集成与编码模式
部署
评论
支持 Markdown