# 部署与配置

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

## 部署前准备

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

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

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

## 接收交付并验证入口

1. 确认交付版本、控制台地址、工作空间、配置清单及维护操作手册。
2. 管理员按交付手册部署并完成验收检查，再开放生产入口。
3. 打开控制台地址，按已配置的身份认证方式登录。核对工作空间中的设备智能体、设备和设置是否属于当前部署。
4. 检查 MQTT 连接及[监控](./monitoring.md)是否正常，再使用已经获准的业务设备验证只读查询、模型回复，以及已启用的语音或 IM 通道。

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

## 配置入口

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

![平台部署中的只读平台提供商配置](../images/docs/operate-reference/configuration/zh/10-cloud-platform-settings.png)

[Webhook](../integrations/webhooks.md)、[设备 AI 额度](./ai-credits.md)和[平台授权](./license.md)在各自入口管理。工具权限控制智能体工具能力，用户登录与访问控制由生产入口管理。

## 配置作用与生效

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

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

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

## 凭据管理

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

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

扩容、备份、恢复与升级步骤见[运维管理](./operations.md)。