MQTTX Copilot（测试版）

MQTTX Copilot 是一款专为 MQTT 相关问题设计的 AI 助手。它不仅能解答常见问题，还能提供最佳实践建议。

无论是测试 MQTT 连接、发布订阅主题，还是调试和开发 MQTT 应用程序和服务，MQTTX Copilot 都能大幅简化这些操作，提升您的 MQTT 使用体验。

注意：MQTTX Copilot 目前处于测试版，自 v1.9.7 版本起提供。其回答的准确性和质量取决于使用的大语言模型能力。

预配置

MQTTX Copilot 可以由多种生成式 AI 的大语言模型提供动力，这里以使用 Moonshot 为例。运行时需要相应的 API 密钥。以下是设置方法：

1. 获取 Moonshot API 密钥：
   • 访问 Moonshot API 页面。
   • 注册或登录以获取您的 API 密钥。
   
   
2. 在 MQTTX 中配置 API 密钥：
   • 打开 MQTTX 并前往设置页面。
   • 滚动到底部，在 API Key 一栏中输入上一步中获取到的 Moonshot API 密钥。
3. 选择 Moonshot 模型：
   • 选择 Moonshot 模型版本（例如当前支持的 moonshot-v1-8k, moonshot-v1-32k, 或 moonshot-v1-128k）。如果您不确定有哪些模型，MQTTX 在选择框中内置了当前支持的模型列表，您可以聚焦到输入框中，然后手动选择。
   • 确保所选模型与您的 Moonshot API 密钥兼容。
   
   
4. 配置 API Host 端点：
   • 输入 Moonshot 的 API Host 端点：https://api.moonshot.cn/v1。

配置完成后，您就可以开始使用 MQTTX Copilot 了。

自定义配置

理论上，只要使用与 OpenAI 或 Moonshot 相似的 API 方式，MQTTX Copilot 就可以支持。如果您有其他 API 密钥，可以尝试在 MQTTX 中配置并使用。以下是一些示例：

Zhipu：

• API 文档： https://open.bigmodel.cn/
• API 端点： https://open.bigmodel.cn/api/paas/v4
• 可用模型：
  • glm-4-0520
  • glm-4
  • glm-4-air
  • glm-4-airx
  • glm-4-flash

Deepseek：

• API 文档： https://www.deepseek.com/zh
• API 端点： https://api.deepseek.com/v1
• 可用模型：
  • deepseek-chat
  • deepseek-coder

在 MQTTX 中，API Host 和模型支持提供了内置的 OpenAI 和 Moonshot 的快捷选择，但用户也可以自定义输入内容并保存，完成自定义配置。只需确保输入正确的 API 密钥和端点地址，输入对应的支持的模型即可。

使用方法

MQTTX Copilot 无缝集成到 MQTTX 桌面端，无需额外下载或安装。要访问 Copilot，请点击 MQTTX 桌面界面右上角的消息图标。目前此功能仅在连接页面可用。

要开始新的对话或清除 Copilot 中现有的对话历史，请点击对话框中关闭选项旁的删除按钮。此操作将重置对话。

预设提示

一键错误分析：

在连接或订阅时遇到错误，只需点击错误提示中的 Ask Copilot 按钮。MQTTX Copilot 会帮助您分析问题原因，指导您逐步排查和解决问题。

代码生成器：

MQTTX Copilot 提供了一键生成 MQTT 客户端代码的功能，大大简化了在多种编程语言中配置 MQTT 客户端的过程。

它预设了多种编程语言的支持，包括 JavaScript、Python、Java、Go、C、C++、C#、PHP、Swift、Kotlin、Rust、Dart 和 Erlang。尽管这些是主要的选项，MQTTX Copilot 的灵活性意味着它同样适用于其他编程语言，便于用户根据自己的需求进行 MQTT 应用程序的集成和开发。

自动生成测试数据：

快速生成 Payload，助您分析和优化 MQTT 数据。这个功能简化了各种 MQTT 场景的设置和模拟。

MQTT 常见问题解答，EMQX 教程和日志分析：

获取 MQTT 常见问题的提示，以及全面的 EMQX 安装和使用教程的逐步指导。这些资源旨在提高用户在 MQTT 和 EMQX 方面的知识和技能。此外，现在可以使用一键分析 EMQX 日志，简化了日志审查过程。

解释器：

• 连接信息深度解析：通过一键操作快速分析和解读连接信息，提供深入的 MQTT 连接洞察，帮助您更高效地管理和使用。
• 测试文档自动生成：Copilot 自动为当前 MQTT 连接生成测试文档，提升了对连接的理解，并为 MQTT 测试场景提供全面的文档支持。

自定义提示

MQTTX Copilot 允许您根据具体需求创建个性化提示。例如，输入“如何在 MQTT 中清除保留消息？”即可获得针对性的答案。

关键词快速访问

通过关键词如 @connection，MQTTX Copilot 支持快速获取信息，优化您的交互体验。比如输入“@connection 中的 host 是什么”，即可迅速显示当前连接的主机信息。

代码快捷操作

• 复制 MQTT 客户端代码：此功能允许您快速生成和应用 MQTT 客户端代码，提高工作效率。
• 插入 MQTT 测试数据：轻松将预生成的 MQTT 测试数据插入到负载编辑器中，简化测试流程。

即将推出的功能

• 扩展关键词：引入 @payload、@topics 等关键词，快速获取数据分析和管理。

常见问题解答

是否免费使用？

虽然 MQTTX Copilot 本身是免费的，但需要使用付费的 Moonshot 或其他支持的 AI 服务的 API 密钥。MQTTX 仍然是完全开源的。

如何提供反馈？

如遇到错误或有功能建议，请在 GitHub Issues 上提交您的反馈。

默认上下文限制是多少？

MQTTX Copilot 的默认上下文限制为 20。超过此限制可能需要开始新对话以获得准确回应。

如何开始新的对话？

在 MQTTX Copilot 中开始新对话，点击顶部的删除按钮。此操作将清除所有之前的对话，允许您开始新的对话。