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

说明

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

## 前提条件使用 MQTT Agent 前，请确认已完成以下准备： * 已开通云消息队列 MQTT 版服务，并已创建 MQTT 实例。 * 当前账号具备查看 MQTT 实例、客户端和设备凭证等资源的权限。 * 如需排查客户端问题，建议提前准备实例 ID、Client ID、接入点、端口、协议、报错信息和问题发生时间。 ## 操作步骤 1. 登录[云原生消息引擎控制台](https://console.volcengine.com/bmq)。 2. 在顶部菜单栏，选择目标地域。 3. 在左侧导航栏，单击 **MQTT** \> ** MQTT Agent**。 4. 在 MQTT Agent 新任务页面，按需选择以下任一方式使用 Agent。通过输入自然语言提问 1. 在输入框中输入待分析问题并发送。如需引用目标实例，可单击输入框左下角 `+` 并选择 `&引用资源`，或在输入框输入 `@`，在弹出的实例列表选择目标实例。 2. 查看 Agent 返回的结果，重点区分已确认事实、可能原因、建议操作和无法确认项。如有建议操作，可根据提示跳转并处理。通过预置卡片提问 1. 在预置卡片区域，按需选择目标问题。数据洞察：查看实例详细配置、Topic 与 Partition 概况、消费组概况等信息。方案咨询：了解自建 MQTT 迁移方案、带宽与规格估算、Consumer 超时参数配置等 2. 单击预置卡片，输入框会自动填充问题相关语言描述。 3. （可选）部分问题需引用目标实例，输入框会弹出可被引用的 MQTT 实例列表，可按需选择。 4. 查看 Agent 返回的结果，重点区分已确认事实、可能原因、建议操作和无法确认项。如有建议操作，可根据提示跳转并处理。 ## 使用示例 |**场景** |**示例问题** | |---|---| |查询实例信息 |我在华北 2 有哪些 MQTT 实例？ | |查看接入配置 |MQTT 实例 mqtt\-xxx 的接入配置是什么？ | |排查客户端连接失败 |dev\-001 连不上 MQTT，帮我排查。 | |排查频繁上下线 |dev\-001 最近频繁上下线，可能是什么原因？ | |查看在线客户端 |当前有哪些在线 Client？ | |咨询参数限制 |MQTT 的连接数、Topic 和消息大小有哪些限制？ | |咨询最佳实践 |弱网设备接入 MQTT，QoS 应该怎么选？ | ## 安全说明 * 请勿在对话中输入密码、AccessKey、Token、设备凭证明文或业务敏感消息内容。 * Agent 返回的结果以当前可查询的信息和产品文档为基础。如需定位生产问题，请结合控制台监控、客户端日志和业务侧信息继续核验。