# 概览

设备智能体是由 MQTT 驱动的人工智能助手，可在几分钟内让任意 IoT 设备具备智能体能力。
描述设备或上传硬件定义，即可生成设备规格、SDK、模拟器和 IM/A2A 集成能力。

## 你可以用它做什么

- **定义设备智能体**：描述设备的遥测、命令和事件，把一类设备整理成可对话、可接入、可协作的设备规格。
- **接入设备端 SDK**：输出或适配可运行的设备接入代码，减少手写协议解析和接入样板代码。
- **用模拟器并行调试**：硬件原型未就绪时，也可以先验证设备交互、命令响应和对话体验。
- **接入语音、视觉和 IM 通道**：让用户通过自然语言、图像上下文或聊天工具与设备交互。
- **用 A2A 让设备自主组网**：让设备智能体可以彼此发现、协商任务，并在无需硬编码联动规则的情况下完成跨设备协作。

## 适合谁

**智能设备厂商**可以用设备智能体快速验证 AI 能力升级路径，不必从零搭建完整 AI、语音和多模态能力。

**AI 硬件团队**可以从第一天就按智能体原生的方式组织产品能力，让硬件具备可对话、可调用、可协作的接口。

**系统集成商**可以减少逐个对接私有 API 和编写硬编码联动规则的工作量，用标准协议交付跨品牌设备协作方案。

**开发者**可以直接从设备规格、MQTT 接入、SDK、模拟器和 A2A 示例开始，快速理解完整工程链路。

## 基本工作流

1. **描述设备**：输入自然语言描述，或上传 JSON / Markdown / YAML 形式的设备定义。
2. **确认设备规格**：检查设备的遥测字段、命令、事件和版本信息。
3. **创建设备智能体**：生成设备智能体，并根据需要启用 A2A 发布。
4. **接入设备**：使用 MQTT、设备模拟器或生成的 SDK 连接真实设备。
5. **扩展交互入口**：按场景接入语音、视觉、IM 或外部智能体网络。

- [下载安装](./installation.md)
- [快速体验](./quick-start/quick-start.md)
- [定义设备智能体](./usage/create-agent.md)
- [A2A 协作](./usage/a2a.md)