# 快速体验

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

## 开始前

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

```text
http://127.0.0.1:3000
```

如果还没有完成安装或配置，请先阅读 [下载安装](../installation.md) 和
[配置](../operate-reference/configuration.md)。

![设备智能体控制台创建入口](../images/docs/getting-started/quick-start/zh/01-create-entry.png)

## 1. 输入设备描述

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

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

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

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

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

![输入温控器设备描述](../images/docs/getting-started/quick-start/zh/02-device-description.png)

## 2. 确认设备能力

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

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

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

![确认温控器设备规格草稿](../images/docs/getting-started/quick-start/zh/03-preview-create.png)

## 3. 启动浏览器模拟设备

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

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

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

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

![启动浏览器模拟设备](../images/docs/getting-started/quick-start/zh/04-simulator-device.png)

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

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

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

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

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

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

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

![通过对话控制并查询设备](../images/docs/getting-started/quick-start/zh/05-chat-command.png)

## 体验结果

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

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

## 下一步

- 阅读 [定义设备智能体](../usage/create-agent.md)，了解设备智能体、设备规格和真实设备的关系。
- 阅读 [MQTT 接入](../device-access/mqtt.md)，将真实设备接入设备智能体。
- 阅读 [SDK 接入](../device-access/sdk-generation.md)，了解如何生成或适配设备端接入工程。