跳至内容

对话式使用说明书:三个 AI 角色撰写、佐证并检查您的说明书

所有截图均来自运行中的应用程序(英文界面),演示项目为打包机 BP-200

依据机械指令附录 I 第 1.7.4 条的使用说明书,不是随手让聊天机器人“快速”写出的文字。它是符合性证据的一部分,其中的每个数字都会产生后果。对话式使用说明书用三个角色来解决这个问题:编审依据您的项目数据维护信息简表,作者在文档中可见地撰写,审核员报告一切没有依据的内容。本文通过一次真实会话展示这种方式的样子、它的最大优势以及局限所在。

为什么不该让聊天机器人撰写使用说明书

诱惑显而易见:把机器描述粘贴进语言模型,“帮我写第 3 章,技术数据”,几秒钟后就得到一段流畅的文字。问题不在文风,而在出处。通用模型并不了解您的机器。它见过成千上万份使用说明书,并补上其中通常会出现的内容:400 V、50 Hz、低于 70 dB(A) 的声压级、每运行 500 小时维护一次。看上去合理,可以直接打印,对您的机器却可能是错的。

附录 I 第 1.7.4.2 条规定了使用说明书的内容,从预定使用、剩余风险到噪声排放信息。这些内容必须与风险评估和符合性声明一致,否则技术文件就会自相矛盾。在随意撰写的 AI 文本中,反复出现三种错误模式:

  • 编造的数字。项目中根本没有的数值,却听起来理所当然,因而顺利通过了审阅。
  • 千篇一律的安全章节。教科书式的警示,而不是您的风险评估实际识别出的剩余风险。
  • 无法追溯。事后没有人能说清某句话从何而来、是否仍与风险评估的当前状态一致,以及由谁检查过。

三个角色,而不是一个聊天机器人

对话式使用说明书把“知道”“撰写”和“检查”分开。三个角色基于同一份信息简表工作,谁也不能凌驾于其他角色之上:作者只能写编审已佐证的内容,若仍写了无依据的内容,审核员会报告。这些角色运行在 Anthropic 的 Claude 模型上,作者使用能力最强的模型,编审和小节审核员使用速度较快的模型。

角色任务您能看到什么
编审根据项目、风险评估、标准检查清单、符合性声明、测试值和安全功能建立信息简表。每条事实都带有出处和日期。14 条缺口规则会找出仍然缺少的内容;您的输入与数据库之间的矛盾会被标出。“信息简表”标签页:计数器、分类、每条事实的来源、未解决的缺口。
作者只通过工具在文档中写入:撰写小节、插入表格、设置警示、起草章节。先读取已有内容。如果缺少某项信息,就提问或设置带名称的占位符。不会猜测。每一轮的工具标签,小节在文档中实时成形,带回答栏的追问。
审核员21 条固定检查规则,并注明在附录 I 中的依据,另外还有对每个新小节对照信息简表的 AI 检查:无依据的数字、编造的标准、符合性声明、缺少三段式结构的警示。“审核员”标签页:红色、黄色和提示类判定结果,每条结果同时直接显示在受影响小节的下方。

一次会话如何进行

界面刻意设计得像一次对话:左侧是对话历史,输入框在底部;右侧是文档,带有“文档”“信息简表”和“审核员”标签页。面板可以折叠,应用程序的侧边栏也一样。以下截图来自使用演示项目(一台液压打包机)的真实会话。

1. 下达指令

一句话就够了,也可以用一张建议卡片。文档右上角已经显示信息简表从项目中了解到的内容;输入框中的计数器显示还有多少项信息待填。

对话式使用说明书的起始界面:左侧是问题“使用说明书应包含哪些内容?”,带输入框和四张建议卡片,右侧是文档,显示打包机 BP-200 的第 1 章和第 2 章
起始界面:左侧是给作者的指令和建议卡片,右侧是文档。计数器“10 项待填信息”显示信息简表还不了解的内容。

2. 作者读取并可见地撰写

