快速接入

快速接入使用 AI 根据设备资料生成完整的设备接入方案。方案包括产品、网络组件、协议源码、物模型和指令配置。生成方案后可以先审阅、修改和校验，只有点击确认并创建后，平台才会写入业务数据并自动绑定相关资源。

快速接入分为三个步骤：

1. 提交设备资料。
2. 审阅 AI 方案。
3. 确认创建配置。

使用前准备

• 确认平台的 AI 服务已正确配置并可用。
• 准备设备协议或对接文档，或者整理详细的设备对接描述。
• 如果网络组件需要 TLS 加密，请先在平台中配置对应的证书包。
• 产品编码必须在平台中保持唯一。

提交设备资料

进入设备管理 > 快速接入，依次填写以下三类信息。

1. 产品信息

• 产品名称：填写设备品类或型号名称。
• 产品编码：填写全平台唯一的产品编码，也可点击输入框右侧按钮自动生成。
• 设备类型：根据设备情况选择直连设备、网关设备或无状态设备。

2. 连接方式

选择设备实际使用的网络协议，并填写对应的网络组件参数。当前支持 TCP 服务端、TCP 客户端、UDP 服务端、MQTT Broker、MQTT 客户端、HTTP 服务端、WebSocket 服务端、CoAP 服务端、CoAP 客户端、Modbus TCP 和 Modbus DTU。

协议名称和网络组件名称可以不填，平台会根据产品名称自动生成。端口、地址、鉴权、分包、心跳和加密等参数应与设备的实际连接方式一致。启用 TLS 时必须选择对应的证书包。

3. 生成依据

通过以下任一方式提供 AI 生成方案所需的依据，建议两种方式同时提供：

• 上传协议与设备对接文档。支持 PDF、DOCX、XLS、XLSX、TXT、MD、JSON、CSV、LOG、XML，最多上传 5 个文件，单个文件不超过 10MB。
• 填写设备对接描述，说明设备标识来源、完整上报报文、校验方式、字段含义，以及下发指令和回复示例。

至少需要提供一份完整的上行报文示例；需要平台下发控制指令时，还应提供指令和响应示例。资料填写完成后，点击生成接入方案。

此时平台只生成待审阅方案，不会创建产品、组件或协议配置。

审阅和修改方案

方案生成后，应逐项检查以下内容：

• AI 接入结论：查看资料缺失、AI 推测、实现风险和必须人工核对的项目。
• 产品与组件：核对产品名称、产品编码、设备类型、心跳配置、网络组件类型及连接参数。
• 物模型：核对属性名称、标识符、数据类型、单位和说明，可新增、修改或删除属性。
• 指令：核对指令名称、功能编码、参数 JSON 和说明；需要作为通用属性修改指令时，开启属性修改。
• 协议源码：检查 AI 生成的协议实现和入口接口。

可直接修改方案，也可在右侧方案助手中描述修改要求。例如：“温度字段保留一位小数，并增加远程重启指令”。修改完成后点击保存方案。

校验并创建配置

1. 点击校验方案，检查配置完整性和协议源码编译结果。
2. 如果校验未通过，根据页面中的错误信息修改方案，然后重新保存并校验。
3. 校验通过后，点击确认并创建。
4. 在确认窗口核对将要创建的产品、网络组件、协议包、物模型属性和指令数量，点击确认创建。

创建完成后，页面会显示产品编码、物模型数量和指令数量，可点击查看产品详情继续检查。自动创建的产品和网络组件默认保持停用，应先完成联调测试，确认配置正确后再启用。

接入记录

点击页面右上角的接入记录，可按状态筛选历史会话。记录状态包括生成中、待确认、创建中、已完成和失败。点击记录右侧的查看可继续审阅方案或查看创建结果。

如果自动创建失败，打开对应记录查看错误信息，排除问题后点击重试创建。当前方案存在未保存修改时，切换记录或新建接入会提示先处理这些修改。

注意事项

• AI 生成内容必须经过人工审阅，不应直接作为最终生产配置。
• 产品编码、物模型标识符和指令功能编码应与真实设备协议保持一致。
• 修改网络组件参数或协议源码后，应重新保存并执行方案校验。
• 确认创建属于实际写入操作，执行前请仔细核对方案及资源数量。
• 如果出现异常，请检查是否是网络问题，因为此操作比较耗时，可能会因为AI那边或者服务器这边网络连接断开等问题，重试即可。