跳到主要内容
版本：Next

3.12、使用技巧与最佳实践

本文汇总AI助手的提示词编写技巧、跨助手协作流程和团队使用规范，帮助您更高效地使用AI页面助手、AI变量助手、AI建表助手、AI模型助手、AI图片助手、AI脚本助手、API对接助手和AI智能绑定。

3.12.1、通用提示词编写技巧​

1. 使用"5W1H"框架​

清晰的需求描述应该包含：

  • What（什么）：要实现什么功能
  • Why（为什么）：业务背景和目的
  • Who（谁）：面向哪些用户
  • When（何时）：触发时机、执行时间或刷新频率
  • Where（哪里）：应用场景、模块入口或设备范围
  • How（如何）：具体实现方式、规则或约束

不推荐的描述：

创建一个监控页面

推荐的描述：

What: 创建注塑机监控页面
Why: 用于车间现场实时监控设备状态
Who: 车间操作工和班组长使用
When: 7x24小时实时显示，数据每2秒刷新
Where: 车间大屏，分辨率1920x1080
How: 包含温度曲线、压力仪表盘、产量计数、状态指示灯和报警列表

2. 分层描述复杂需求​

对于复杂需求，建议采用"总体目标 -> 功能模块 -> 详细规则"的结构。

第一层：总体目标

创建一个MES工作站页面，用于生产现场的工单管理和数据采集。

第二层：功能模块

页面分为三个主要区域：
1. 工单信息区：显示当前工单详情
2. 数据采集区：扫码、输入、确认
3. 历史记录区：显示最近10条操作记录

第三层：详细规则

工单信息区包含：
- 工单号，大字体显示
- 产品型号、目标数量、已完成数量
- 工单状态，用颜色标识：进行中为绿色，暂停为黄色，异常为红色

3. 使用具体的数值和单位​

不推荐的描述：

显示一些温度数据

推荐的描述：

显示4个温度传感器数据，范围0-200摄氏度，保留1位小数，超过180摄氏度时红色显示。

4. 明确输入材料和参考对象​

AI页面助手、AI变量助手、AI建表助手、AI模型助手、AI图片助手和API对接助手都可以从更明确的输入材料中获得更稳定的结果。

根据上传的看板截图，参考它的布局和深色科技风格，
但内容改为二号产线的OEE、产量趋势、设备状态和报警信息。
根据上传CSV点表，里面包含变量名、寄存器地址、数据类型和读写权限。
请按Modbus TCP协议解析，设备IP为192.168.1.100，端口为502。

5. 明确优先级​

对于多个需求，建议标注优先级，帮助AI先保证核心功能。

必须包含：
- 实时温度显示
- 设备状态指示
- 报警列表

重要但可后续调整：
- 温度历史曲线
- 班次产量统计

可选：
- 预留设备3D模型占位

3.12.2、跨助手推荐工作流​

1. 从设备接入到页面展示​

适用于新设备接入、产线监控页和项目交付场景。

  1. 使用 AI变量助手 生成设备点表，形成标准变量
  2. 使用 AI建表助手 创建历史库、聚合统计表或业务数据表
  3. 使用 API对接助手 配置 MES、ERP、云平台等第三方系统 API
  4. 使用 AI页面助手 生成监控页面、看板或大屏，需要展示设备要求提前预留占位
  5. 使用 AI模型助手 生成设备3D模型，使用 AI图片助手 生成或美化设备图片素材
  6. 使用 AI智能绑定 将页面组件与变量、数据表绑定
  7. 使用 AI脚本助手 补充复杂业务逻辑、数据加工和自动化控制
  8. 在测试环境中验证数据、交互、接口、脚本和页面展示效果

2. 原型验证优先流程​

适用于投标演示、客户沟通和方案评审。

  1. 使用 AI页面助手 快速模式生成页面原型
  2. 用 AI模型助手 生成关键设备3D模型并在页面上引用
  3. 根据客户反馈使用页面助手进行局部重构
  4. 需求稳定后再补充变量、建表、API对接、绑定和脚本逻辑

3. 工程交付优先流程​

适用于标准严格、需要真实数据和可维护性的项目。

  1. 先整理变量命名规范、点表和数据归档规则
  2. 使用 AI变量助手 完成变量标准化解析生成
  3. 使用 AI建表助手 完成历史库和运行、业务数据表配置
  4. 使用 AI页面助手 引导模式生成页面
  5. 使用 AI智能绑定 并逐项审核绑定建议
  6. 使用 API对接助手 完成标准 API 互联配置并预检调试
  7. 使用 AI脚本助手 生成复杂逻辑脚本后做测试验证