每次修改之前,作者都会先读取现有小节。随后新文本在右侧文档中实时逐字出现,并显示提示“作者正在撰写”。每一轮都可以用“停止”取消。

作者正在工作:左侧是指令“重写第 2 章中的预定使用小节”,左下角是“停止”按钮,右侧是文档
下达指令后,作者的工作是可见的。所写的小节在撰写过程中就出现在右侧的文档里;每一轮都可以停止。

3. 工具、回复、检查

一轮结束后,标签会显示作者使用了哪些工具。它在聊天中的回复保持简短:做了什么、还有什么未决、需要您做出什么决定。章节文本从不在聊天中重复;它在文档里。审核员会在后台检查新小节。

已完成的一轮:工具标签“正在读取小节:安全 / 2.1”和“正在撰写小节:安全 / 2.1”,其下是作者的简短回复,右侧文档中是新的 2.1 小节
每一轮都会显示作者做了什么:先读取,再撰写。聊天中的回复保持简短;正文在文档里。

亲手试试:90 秒的一次会话

演示用固定的示例文本重放一次会话,无需 AI 请求,也无需登录。请回答问题,然后在文档中选中一句话,请求在某个具体位置进行修改。在应用程序中,作者依据您的项目数据撰写。

液压打包机 BP-200 · 机械指令 2006/42/EC · 模拟会话,无 AI 请求
2 安全
2.1 预定使用
本机用于压实纸板和薄膜。不得处理其他材料。
2.2 可合理预见的误用

在行程运行时伸手进入压缩腔,绕过联锁的上料门……

提问,而不是猜测

与聊天机器人最重要的区别,在缺少信息时最为明显。对于“技术数据”表,打包机的信息简表从风险评估中知道工作压力、压制力和打包重量,却不知道总质量、外形尺寸和电气连接参数。作者用有依据的数值创建表格,并就其余内容最多提出三个带回答栏的具体问题。

作者的追问,带三个回答栏:总质量、外形尺寸和电气连接参数,其下是“发送回答”和“稍后”按钮
信息缺失时,作者会提问而不是猜测。问题附带回答栏;每个回答都会成为有依据的事实。

您的回答不会作为零散文字留在历史记录中,而是成为标注为“您的输入”的事实。下一轮中作者直接使用它们,这里是用于第 3 章的表格。

历史记录中已回答的追问和作者的回复:三个数值已作为表格补充到第 3 章
回答进入信息简表,并立即出现在第 3 章的“技术数据”表中。作者询问是否要把两张表合并。

信息简表可随时查看。它是作者工作的依据,也是审核员检查的基准:事实按类别排列,每条都有来源和日期,另有未解决的缺口。如果对话中的某项信息与数据库矛盾,该事实会被标为矛盾,作者会提问而不是自行决定。

“信息简表”标签页:版本和事实数量、未解决的缺口、技术数据等分类及其数值和来源;来自对话的信息标注为“您的输入”
编审的信息简表:顶部是未解决的缺口,其下按类别列出事实,每条都有来源和日期。来自对话的信息标注为“您的输入”;与数据库的矛盾会被标出。

如果您希望一次性补齐缺口,输入框中的计数器会打开“回答未填项”表单。您填写的内容会直接作为有依据的事实采纳,不经过模型。您不清楚的内容保持为空;这些位置在文本中会得到带名称的占位符,审核员会一直报告,直到获得批准。

输入框上方的表单“回答未填项”,含关于环境条件、吊点、基础和操作元件的问题,计数器“已回答 0 / 7”
所有待填信息一目了然:您在这里填写的内容会作为有依据的事实进入信息简表。您不清楚的内容保持为空。

审核员:把附录 I 当作检查规则

