部署与配置

Device Agent 平台面向自有环境中的生产部署。请联系我们确认部署方案、获取发布镜像和交付操作手册，并安排环境验收。日常使用从交付的控制台地址进入。

部署前准备

提供预计设备数量、请求峰值、是否使用语音与视觉，以及现有 IoT 平台信息。结合模型服务限额、数据保留要求和维护窗口，确定初始资源与后续扩容方案。

准备项	需要确认的内容
运行环境	专用 Linux 服务器或已有 Kubernetes 环境，以及计算、存储和时钟同步。单机方案的可用性受该主机影响。
数据存储	业务数据容量、保留周期，以及备份与恢复要求。
网络与入口	控制台域名、HTTPS 证书和生产登录入口；内部服务及数据库保持私有访问。
设备接入	所选 IoT 平台、MQTT Broker、网络可达性和相应凭据。
AI 服务	模型、语音或视觉服务的访问条件、密钥与服务限额，按启用能力准备。
运行管理	指标采集与 Prometheus 连接、日志保留、备份存放位置，以及部署管理员和维护联系人。

扩容与高可用方案应结合业务连续性、网络入口和外部服务限额评估，由交付团队确认。

生产入口的登录与访问控制按交付方案配置。管理员确认用户的访问范围后，再开放对应工作空间。

在工作空间打开设置。平台使用共享的服务配置。主模型、视觉模型、MQTT 和普通平台参数只读；语音、IM 通道和工具权限提供页面支持的编辑选项。提供商的登录或绑定入口也可用于完成 IoT 平台连接授权。入口、可编辑字段与凭据处理见控制台设置。

平台部署中的只读平台提供商配置

Webhook、设备 AI 额度和平台授权在各自入口管理。工具权限控制智能体工具能力，用户登录与访问控制由生产入口管理。

支持控制台修改的设置，在对应页面保存；只读设置由部署管理员按交付手册维护。

服务设置影响当前平台部署；设备智能体卡片中的配置总览管理该智能体的设置。保存前确认修改范围。遇到配置已被其他人更新的提示时，刷新页面、核对最新值后重新修改。

保存后按页面提示确认生效情况。需要重启或维护操作时，由管理员安排时间；完成后检查连接状态，并用新的对话、语音或通知请求验证。

模型密钥、MQTT 密码、语音与 IM 凭据等由部署管理员通过受保护的部署配置维护，控制台主要显示配置状态。某些 IoT 平台登录或绑定流程会保存返回的连接凭据，应按该平台的绑定流程更新。

需要更换凭据时，由部署管理员按交付手册安排更新和验证，并告知相关使用者可能受到的影响。更新后确认连接状态及对应模型、语音或通知功能是否正常。