3.12.3、按助手类型的最佳实践​

1. AI页面助手​

选择合适的生成模式​

  • 快速模式：适合方案前期构思、概念验证和页面原型探索
  • 引导模式：适合工程交付、需求明确、标准严格的页面生成

页面生成公式​

页面主题 + 使用场景 + 视觉风格 + 布局结构 + 展示数据 + 交互要求

示例：设备监控页

创建注塑机监控页面，用于车间大屏实时查看设备状态。
采用深色科技风格，分辨率1920x1080。

布局：
- 顶部：设备名称、当前班次、运行状态和时间
- 左侧：三段料筒温度曲线
- 中间：注射压力仪表盘、锁模力仪表盘和设备示意图
- 右侧：产量、周期时间、合格率和报警列表
- 底部：启动、停止、复位、急停按钮

要求：
- 状态颜色：运行绿色，待机黄色，故障红色
- 关键数据使用大字体
- 报警信息最多显示10条

使用参考图和素材模版​

如果有目标样式，优先上传参考图或选择素材模版，并补充说明哪些部分需要参考。

请参考我上传图片的三列布局和深色配色，
但不要照搬文字内容。
页面主题改为包装产线监控，
中间区域展示产线流程，右侧展示报警和工单信息。

善用局部重构​

页面整体满意但局部不合适时，不需要重新生成整页。先框选目标区域，再说明修改点。

只调整我选中的区域：
1. 把报警列表改为卡片列表
2. 每条报警显示时间、设备名、报警等级和处理状态
3. 高级报警使用红色强调

2. AI变量助手​

点表准备建议​

AI可以解析不完全规范的点表，但规范表头能显著提升准确率。建议点表至少包含：

  • 变量名
  • 地址或寄存器
  • 数据类型
  • 读写权限
  • 单位
  • 描述

一次性补齐协议参数​

如果已知设备通讯参数，建议在首次对话中一起说明。

请导入这份CSV点表。
协议为Modbus TCP，设备IP为192.168.1.100，端口502，站号1。
变量名前统一加前缀 Line2_，并保留原始描述。
请先生成导入方案，确认后再执行。

小批量变量创建​

帮我创建一个S7设备通道，IP是10.0.0.5，Rack为0，Slot为1。
变量包括：
- 温度，DB1.DBD0，Float，只读
- 压力，DB1.DBD4，Float，只读
- 启停状态，DB1.DBX8.0，Bool，只读

变量命名规范​

建议团队统一变量命名方式，便于后续智能绑定和建表。

设备类型_设备编号_参数类型_参数编号

示例：
- Injection_M1_Temperature_01
- Injection_M1_Pressure_Main
- Packaging_L1_Speed_Conveyor

3. AI建表助手​

先判断建表类型​

  • 历史库：用于连续采集、趋势曲线、设备运行数据追溯
  • 数据管理表：用于业务归档、统计分析、基础资料维护和聚合计算

历史库归档提示词​

把二号产线所有温度和压力变量做历史归档。
温度变量使用变化记录，死区0.5摄氏度；
压力变量每10秒定时记录一次。
请按变量类型自动分组，生成历史组方案，我确认后再执行。

数据管理建表提示词​

帮我创建二号产线班次能耗统计表。
字段包括：
- 班次名称，String
- 开始时间，DateTime
- 结束时间，DateTime
- 用电量，Float，单位kWh
- 用水量，Float，单位t
- 压缩空气消耗，Float，单位Nm3

数据来源从二号产线的电表、水表和气耗变量中匹配。
按早班、中班、晚班生成统计规则。
请先生成方案。

字段超过十个时先整理附件​

如果字段较多，建议先整理为CSV，再上传给AI。字段清单建议包含字段名、字段类型、是否必填、默认值、来源变量和备注。

4. AI模型助手​

文生3D提示词公式​

行业场景 + 设备类型 + 结构特征 + 材质颜色 + 风格要求

示例：

一个用于化工厂的立式储罐，采用不锈钢材质，表面光滑无焊缝，顶部配有安全阀和液位计，底部为锥形封头，整体呈银灰色金属光泽，写实工业风，背景可加入管道与仪表，展现严谨的工程感