审核员分两个层次工作。21 条固定检查规则在每次修改时运行,不使用模型,并注明在附录 I 中的依据。此外,AI 会对照信息简表检查每个新撰写的小节:没有证据的数字、检查清单中没有的标准、并非来自声明的符合性陈述。固定规则示例:

  • 附录 I 第 1.7.4.2 条规定的必备章节为空或被隐藏
  • 文本中仍有未填的占位符(“[填写制造商提供的总质量]”)
  • 警示缺少三个部分:危险的类型和来源、后果与对策
  • 没有关于故障排除的小节(附录 I 第 1.7.4.2 条第 (r) 项和第 (s) 项)
  • 图无图题、表无表题或表头行、交叉引用无目标
  • 会破坏导出的 Markdown 或重复标题
  • 自撰写以来项目数据已发生变化的章节
  • 剩余风险高且未被接受、但安全章节中未处理的危险

每条判定结果都会出现在“审核员”标签页中,并直接显示在受影响小节的下方。“让 AI 修正”会把它变成给作者的指令。“忽略”需要填写理由,理由会随项目记录,以便日后仍可追溯某条提示为何被有意不予采纳。

“审核员”标签页,含三条判定结果:两条红色检查规则 L01,针对为空的必备章节“装配”和“维护”;一条黄色检查规则 L14,针对缺失的故障排除小节
审核员会为每条判定结果注明附录 I 中的依据。红色结果涉及必备内容,黄色结果涉及形式。每条结果都可以让 AI 修正,或附理由后忽略。

选中、请求更改、继续

使用说明书的大多数修改都很小:一句话太长,用列表代替段落,缺少一条提示。对此,您只需在文档中选中相应段落。鼠标位置会出现“在对话中更改”,该段落作为引文进入输入框,您写下需要如何不同。作者会读取该小节,只修改选中的段落,其余内容逐字保留。

文档 2.1 小节中被选中的句子;鼠标位置出现“在对话中更改”按钮
在文档中选中文字,点击“在对话中更改”:该段落会作为引文进入输入框。
输入框,带引文卡片“标记位置 · 2 安全 / 预定使用”和指令“把这段改写成项目符号列表,每个要点一句话”
指令恰好针对被选中的段落。作者读取该小节,只修改这一段,其余内容逐字保留。

对于任何语言模型都不应代劳的事情,每个章节都有“编辑”按钮:您自己的文字、带图题的图片、表格(也可从电子表格粘贴)、带标题图片的封面抬头数据,以及图和表是连续编号还是按章节编号的选择。结构本身,即您自己的章节及其顺序,则在高级编辑器中处理。

最终得到什么

导出为 PDF 或 Word 的文件包含依据附录 I 第 1.7.4 条的十二个章节,附目录、图目录和表目录。所有表格都有编号,包括文档根据项目生成的表格:来自风险评估的剩余风险概览、所应用的协调标准以及风险评估的证据。“见表 3”之类的交叉引用在导出时自动解析;警示带有警示语、危险来源、后果和对策。

已展开的导出菜单,含“打印为 PDF”“导出为 Word 文件”和“高级编辑器(大纲)”
随时可导出为 PDF 或 Word,含目录、图目录和表目录。高级编辑器仍可用于调整结构和批量填充。

同一台机器的完整导出是什么样子,可以看含 123 页的 PDF 版使用说明书示例,无需登录。该示例 PDF 为英文;平台以德文或英文生成说明书。

真正的优势

许多工具可以写得更快。区别在于事后需要检查什么。面对随意撰写的 AI 文本,您要逐句核查出处。面对对话式使用说明书,您只需检查一份信息简表和一份判定结果清单。

每条陈述都有出处

作者只能使用信息简表中的内容或您告诉它的内容。信息简表会写明每条事实的来源,例如“风险评估,机械限制”或“您的输入”。您核对的是出处,而不是文字。

缺口变成提问,而不是文字

通用语言模型会用一个看似合理的数值补上缺失的连接功率。作者则会提出问题,之后您的回答会作为有依据的内容出现在信息简表和章节中。

文档始终与风险评估保持关联

剩余风险和所应用的标准直接来自项目,并以编号表格的形式呈现。风险评估一旦变更,审核员就会把受影响的章节报告为已过时,只需一条指令即可更新。

每一步都看得见,文档始终掌握在您手中

