人工智能聊天助手

人工智能聊天助手用于在 WasomeCodeX_AI 中通过自然语言完成工程分析和辅助编程。助手可以读取当前工程上下文，帮助用户查看项目结构、解释程序逻辑、分析编译错误，并根据需求创建或修改 PLC 程序对象。

提示

使用前请先完成AI智能体配置，确保模型服务、API 密钥和模型名称配置正确。

适用场景

人工智能聊天助手适用于以下场景：

场景	说明
工程分析	查看项目结构、POU 列表、任务配置和主要变量。
程序解释	解释 ST 程序、功能块逻辑、状态切换和变量作用。
错误排查	根据编译输出定位变量、类型、调用关系或语法问题。
代码生成	按需求创建功能块、程序、变量和示例逻辑。
代码优化	对已有逻辑提出可读性、边界处理或结构优化建议。

前提条件

使用前请确认：

• 已打开需要分析或修改的 PLC 工程。
• 已完成大模型服务配置，并且模型连接正常。
• 需要 AI 修改工程时，已了解 自动接受 AI 写入操作 的配置状态。
• 正式工程建议先备份或确认版本管理状态，再让 AI 写入代码。

打开人工智能聊天

打开工程后，在 IDE 右侧工具栏点击 聊天 图标，打开人工智能聊天面板。

面板打开后会显示欢迎页。欢迎页提供常用快捷问题，可以直接点击发起对话，也可以在底部输入框中输入自定义问题。

界面说明

人工智能聊天面板主要包含以下区域：

区域	说明
快捷问题	点击预置问题后，AI 会按当前工程上下文生成回复。
对话记录	显示用户问题、AI 回复和执行过程。
执行记录	当 AI 需要读取工程、创建变量或写入代码时，会显示对应的操作记录。
输入框	输入自然语言问题，可使用键盘方向键查看历史提问。
发送按钮	提交当前问题并等待 AI 回复。

输入问题

在输入框中输入需要 AI 完成的任务，然后点击发送按钮。问题可以是简单咨询，也可以是明确的工程修改任务。

示例问题：

• 展示当前项目结构
• 解释 DEMO_PLC_PRG1 程序的运行逻辑
• 检查当前编译错误并给出修改建议
• 帮我写一个 PID 功能块

提问时建议说明对象、变量、功能边界和输出要求。例如生成功能块时，可以补充输入输出变量、控制周期、报警条件和命名规则。

查看 AI 执行过程

当问题涉及工程分析或代码生成时，AI 会先读取当前项目内容，再根据工程上下文制定操作步骤。视频示例中，用户输入“帮我写一个 PID 功能块”后，AI 先分析项目，再创建 PIDController 功能块。

执行过程中可以关注以下信息：

信息	说明
计划说明	AI 会先说明准备创建的对象、变量和算法逻辑。
工具调用记录	展示 AI 读取项目、创建功能块、添加变量和写入代码的过程。
项目树变化	如果 AI 创建了新的 POU 或变量，左侧项目树会同步出现对应对象。

注意

如果在 LLM 配置中关闭了 自动接受 AI 写入操作，AI 在修改工程前会等待用户确认。正式工程中建议保留人工确认，并在每次写入后检查变更内容。

复核生成结果

AI 完成后会在聊天窗口中汇总生成结果。视频示例中，AI 创建了 PIDController 功能块，并列出设定值、实际值、比例增益、积分增益、微分增益、采样周期、输出上下限和复位信号等变量。

生成完成后，请按以下顺序复核：

1. 在左侧项目树中确认新建对象是否符合预期。
2. 打开功能块或程序，检查变量类型、初始值和注释。
3. 检查 AI 写入的 ST 代码是否符合现场控制逻辑。
4. 执行编译，确认没有语法错误或变量引用错误。
5. 对涉及设备动作、联锁和安全保护的逻辑进行人工审查。

提问模板

为了获得更准确的结果，可以参考以下写法：

场景	推荐写法
查看工程	展示当前项目结构，并说明每个 POU 的作用。
解释程序	解释 DEMO_PLC_PRG1 的主要逻辑，重点说明启动、停止和异常处理。
修复错误	根据编译输出检查错误原因，并给出需要修改的文件和变量。
生成代码	创建一个 PIDController 功能块，输入包含 SetPoint、ProcessValue、Kp、Ki、Kd，输出为 Output 和 Error。
优化逻辑	检查这段程序是否存在重复判断或状态切换风险，并给出修改建议。

提示

复杂任务可以拆成多轮对话：先让 AI 分析工程，再让 AI 给出方案，确认方案后再执行创建或修改操作。

使用建议

• 提问时尽量包含程序名、变量名、控制对象和期望结果。
• AI 生成的程序需要编译验证，并结合实际设备或仿真环境测试。
• 涉及安全联锁、急停、限位、设备保护的逻辑必须由工程人员复核。
• 如果 AI 的结果不符合预期，可以直接指出需要保留或修改的部分，让 AI 继续调整。
• 需要完整项目生成或仿真测试时，可参考AI 智能体生成项目和AI 智能体仿真测试。