图生3D图片准备建议​

  • 背景尽量简单，最好是纯色
  • 图片中只保留一个主体设备
  • 主体不要太小，轮廓要清晰
  • 尽量避免文字、水印和遮挡
  • 使用清晰图片，越清晰生成效果越好，分辨率不低于128x128

模型面数选择建议​

  • 快速看效果：先选择较低面数
  • 页面重点展示：选择中等或较高面数
  • 多设备同屏展示：控制面数，避免影响页面性能

5. AI图片助手​

设备图片提示词公式​

设备类型 + 结构特征 + 展示角度 + 材质颜色 + 风格要求 + 页面用途

示例：单台设备图片

生成一张注塑机设备图片，
三分之二侧视角，
蓝灰工业风格，
设备结构完整，背景干净，
适合用于组态页面展示。

示例：金属设备展示图

生成一张立式储罐设备图片，
正视角，
不锈钢材质，
写实展示风格，
背景干净，
适合用于组态页面中的设备展示区。

参考图美化和抠图写法​

如果已有现场设备照片，优先上传参考图，再说明保留内容、优化方向和最终用途。

参考这张设备图，
保留主体轮廓和正视角，
优化设备质感，
去掉杂乱背景，
背景处理干净，
用于组态页面设备展示区。

保持设备图片和页面风格一致​

生成图片前，先确定页面风格，再把设备视角、材质颜色、背景复杂度和最终用途写清楚。用于组态页面的设备图片应突出设备主体，避免过度装饰影响数据阅读。

6. AI脚本助手​

模块化脚本开发​

将复杂脚本拆分为多个模块，分别生成后组合。

数据获取模块

编写数据获取类DataFetcher：
- 方法：GetFromAPI(url, params)
- 功能：调用HTTP API获取数据
- 返回：JSON对象
- 异常处理：超时重试3次，失败返回null

数据处理模块

编写数据处理类DataProcessor：
- 方法：ParseJSON(jsonString)
- 功能：解析JSON，提取指定字段
- 返回：Dictionary<string, object>
- 异常处理：解析失败记录日志

数据存储模块

编写数据存储类DataStorage：
- 方法：SaveToDatabase(data)
- 功能：批量插入数据库
- 返回：成功记录数
- 异常处理：事务回滚

明确触发条件和异常处理​

当变量WorkOrderID发生变化时，调用MES接口获取工单信息。
要求：
- 如果WorkOrderID为空，不调用接口
- 接口超时时间10秒
- 失败时记录错误日志，不影响主流程
- 成功后写入ProductModel和TargetQuantity变量

性能优化提示词​

请优化这段脚本的性能：
[粘贴原代码]

要求：
- 避免循环中逐条写数据库
- 使用批量处理
- 每批处理100条
- 添加异常处理和日志

7. API对接助手​

优先提供完整接口材料​

API 对接配置最依赖接口材料的完整度。建议优先提供 cURL、接口文档、请求参数说明和成功响应示例。

请帮我配置 MES 工单查询接口。

接口信息：
- Method：POST
- URL：http://mes.company.com/api/workorder/query
- Header：Authorization=Bearer {{MESToken}}，Content-Type=application/json
- Body：{"workOrderId":"{{WorkOrderID}}"}

响应示例：
{
  "code": 0,
  "data": {
    "productModel": "A100",
    "targetQty": 500
  }
}

映射关系：
- data.productModel -> ProductModel
- data.targetQty -> TargetQuantity

多接口先说明公共配置​

同一系统的多个接口建议一次性说明 Base URL、全局 Header、认证方式和超时时间，方便 AI 自动提取复用配置。

以下接口都属于 ERP 系统：
- Base URL：http://erp.company.com/openapi
- 全局 Header：X-App-Key={{ERPAppKey}}，X-Sign={{ERPSign}}
- 超时时间：10秒

接口包括：
1. GET /orders/pending：获取待生产订单
2. POST /orders/complete：回写完工结果
3. POST /alarm/report：上报告警

预检失败要提供错误上下文​

排查接口问题时，提供 HTTP 状态码、错误返回、当前 Header、Params 和 Body，比只描述“接口不通”更有效。

接口预检失败，请帮我排查。

错误信息：
- HTTP状态码：401
- 返回：{"message":"Unauthorized"}

当前配置：
- Method：GET
- URL：http://cloud.company.com/api/device/status
- Header：Content-Type=application/json
- Params：deviceId={{DeviceID}}

8. AI智能绑定​

