快速体验

本页从一段自定义温控器描述开始，创建设备智能体，并通过浏览器模拟设备完成第一次控制。 整个流程不需要真实硬件，适合在安装完成后快速了解设备智能体的核心体验。

开始前

请先确认设备智能体已启动，并且控制台可以正常打开：

http://127.0.0.1:3000

如果还没有完成安装或配置，请先阅读 下载安装 和 配置。

1. 输入设备描述

如果当前还没有设备智能体，控制台首页会直接显示输入框，你可以输入或上传设备描述。如果已经创建过设备智能体， 可以点击左侧边栏的 +，或首页上的 创建设备智能体 按钮进入创建流程。

设备描述可以是一段文本，也可以是 JSON、YAML 或 Markdown 文件，只要能描述设备的命令、遥测和事件即可。 查看示例 只是可选参考入口，你也可以直接输入自己的设备描述。

本次快速体验直接复制以下描述并发送：

智能温控器，支持开关、目标温度设定和运行模式切换（制热、制冷、自动、仅送风、节能），并上报当前温度、湿度和制热/制冷状态；当温度超过 30 度或设备离线时，上报告警事件。

点击发送按钮后，系统会生成一份设备规格（DeviceSpec）草稿。

2. 确认设备能力

在右侧预览面板中确认大模型生成的设备能力。结果会根据你的输入变化，不需要和下面完全一致，重点确认命令、遥测和事件是否覆盖预期。 以上面的温控器描述为例，可能包含：

• 命令：开关、目标温度设置、运行模式切换
• 遥测：当前温度、目标温度、湿度、运行模式、制热/制冷状态、在线状态
• 事件：温度过高、设备离线等告警事件

如果能力符合预期，点击 创建。创建完成后，可以点击完成页上的 进入设备智能体，也可以从左侧设备智能体列表中点击刚创建的设备智能体进入。

3. 启动浏览器模拟设备

进入设备智能体后，左侧是 设备 面板。如果还没有接入设备，点击 用模拟设备试试。

在弹窗中确认设备名称和设备 ID，点击 模拟连接。模拟设备会在浏览器中运行，自动连接 MQTT，并注册到当前设备智能体。

连接成功后，设备列表中会出现带有 模拟 标记的设备。选中它后，右侧状态面板会显示：

• 设备状态
• 当前数据
• 可用命令
• 最近上报事件

4. 控制设备并查询状态和事件

保持模拟设备处于选中状态，先在对话框中输入控制请求：

把目标温度设置为 24 度，并切换到自动模式。

设备智能体会基于当前设备规格和选中的设备，调用对应命令。浏览器模拟设备收到命令后，会更新自己的当前数据并继续上报。

然后可以继续查询当前状态和最近事件：

查看当前设备状态，包括当前温度、目标温度、湿度和运行模式；同时查看最近有没有上报事件，如果有，请按时间列出来。

你可以在状态面板中查看 target_temperature 和 mode 是否更新，也可以查看当前数据、可用命令和最近上报事件。 如果模拟设备还没有触发或上报事件，对话会返回当前没有可用事件。

体验结果

完成以上步骤后，你已经验证了设备智能体的几个核心能力：

• 用文本、JSON、YAML 或 Markdown 设备描述生成设备规格草稿。
• 确认设备规格中的命令、遥测和事件。
• 启动浏览器模拟设备，并让它自动注册到当前设备智能体。
• 通过对话向模拟设备下发控制命令，并查询设备状态和事件。

下一步

• 阅读 定义设备智能体，了解设备智能体、设备规格和真实设备的关系。
• 阅读 MQTT 接入，将真实设备接入设备智能体。
• 阅读 SDK 接入，了解如何生成或适配设备端接入工程。