没有您的指令,任何内容都不会进入说明书。每次工具调用都可见,每一轮都可以停止,每个章节都可以手动编辑,也可以使用您自己的图和表格。

对话不做什么

一份看起来完整的文档,很容易让人产生“大功告成”的期待。因此,边界也是其中的一部分:

  • 专业审核和批准。每份文本都是基于您的项目数据生成的草稿,作为制造商,由您承担责任。
  • 项目中没有的设计数值。作者不会猜数字,而是设置带名称的占位符或提问。
  • 机器的图片。图片由您自己上传;图题和编号由文档处理。
  • 翻译成其他官方语言以及翻译标注。
  • 未逐字取自项目符合性声明的符合性陈述。

可用性与价格

对话式使用说明书是 Professional 和 Business 方案中的附加模块,每个项目一次性解锁,价格 12.99 €,无周期性费用。合理使用额度为:Professional 方案每月 100 轮对话,Business 方案每月 200 轮,全团队共用。一轮是一条指令及其所属的全部工具调用。手动编辑和导出不受限制。此前已解锁使用说明书的项目可免费使用对话功能。对话历史随项目一起保存;详情见隐私政策。

FAQ

关于对话式使用说明书的常见问题

AI 作者在缺少内容时会编造数值吗?
不会,这正是该模式的核心。涉及具体机器的陈述只允许来自两个来源:信息简表和您当前的消息。如果缺少某项信息,作者会提出带回答栏的问题,或设置带名称的占位符。此外,审核员会报告信息简表中没有依据的每一个数字和每一项标准。
我怎么知道文本中的某条陈述来自哪里?
在“信息简表”标签页中,每条事实都会显示其来源和日期,例如“风险评估,危险第 3 项”或“符合性声明”。来自对话的信息会标注为“您的输入”或“来自对话”。对话中的信息与数据库之间的矛盾会被标出,作者会提问而不是自行决定。
我可以自己写文字并插入图片吗?
可以。文档中的每个章节都有一个“编辑”按钮,可直接在面板中打开章节编辑器:文字、带图题的图片、表格(也可从 Excel 粘贴)和标签。图和表的编号自动分配,可连续编号,也可按章节编号。对于结构本身,仍可使用高级编辑器。
如果之后风险评估发生变化会怎样?
编审在每一轮都会从数据库刷新事实。基于旧状态撰写的章节会收到审核员的提示“自撰写以来项目数据已发生变化”。像“按当前风险评估更新第 2 章”这样的指令即可使文本保持最新;剩余风险表在导出时本来就取自当前状态。
一份说明书需要多少轮?
起草一个章节算一轮,改写一个小节算一轮,回答一个问题也算一轮。对于包含提问、表格和处理判定结果的十二个章节,通常几十轮就能完成。Professional 方案每月 100 轮(Business 方案每月 200 轮,全团队共用)的额度,是按每月一至两份说明书设计的。手动编辑和导出不计入轮数。
2027 年起在机械法规下也适用吗?
适用。规则集来自项目:现在是机械指令 2006/42/EC 附录 I 第 1.7.4 条,自 2027 年 1 月 20 日起是机械法规 (EU) 2023/1230 附录 III。作者了解这两种依据,章节结构也是按两者设计的。
对话式使用说明书要多少钱?
Professional 和 Business 方案中每个项目一次性 12.99 €,无周期性费用。此前已解锁使用说明书的项目可免费使用对话功能。对话历史随项目一起保存;详情见隐私政策。
对话功能能取代技术文档撰写人员吗?
不能。它接手的是初稿,并使初稿始终与项目数据保持关联。风格、针对具体产品的完整性、依据 EN IEC/IEEE 82079-1 对目标读者的适用性以及批准,仍然是制造商及其编辑团队的任务。

来源

关于自家产品的说明:对话式使用说明书是 CE-Copilot 的一部分,需要一个带风险评估的项目,因为信息简表正是据此建立的。完成后的导出是什么样子,可以看免费的使用说明书示例;想亲自走一遍,可以免费试用。

更多指南