精确选择变量范围​

选择变量范围时，尽量选择最小可用范围。页面只涉及单台设备时，不要勾选整个车间。

页面类型推荐通道范围匹配效果
单设备监控页选择该设备通道最稳定
多台同类设备选择设备组通道较稳定
车间综合看板选择车间通道需要重点审核
全厂大屏选择多个车间通道需要逐项确认

第一次使用建议逐项审核​

AI智能绑定提供的是建议，最终应用前应检查组件含义、推荐变量和置信度。低置信度、警告或失败项需要手动确认。

批量处理相似页面​

  1. 第一个页面使用智能绑定并仔细审核
  2. 保存为页面模板或复制页面
  3. 修改设备编号和通道范围
  4. 重新运行智能绑定
  5. 抽查关键数据点

3.12.4、提示词模板库​

注塑行业设备监控页​

创建注塑机监控页面，工业深色风格。

设备信息：
- 设备名称：[设备编号]
- 监控参数：料筒温度3段、模具温度、注射压力、锁模力
- 生产数据：周期时间、产量计数、合格率
- 控制按钮：启动、停止、急停、复位

布局要求：
- 顶部：设备名称、运行状态、当前时间
- 左侧：温度曲线图
- 中间：压力和锁模力仪表盘
- 右侧：生产数据和控制按钮

包装产线监控页​

创建包装产线监控页面。
产线组成：上料机 -> 包装机 -> 封口机 -> 贴标机 -> 装箱机。

显示内容：
- 产线流程图，横向布局，显示5台设备
- 每台设备显示设备名称、运行状态、当前速度和产量
- 底部显示产线总产量、合格率和当前工单信息

交互功能：
- 点击设备图标，弹出详细参数
- 实时刷新，刷新间隔2秒

能耗监控大屏​

创建能源管理大屏，分辨率1920x1080。
监控范围：5个车间，每个车间监测电、水、气。

布局：
- 顶部：总能耗、今日能耗、本月能耗、本年能耗
- 左侧：最近24小时能耗趋势和车间能耗对比
- 中间：工厂平面图和实时功率曲线
- 右侧：能源类型占比、能耗排名和报警信息

主题：
- 绿色环保风格
- 背景深色
- 高亮色使用青蓝和绿色

变量点表导入​

请解析并导入我上传的CSV点表。
协议为Modbus TCP，设备IP为192.168.1.100，端口502，站号1。
请识别变量名、寄存器地址、数据类型、读写权限和描述。
如果发现缺少必要参数，请先通过卡片向我确认。
正式写入前，请先展示导入方案。

历史库归档​

请为二号产线创建历史库归档方案。
归档对象：所有温度、压力、转速变量。
温度使用变化记录，死区0.5；
压力和转速使用定时记录，间隔10秒。
请按变量类型自动分组，生成历史组方案后让我确认。

设备3D模型​

生成一个用于组态页面展示的3D设备模型：
化工行业，立式储罐，不锈钢材质，
顶部有管道接口，底部有支架，
结构清晰，写实工业风。

设备图片素材​

生成一张用于组态页面展示的空压机设备图片。
正侧结合视角，
蓝灰工业风格，
结构完整，背景简洁，
适合放在设备监控页面的主展示区。

3.12.5、常见问题解决方案​

问题1：AI生成的页面不符合预期​

常见原因：

  • 需求描述不够清晰
  • 缺少布局、分辨率或风格要求
  • 没有说明核心数据和优先级

解决方案：

  1. 使用"5W1H"框架重新描述需求
  2. 上传参考图或选择素材模版
  3. 使用引导模式补齐需求
  4. 对局部问题使用框选区域重构

问题2：变量助手解析不准确​

常见原因：

  • 点表表头不规范
  • 缺少协议、IP、端口等通道参数
  • 变量名、地址或数据类型混杂在备注中

解决方案：

  1. 尽量整理清晰表头
  2. 在首次对话中补齐协议和设备参数
  3. 先让AI输出导入方案，再确认执行
  4. 对解析错误项直接在对话中要求修正

问题3：建表方案和业务口径不一致​

常见原因：

  • 未先创建好变量
  • 需求描述不清晰
  • 变量范围过大或变量命名不清晰

解决方案：

  1. 先在变量管理模块创建好变量
  2. 明确说明具体的建表需求
  3. 执行前核对方案卡片

问题4：智能绑定准确率低​

