常见问题

设备智能体是什么？

设备智能体是通过设备模型描述能力，并通过 MQTT 与设备通信的人工智能助手。

由 Device Agent 直接管理的设备使用 DeviceSpec；已适配的 IoT 平台保留自己的原生物模型与设备链路。内置的平台适配包括 EMQX Fleets 和 ThingsNeural，接入方式见IoT 平台集成。

设备智能体适合什么类型的设备？

适合能够用状态、命令或事件清晰描述的设备和系统。

设备智能体和通用 AI 助手有什么区别？

通用 AI 助手以对话或任务为中心；设备智能体以设备语义为中心。设备规格定义控制命令、属性和设备事件，设备智能体基于这份定义处理设备接入、在线状态、命令执行和事件。

设备规格是什么？

设备规格是一类设备的设备语义定义。它描述设备基础信息、控制命令、属性和设备事件，让智能体、SDK、模拟器和 A2A 卡片使用同一份能力模型。

一个设备智能体只能管理一台设备吗？

不是。一个设备智能体对应一个设备品类和一份设备模型；这个设备品类下可以接入多台真实设备。每台设备有自己的设备标识、在线状态、上报的属性值和事件记录，但共享同一套能力定义。

必须改造现有设备系统吗？

不一定。已有固件、网关或后端服务只要按设备智能体给出的 MQTT 主题和消息格式上报状态、响应命令、发送事件，就可以接入。新设备可以通过 SDK 生成器生成接入代码。

设备智能体能做自动化吗？

可以通过对话和定时任务执行操作，使用工作流处理遥测、设备事件、状态、命令响应和校验错误，使用 A2A 进行跨设备协作。

设备智能体支持语音和视觉吗？

支持。语音用于输入和播报，视觉用于把图片或图像帧加入设备上下文。

A2A 是什么？

A2A 是基于 EMQX 6.2.0 及以上版本和 MQTT 协议的智能体协作能力。启用后，设备智能体会从设备模型发布 A2A 卡片，并把可用操作映射为其他智能体可发现、可调用的技能。

EMQX 提供卡片注册与发现、在线状态、可选 Schema 校验和 MQTT 路由。Device Agent 负责生成卡片、处理 SendMessage 请求、调用设备能力并返回结果。

设备模型和具体设备有什么区别？

设备模型描述一类设备能做什么、有什么限制。例如，温控器模型定义温度读取、目标温度设置和允许的温度范围。

“客厅温控器”和“卧室温控器”是设备列表中的两台具体设备。它们可以共用同一份模型，但各自有独立的设备 ID、当前温度、在线状态和事件记录。

如何保存偏好？清空对话会删除记忆吗？

可以明确要求记住、查看或忘记偏好。清空对话会归档历史并重置当前上下文，长期记忆仍保留。当前记忆使用部署中的共享身份，不自动按真实用户隔离。详见对话与记忆。

定时任务与工作流怎么选？

到指定时间或按周期执行，用定时任务；收到设备状态或事件后自动处理，用工作流。两者都需要执行时设备及依赖服务可用。

A2A 发布后就能控制所有设备吗？

发布让其他智能体发现能力。普通设备对话的协作还需要配置主控设备的目标绑定，执行时检查范围和在线状态。A2A over MQTT 使用 EMQX 6.2.0 及以上版本，操作见A2A 多智能体协作。

IoT 平台集成与商业化平台是什么关系？

IoT 平台集成连接客户已有的设备系统，让 Agent 使用其原生能力。Device Agent 平台是面向企业生产环境的商业化部署方案，在通用功能基础上提供规模化运行、监控、设备 AI 额度和授权管理。部署需求可通过平台概览与我们联系。

License 包含模型和语音服务额度吗？

License 授权平台运行，规定请求容量和有效期，不包含模型、语音识别或语音合成等第三方服务的额度。这些服务需独立准备凭证和预算，见授权管理。