AGENTWORKSHOP · 工业 AGENT 运行时
Agent 团队×产线×数字孪生
一个配置驱动的工业 Agent 运行时:Agent 团队读取真实遥测、经人工审批写入设定值, 每个事件实时流进 3D 孪生。协议是真的,断言是可复跑的。
* 全闭环 E2E 在真实协议栈上的跑批结果(124 PASS / 0 FAIL,2026-09-12,v0.7.36)。 其余是可数出来的静态事实:6 类驱动(5 内置 + serial-bridge 串口插件)/ 4 个入口(WS · MCP · A2A · REST) / 14 个 harness(agents/registry.ts)/ 99 个设置项分 16 组(aw config list)/ 7 态任务机。
真实界面
INTERFACE下面每一屏都录自正在运行的实例,不是渲染稿。三屏共用同一条事件总线—— 数采通道写进去的样本,同时是孪生画面的输入、趋势曲线上的点、以及 Agent 读到的那一行。
一段视频看完整个系统。 仪表盘 → 数采中心(六协议实时) → 写控下发与回读(真实 Modbus PLC) → 串口协议插件(真实 COM 口探针) → Agent 团队执行 → 闭环趋势(PV 跟随设定) → 3D 数字孪生环绕运镜。英文解说字幕,无剪辑无造假。
孪生就是同一条事件总线的渲染结果。 设备台账、数采通道、实时趋势、报警横条与设备健康同屏;右上角是实时渲染读数(129 FPS), 画质阶梯(DPR / 阴影 / 泛光)按墙钟帧预算自适应,中端机器上也保持诚实。
端到端的采集链路。 量规统计带(节点 / 发布 / 消费 / 丢失 / 入库)之下是逐节点台账:实时值、采样周期、 WS 下发状态、驱动类型,以及控制节点沿写链路同一套标定读回的 SET / ACT。
开跑一条产线 = 用配方窗口为采集设门。 此后每个样本都自动打上「产品 / 配方 / 批次」标识;控制节点只定义分类参数与工艺量程, 真正下发仍要过联锁与审批。
架构
ARCHITECTURE一个 manager 坐在每扇门后:四个入口汇入同一运行时;工业栈与 Agent 运行时共享同一事件总线。每一格都是仓库里可点开的真实模块。
采样:驱动 → 队列 → 消费泵 三路分发(WS 直推 · TSDB 落库 · 孪生回写) | 下发:联锁 → 审批 → PLC 写入 → 回读校验 | 存储:SQLite(channels · agents · tasks · messages · events)
设计思路
DESIGN PRINCIPLES服务端权威
界面是事实的渲染,不是事实的来源。节点、任务、授权以服务端为唯一事实源——有多少 Node,界面就有多少数采点。
数据面强制
产线权限三态(无权/仅查看/可操控)在数据面执行:无权产线的信息不离开服务端,而不是靠前端隐藏。
诚实可观测
丢弃计数、丢失指标、管线水位全部真实暴露;运维日志三源归属到「Channel/成员」。window.__townStats 连渲染指标也不说谎。
配置驱动
config.yml < runtime-settings < env,同一份描述符同时驱动 CLI 与设置页——99 个设置项(32 live / 67 restart),代码零硬编码默认。
协议真实验证
E2E 跑在真实 Modbus/OPC UA/MQTT/HTTP 栈上:真写 PLC、真回读、真审批——不是 mock 自证。当前 head 上 124 项验收断言全过(v0.7.20 历史基线 156 项)。
人在环路
Agent 提议,人批准,系统执行,全程留痕。manual 绑定的下发挂起待审,批准即真实写入,裁决人入审计日志。
能力全景
CAPABILITIES六协议数采与数控
Modbus TCP/RTU · OPC UA · MQTT · HTTP 双向驱动 + 内置串口插件(RS-232/485 直连)——连接池、故障分类诊断、逐驱动连接测试;协议即插件,新协议注入后前端表单零改动。
数控读写一体
每个控制节点沿写链路同一套标定读回 PLC 当前值——SET 与 ACT 并排呈现,读为被动观测,免审批。
人机协同写控
安全量程 ∩ 配方窗口联锁 → 人工审批 → PLC 写入 → 回读校验 → 签名写历史;裁决人留痕审计。
Recipe 版本化治理
参数按版本入史(来源+操作者+原因),一键回退任意版本或已知良好批次——非破坏,历史完整。
多引擎 Agent 团队
十四个引擎一个契约(进程内 / 常驻会话 / 无头 CLI 三类),每频道可选 harness → provider → model;可用性探测 + 执行前强校验。
团队级插件开关
每 Channel 独立插件开关组——被关闭插件的工具不注入该团队;插件本体热管理。
产线级权限
三态授权在数据面强制,无权产线信息不离开服务端;Agent 绑定校验产线授权。
全操作运维日志
用户/Agent/系统三源归属「Channel/成员」,按产线/Recipe/来源检索,WS 实时推送。
持久记忆
私有 + 共享双域,FTS5 CJK 切分,可选向量混合检索;团队编年史与空闲反思持续沉淀。
应用前景
WHERE IT FITS产线监督与孪生运维
多产线设备、数采通道、告警与趋势在一张 3D 总览上;秒级软实时,浏览器随处可达。
Agent 辅助工艺优化
「分析趋势 → 提议设定值 → 人工批准 → 写入回读 → 数值判定」的受控闭环,每一步可审计、可回退。
工业 AI 教学与科研
六协议数采/写控(串口即插件)、多引擎编排、真实模拟器栈开箱即用——论文与课程的实验床,协议真实验证。
平台化二次开发
SDK 类型化 REST 客户端 + 插件注册驱动/处理器/工具;四入口把能力开放给外部系统与 Agent。
AgentWorkShop 是监督层(SCADA 邻接),运行在秒级软实时。它不是硬实时控制器:任何 <10ms 的关键回路(联锁/安全/伺服)必须留在 PLC 内——此处写入的设定值是建议值,产线侧逻辑可以否决。
一分钟上手
QUICK START# 全局安装,任意目录启动(发布包自带预构建产物,无需再构建)
npm i -g agentworkshop
aw start # → http://localhost:3001 · 配置根 ~/.AgentWorkShop深入一步:第一次 Agent × 产线会话(约 2 分钟跑通全链) · SDK 开发指南 · 插件开发指南 · aw CLI 手册
把 Agent 接到真实产线上
14 个执行引擎、5 种现场协议、99 个运行时设置项和 124 项可复跑的验收断言都已经在仓库里。 监督层,秒级软实时;协议真实,断言可复查。