常见原因：

  • 变量命名不规范
  • 选择的通道范围过大
  • 变量缺少描述信息

解决方案：

  1. 优化变量命名，使用有意义的名称
  2. 为变量添加详细描述
  3. 精确选择设备通道范围
  4. 使用变量分组功能
  5. 对低置信度结果逐项审核

问题5：模型或图片素材不适合页面​

常见原因：

  • 提示词只描述了主体，没有说明页面用途
  • 风格、色彩和构图与页面不一致
  • 设备图片主体不完整、背景杂乱或质感不适合组态页面
  • 图片或模型细节过多，影响页面性能或数据阅读

解决方案：

  1. 明确素材用途，例如设备主图、设备示意图、图片组件展示或3D组件展示
  2. 说明页面风格、设备角度、材质颜色和背景要求
  3. 模型先用较低面数验证效果，再提高细节
  4. 图片优先突出设备主体，现场照片可使用参考图美化和抠图
  5. 生成后放入真实页面中检查拉伸、裁切、分辨率和风格一致性

问题6：脚本有性能或稳定性问题​

常见原因：

  • 循环中有耗时操作
  • 没有使用批量处理
  • 缺少异常处理和日志
  • 没有明确超时、重试和失败策略

解决方案：

  1. 向AI提问："如何优化这段代码的性能？"
  2. 明确性能要求，例如处理1000条数据需在1秒内完成
  3. 指定优化方向，例如批量处理、缓存、异步调用
  4. 在测试环境中验证脚本结果

问题7：接口预检失败​

常见原因：

  • Header 缺失或认证方式错误
  • URL、Path、请求方法或端口配置错误
  • Params 或 Body 中的字段名、字段类型不符合接口要求
  • 响应字段路径和实际返回结构不一致
  • 第三方系统网络、白名单或权限未开通

解决方案：

  1. 提供 HTTP 状态码、错误返回、当前 Header、Params 和 Body 给 AI 分析
  2. 确认 Token、AppKey、签名等认证信息来源是否正确
  3. 提供成功响应示例，让 AI 重新生成响应映射
  4. 先用一个核心接口验证网络和认证，再扩展多接口配置
  5. 写入前核对 AI 展示的预检结果和失败建议

问题8：积分消耗过快​

常见原因：

  • 频繁重复生成和对话编辑
  • 需求描述不清导致多次尝试
  • 没有复用已有成果
  • 每次对话都可能消耗积分

解决方案：

  1. 第一次生成前仔细检查需求描述，一次性说清楚
  2. 复杂任务先让AI输出方案，再执行生成或写入
  3. 保存优秀页面、提示词、变量命名规范和建表模板
  4. 对页面局部问题使用局部重构，不要反复整页生成
  5. 复用相似页面、脚本、设备模型和设备图片素材

3.12.6、团队协作建议​

1. 建立团队提示词库​

按行业、页面类型、脚本类型、接口系统类型、变量协议、建表类型、设备模型类型和设备图片类型沉淀常用提示词，减少重复试错。

2. 建立命名和字段规范​

建议统一以下规范：

  • 变量命名规范
  • 通道命名规范
  • 页面命名规范
  • 数据表命名规范
  • 字段命名和数据类型规范
  • 素材命名和分类规范

3. 建立审核机制​

AI生成结果应经过人工审核。尤其是变量生成、建表、接口配置、脚本、智能绑定等会影响生产数据和运行逻辑的内容，建议至少完成一次测试环境验证。

4. 沉淀可复用资产​

将验证通过的页面、接口配置、脚本、数据表结构、历史库策略、设备模型、设备图片素材和提示词整理成团队资产，后续项目可以快速复用。

3.12.7、相关文档​

  • AI助手概述 - 回到 AI 助手能力总览，了解各助手的定位和推荐学习路径。
  • AI变量助手 - 学习设备点表解析、变量创建和变量入库。
  • AI建表助手 - 学习历史归档、统计表和业务数据表配置。
  • AI页面助手 - 学习监控页面、看板和数据大屏生成。
  • AI智能绑定 - 学习页面组件与变量、数据表的快速绑定。
  • API对接助手 - 学习 MES、ERP、云平台等第三方系统 API 互联配置。
  • AI脚本助手 - 学习复杂业务逻辑、数据加工和自动化控制脚本生成。
  • AI模型助手 - 学习设备三维模型生成。
  • AI图片助手 - 学习设备图片、示意图和现场照片美化。