AI 边缘助手
在网关界面内，可以用自然语言询问边缘数据。 像“现在有无法采集的连接吗？”这样提问，AI 会自行选择所需的查询并回答。
默认关闭
ai.enabled 是 false。若要使用，需在设置中开启，并输入模型地址和密钥
（参见下方开启方法）。
可以询问哪些内容
边缘内部的内容——边缘状态 · OPC 连接 · 标签 · 采集状况。 上层平台的设备层级或报警不在本助手的范围内。
| 这样提问 | AI 使用的工具 |
|---|---|
| “显示连接列表” | 连接列表查询 |
| “3号连接现在怎么样？” | 连接详情 · 采集状况 |
| “这个标签现在值是多少” | 标签当前值（可一次查询多个） |
| “刚才开始值就不对，显示近一小时的数据” | 标签历史 |
| “数据能正常上传到上层吗？” | 传输队列状态 |
| “现在网关负载怎么样” | 监控指标 |
也可以附加图片——拍摄仪表或屏幕，连同图片一起提问。
🔴 控制操作需要「批准」
AI 可使用的工具中，有三个会改变状态。
| 工具 | 功能 |
|---|---|
start_opc | 启动连接 |
stop_opc | 停止连接 |
write_tag | 向标签写入值 |
这三个工具不会由 AI 独自执行。 会弹出“是否批准此控制操作？”，必须由人工点击批准后才会执行。若取消，则不会发生任何操作。
批准不会长期有效
若批准请求弹出后放置较长时间再点击，会提示**「批准已过期或无效」**。此时请重新提问。
标签的只读设置依然优先
client_access 为 R 的标签，即使 AI 获得批准也无法写入。 由于助手使用的通道与现有 API 相同，相关限制依然生效 →
添加标签
查询类工具（列表 · 值 · 历史 · 状态）不改变状态，因此无需批准即可直接执行。
开启方法
在 app.properties 中设置 → Web UI 环境设置
| 设置项 | 默认值 | 说明 |
|---|---|---|
ai.enabled | false | 开/关 |
ai.api.base_url | （空值） | 模型服务器地址——内部网关或本地服务器 |
ai.api.key | （空值） | 该服务器的密钥 |
ai.model | gpt-4o-mini | 模型名称 |
ai.max_tool_steps | 8 | 单个问题中最多调用工具的次数 |
ai.timeout_ms | 30000 | 响应等待 |
ai.bulk_read_limit | 50 | 单次读取标签数的上限 |
如果未开启，会显示如下信息
「AI 助手已禁用。请在设置中指定 ai.enabled 和 ai.api.base_url。」——两者都必须设置才能正常工作。
请确认模型服务器地址
若 ai.api.base_url 指向外部互联网，现场数据将泄露到外部。
如果现场处于隔离网络或禁止数据外传，请将其指向内部网关或网关内运行的本地模型。密钥不会被记录到日志中。
无法正常工作时
| 症状 | 原因 |
|---|---|
| “已禁用” | ai.enabled 未开启，或 ai.api.base_url 为空 |
| “无法响应” | 模型服务器无法访问——检查地址 · 密钥 · 防火墙 |
| “过于复杂” | 该问题难以一次性回答。请缩小范围后重新提问 |
| “批准已过期或无效” | 批准请求已过时。请重新提问 |
| 控制被拒绝 | 标签的 client_access 为 R |