生成式AI聊天机器人内容创作最佳实践
生成式技术改变技术文档编写规则,需同时满足人类与AI需求。创作新兴最佳实践包括详细解释、对话口吻、术语表一致性,迁移旧内容也需遵循这些原则以适应新一代内容消费。
举例来说,如果您在解释产品功能时,
简单的内容:"此功能有助于节省分析反馈的时间。可通过导航到设置菜单并启用'使用辅助智能'切换按钮来配置此功能。"
传统的内容:"此功能可通过在设置菜单下启用'使用辅助智能'来配置。"
另一个旧做法的例子是:"联系我们 销售:+1 548 78945,支持:+1 789 124580"
新做法是:"请使用电话号码 +1 548 78945 联系我们的销售部门,使用电话号码 +1 789 124580 联系支持部门。"
语义化的内容结构
使用 H1 – H6 标题构建内容,有助于理解内容的重要性和层级关系。当人类读者搜索答案时,这种语义结构有助于获取正确且准确的内容来回答问题。
图片和视频
对于人类读者而言,在内容中包含图片、屏幕截图、动画 GIF 和视频对于轻松理解内容非常重要。然而,为了让基于 ChatGPT 的智能体能够理解,这些元素需要标注更多的元数据。
了解 Baklib 如何帮助您减少支持工单!
通过使用 Baklib 构建您的知识库,您可以创建一个结构清晰、易于查找的单一信息源,从而有效提升自助服务率,减少重复性的支持请求。
创建常见问题解答(FAQ)
为每篇知识库文章创建至少4-5个常见问题类型的问题。这些FAQ可以是故障排除问题、已知的产品缺陷、产品功能的限制等。一旦这些内容被摄取,类ChatGPT代理就能快速响应客户查询。
用户角色
在您的内容中确立用户角色也很重要,这样类ChatGPT代理才能模仿这些角色。例如,您的产品功能中有管理员、所有者、用户等几个角色。在这种情况下,在每篇知识库文章中提及这些角色有助于以更自然的方式进行叙述。
事实上,您可以强制类ChatGPT代理扮演管理员,然后以该角色的身份回答问题。
包容性
内容需要具有包容性,以在人类读者中传播和谐。内容应能让所有人类读者无障碍获取,并且对人类友好。
通过业务术语表实现一致性
在您的知识库中使用一致的术语对于避免歧义非常重要。这为建立和使用一致的业务术语表奠定了基础。需要在入职过程中对技术文档工程师进行公司业务术语表的培训。一致的业务术语表也能避免答案中的混淆。
例如,以这段内容为例:“软件的用户必须配置此功能。员工必须确保产品已配置,以提供更好的安全性。”这里的“用户”和“员工”这两个术语会让人类读者感到困惑。
迁移旧内容
世界正从“使用关键词搜索信息”转向“需要对其问题获得准确的答案”。因此,将旧内容迁移到这种新范式,对于确保您的知识库面向未来至关重要。建立一个变更管理计划,根据新兴的最佳实践来修订旧内容,以产出适用于基于生成式AI的代理的内容,这一点至关重要。在审查旧内容时,应注意:
- 平衡内容,使其更适合人类读者和基于生成式AI的代理;像文章摘要生成器这样的工具有助于人类读者更快地理解详细内容。
- 采用一致的业务术语。
- 减少对图像和视频的过度使用。
- 对图像和视频进行标注。
- 添加更多FAQ风格的内容。
结论
ChatGPT已经改变了人类读者发现新信息的方式。使用关键词搜索并浏览不同URL来寻找所需信息的时代已经一去不复返了。如今,人类读者要求对其问题获得准确的答案。知识库必须拥有清晰的内容,以便像ChatGPT这样的代理能够摄取内容,并准备好回答人类读者的问题。遵循新兴的最佳实践来生成对生成式AI友好的内容,将帮助技术写作者适应新一代的内容消费者!
直观的知识库软件,可轻松添加您的内容并与任何应用程序集成。试试Baklib吧!