文档中心

云原生消息引擎

MQTT Agent

使用 MQTT Agent

使用 MQTT Agent

本文介绍如何在消息队列 MQTT 控制台中使用 MQTT Agent。

说明

MQTT Agent 属于邀测功能，如需使用，请联系客户经理。

前提条件

使用 MQTT Agent 前，请确认已完成以下准备：

已开通云消息队列 MQTT 版服务，并已创建 MQTT 实例。

当前账号具备查看 MQTT 实例、客户端和设备凭证等资源的权限。

如需排查客户端问题，建议提前准备实例 ID、Client ID、接入点、端口、协议、报错信息和问题发生时间。

操作步骤

登录云原生消息引擎控制台。

在顶部菜单栏，选择目标地域。

在左侧导航栏，单击 MQTT > MQTT Agent。

在 MQTT Agent 新任务页面，按需选择以下任一方式使用 Agent。

通过输入自然语言提问
通过预置卡片提问
在输入框中输入待分析问题并发送。
如需引用目标实例，可单击输入框左下角 + 并选择 &引用资源，或在输入框输入 @，在弹出的实例列表选择目标实例。
查看 Agent 返回的结果，重点区分已确认事实、可能原因、建议操作和无法确认项。
如有建议操作，可根据提示跳转并处理。
在预置卡片区域，按需选择目标问题。
数据洞察：查看实例详细配置、Topic 与 Partition 概况、消费组概况等信息。
方案咨询：了解自建 MQTT 迁移方案、带宽与规格估算、Consumer 超时参数配置等
单击预置卡片，输入框会自动填充问题相关语言描述。
（可选）部分问题需引用目标实例，输入框会弹出可被引用的 MQTT 实例列表，可按需选择。
查看 Agent 返回的结果，重点区分已确认事实、可能原因、建议操作和无法确认项。
如有建议操作，可根据提示跳转并处理。

使用示例

场景	示例问题
查询实例信息	我在华北 2 有哪些 MQTT 实例？
查看接入配置	MQTT 实例 mqtt-xxx 的接入配置是什么？
排查客户端连接失败	dev-001 连不上 MQTT，帮我排查。
排查频繁上下线	dev-001 最近频繁上下线，可能是什么原因？
查看在线客户端	当前有哪些在线 Client？
咨询参数限制	MQTT 的连接数、Topic 和消息大小有哪些限制？
咨询最佳实践	弱网设备接入 MQTT，QoS 应该怎么选？

安全说明

请勿在对话中输入密码、AccessKey、Token、设备凭证明文或业务敏感消息内容。

Agent 返回的结果以当前可查询的信息和产品文档为基础。如需定位生产问题，请结合控制台监控、客户端日志和业务侧信息继续核验。

最近更新时间：2026.09.02 17:48:21

这个页面对您有帮助吗？

有用

有用

无用

无用