# MQTTX AI Agent Skill 正式发布

> MQTTX CLI 内置的 Agent Skill，让 AI 编码 Agent 能够正确、安全地完成 MQTT 连接检查、消息收发、压测与数据模拟。

> Language: zh-CN · Published: 2026-09-20 · Category: 产品 · Canonical: https://mqttx.app/zh/blog/introducing-mqttx-ai-agent-skill · Translation: [English](https://mqttx.app/blog/introducing-mqttx-ai-agent-skill.md)

AI 编码 Agent 已经能写出像样的 MQTT 代码，但要让它们正确调用 `mqttx` 命令，仍然是另一回事：不同命令的参数并不相同，TLS 和认证选项很容易配置错，压测和数据模拟也需要有边界、可复现的参数。如果 Agent 靠猜测来使用 CLI，轻则浪费时间，重则留下没有退出的进程，或者给出一份不可信的结果。

MQTTX AI Agent Skill 正是为了解决这个问题。它位于 MQTTX 仓库中，使用 MQTTX 团队维护的同一套文档，指导 AI 编码 Agent 正确、安全地操作 `mqttx` 命令。

## Skill 覆盖的内容

Skill 围绕 Agent 真正会执行的任务来组织。它的 `SKILL.md` 会根据任务把 Agent 引导到对应的参考文档，Agent 只需要阅读与当前任务相关的内容，而不必把整份 CLI 手册塞进上下文。

- **基础工作流**：`conn`、`pub`、`sub`，以及有边界的连接检查和消息收发验证。
- **连接与认证**：传输协议选择、TLS 与双向 TLS、WebSocket 请求头、凭据和 SCRAM 认证。
- **MQTT 功能**：MQTT 3 与 MQTT 5 的行为、QoS、保留消息、会话、遗嘱、请求/响应和订阅属性。
- **负载与文件**：文本和二进制输入、交互式行模式、从文件读取、编解码、Protobuf 与 Avro Schema，以及随机负载。
- **压测与数据模拟**：`bench conn`、`bench pub`、`bench sub`、`simulate`、`ls --scenarios` 和自定义生成器。
- **配置与工具命令**：`init`、`check`、帮助与版本输出、INI 默认配置，以及 JSON 或 YAML 选项。
- **能力清单**：各命令精确的参数可用性，以及不同版本之间的差异说明。
- **故障排查**：失败场景下的诊断建议。

## 通过 Agent 安装 MQTTX CLI

MQTTX 仓库提供了一份面向 Agent 编写的安装指南，涵盖环境检测、安装渠道选择和版本验证。可以把下面这段提示词交给你的 Agent：

> 读取 <https://raw.githubusercontent.com/emqx/MQTTX/main/INSTALL.md>，按照其中的步骤为当前环境安装或更新 MQTTX CLI，并验证命令路径和版本。

## 安装 Skill

通过 Skills CLI 安装：

```shell
npx skills add emqx/MQTTX --skill mqttx-cli
```

如果你使用的是本地源码，可以在仓库根目录运行 `npx skills add . --skill mqttx-cli`。也可以将整个 `skills/mqttx-cli` 目录（包括其中的 `references`）复制到 Agent 支持的技能目录，或让 Agent 直接读取该 Skill 的 `SKILL.md`。

## 试一试

安装好 CLI 和 Skill 之后，可以这样向 Agent 描述任务：

> 使用 mqttx-cli skill，验证本地 127.0.0.1:1883 broker 的消息收发。使用 mqttx-test/ 下的唯一 topic，在 15 秒内结束检查，并报告结果。

Agent 会据此选择合适的命令和参数，执行检查，并报告结果。

## 了解更多

- [MQTTX AI Agent Skill 文档](https://mqttx.app/docs/cli/agent-skill)
- [GitHub 上的 Skill 源码](https://github.com/emqx/MQTTX/tree/main/skills/mqttx-cli)