控制台设置

从 Device Agent 控制台左侧导航进入 设置，维护设备智能体共用的模型、语音服务和平台连接。平台部署还显示 AI 额度 和 License 授权。

设置入口

单个智能体的提示词、时区、热词、语音工具范围、身份回复与等待反馈，在卡片 更多 → 配置总览 中维护，详见设备智能体配置。

入口	内容
平台接入	平台提供商、MQTT 配置。
模型	智能体模型、视觉模型、决策模型、语音模型。
IM 通道	聊天平台连接、开关和允许来源。
权限	智能体工具权限与允许执行的命令前缀。
Webhook	可供对话和工作流使用的出站通知连接。
AI 额度	平台设备消费额度与余额。
License 授权	平台请求授权与有效期。

本地运行可以编辑全局设置。平台部署中的日常编辑范围如下：

设置	平台控制台中的操作
智能体模型、视觉模型、决策模型、MQTT、普通平台连接参数	查看配置；修改时联系部署管理员。
语音、IM 通道、工具权限	修改允许编辑的参数，按保存后的提示等待生效。
服务凭据	查看是否已配置，更换凭据时联系部署管理员。
Webhook、AI 额度、License	通过对应入口管理，具体要求见相关文章。

提供商若有单独的登录授权入口，可按该入口完成连接授权。

平台接入

平台提供商

进入 平台接入 → 平台提供商，查看所选 default、fleets 或 thingsneural 的连接参数、物模型、主题模板和载荷示例。提供商决定设备模型和消息协议，接入设备时使用匹配的配置。各提供商的接入方式见IoT 平台集成。

Default 由 Device Agent 直接管理设备模型、设备记录与上报状态，设备通过 SDK 或 MQTT 连接。EMQX Fleets 和 ThingsNeural 则沿用对应平台的管理与协议。

查看 ThingsNeural 平台示例。

MQTT 配置

进入 平台接入 → MQTT 配置，查看 Device Agent 与 MQTT Broker 的连接状态。本地运行可以修改以下设置；平台部署由运行服务管理连接，常规参数只读。

区域	配置内容	说明
连接地址	Broker URL、WebSocket URL、Client ID	brokerUrl 供网关和设备侧连接使用；wsUrl 供浏览器通过 MQTT over WebSocket 使用。
连接参数	MQTT 版本、Keep Alive、连接超时、自动重连、重连间隔、Clean Start、会话过期时间	MQTT 5 才会显示会话过期时间。
认证	用户名、密码	对应 MQTT Broker 的账号认证。
TLS	TLS 开关、证书校验、CA、客户端证书、客户端私钥、私钥密码、Server Name	可以上传证书文件，上传后文件会保存到运行目录下的 certificates 目录。
主题模板	文本请求、设备命令、命令响应、遥测、事件、NTP 等主题	当前 UI 中只读。本地自定义主题使用 .env 或配置文件；平台主题遵循选定提供商的协议。

本地控制台保存后，Gateway 会按新配置重新连接。直接修改 .env 或配置文件后需要重启。平台连接状态和重启验证见 平台运维。Broker 选择和 Zero EMQX 配置见 准备 MQTT Broker。

模型

进入 模型 → 智能体模型，选择服务商和模型，填写凭据，调整推理与迭代上限。视觉模型控制图像分析：auto 复用支持图像输入的主模型；dashscope 使用独立模型和 API Key。本地运行可以保存这些设置，平台控制台提供只读查看。

大模型指南提供字段含义、推理等级、Cloudflare 账户与 Gateway ID、Codex 认证及启动示例。图像分析字段见视觉模型配置。

决策模型

进入 模型 → 决策模型，查看或配置 TypeSafe Jev 的启用状态、模型、接口密钥和超时。配置步骤、工作流决策节点和快捷指令见Jev 决策模型。

语音模型

进入 模型 → 语音模型，启用语音，选择区域与服务商，配置识别、合成和凭据。平台只显示凭据状态，更换时联系部署管理员。保存与重启要求见配置生效规则。

本地直连时，复制 语音连接地址 并确认客户端可访问其主机和端口；平台使用管理员发布的公网语音 WebSocket 地址。HTTPS 控制台使用 wss://，监听地址与公网地址的区别见监听地址和 TLS。

服务商字段、ASR/TTS 选择、词表适用范围、连接地址和 .env 示例见语音配置。分别配置单个智能体的识别热词、语音工具范围及身份回复、等待提示和超时回复。

IM 通道

进入 IM 通道，选择飞书、钉钉、Discord、Telegram 或 Slack，核对凭据并设置允许来源。各平台所需凭据和配置步骤见IM 接入。

allowFrom 限制允许访问设备智能体的用户或会话来源，多个值可以用逗号或换行分隔。本地可编辑凭据；平台凭据显示配置状态，开关、标识和允许来源等可编辑字段可修改。本地保存后重启使 IM 设置生效；平台修改 IM 配置后，联系部署管理员重启相关服务。主动发送通知使用的目标在发送请求或工作流中指定。

权限

权限标签页控制设备智能体的工具权限。这些开关约束工具执行，不提供控制台用户管理或角色权限。

权限	说明
tool_editor	允许保存和删除工具编辑器扩展。
write_file	允许智能体写入本地文件。
execute_command	允许智能体执行命令。
allowedPrefixes	限制允许执行的命令前缀，例如 pwd、ls、rg。

保存后，工具执行按当前权限设置处理。本地使用环境变量配置时，同名变量会在重启后覆盖控制台值，变量参考见环境变量。

Webhook

Webhook 标签页用于管理 Agent 对话和工作流可复用的出站通知连接。

连接支持保存、测试、启停、编辑和删除，不需要重启 Device Agent。测试会真实发送消息；工作流仍在引用连接时不能删除。配置步骤与平台预设见创建并测试连接，签名、模板与响应规则见配置自定义 Webhook，投递限制见安全与投递边界。

AI 额度

每设备预算、计费规则和余额调整见 AI 额度。

License 授权

平台请求额度（RPM）、授权有效期及更新方式见 License 授权。

需要确认保存后的运行状态时，查看 监控；服务部署与凭据更新见 平台部署。