创作AI友好型技术文档指南

1. 能够更快地完成任务
2. 能够在任何时间、任何设备上以任何格式访问文档
3. 希望获得问题的准确答案

这种范式的转变为技术传播者的角色增添了新的责任。提供准确答案的需求涉及到赋予技术写作者的数字信任。通过生成式AI工具在回答客户问题时建立信任，伴随着巨大的责任！！在您的知识库之上集成生成式AI工具可能为您的组织带来快速的胜利。然而，底层内容需要经过修订，以适应基于生成式AI的代理的特征。基于生成式AI的代理可以是聊天机器人、辅助搜索、问答机器人等等。

生成式人工智能驱动代理的特性

如果您的客户正在使用类似Baklib的辅助搜索功能，而您现有的内容没有针对生成式人工智能驱动代理的特性进行调整，那么现在就是进行内容审核的时候了。底层内容必须对生成式人工智能友好，以确保能为您的客户提供可信赖的响应。生成式人工智能代理渴求文本，因此底层内容必须尽可能具有解释性。更重要的是，底层内容必须以对话风格、采用更通用的口吻来撰写。为生成式人工智能代理撰写内容的指南正在不断发展。技术写作社区也提出了各种技巧来改进现有内容。让我们看看一些新兴的、用于制作对生成式人工智能友好内容的指南。

创建对生成式人工智能友好内容的8大指南

撰写容易被生成式人工智能代理理解的内容，需要融入清晰的语言、结构化的格式，并遵循一些特定的指南。这些指南列举如下：

指南 #1：撰写详尽的内容

与其追求内容的简洁性，不如尽可能将内容写得具有解释性。详尽的内容包含更多信息，有助于生成式人工智能代理全面理解您文章中涉及的主题。使用简单的英语词汇来撰写内容，而不是华丽的辞藻。这有助于内容被吸收，并帮助回答用户的问题。例如，这篇来自Dagle的入门文章阅读时间约为16分钟。

有兴趣了解Baklib AI驱动的知识库吗？与我们的专家预约演示

预约演示

指南 #2：为每篇文章创建常见问题解答

为每篇文章内容创建至少 5 到 10 个常见问题解答。这些问题可以来源于客户支持团队、客户成功团队、销售团队、产品团队等。这些常见问题解答有助于快速检索信息，使基于GenAI的智能体能够在短时间内对查询生成准确的响应。这里有一个关于编写常见问题解答的示例。

指南 #3：使用一致的业务术语

在整个知识库中使用一致的业务术语。业务词汇的统一定义有助于大型语言模型更好地理解上下文。例如，如果您将诸如客户、顾客、用户和利益相关者等术语作为同义词使用，但它们具有不同的业务定义，GenAI可能会感到困惑，因为这些术语之间的“句子相似度”非常接近。如果在客户的提问中使用了这些术语，基于GenAI的系统可能会产生不一致的响应。这里有一个业务术语表的示例，其中列出了在所有知识库文章中一致使用的术语。

指南 #4: 代词的使用

撰写内容时，不要使用第二人称复数和第三人称单数代词，因为基于 GenAI 的代理很难推断您使用“我们”、“他们”等其他代词所指代的内容。最佳实践是使用第二人称单数进行写作。

指南 #5: 包容性语言

使用包容性术语，使内容反映全球品牌形象。这从根本上消除了偏见。避免在您的知识库内容中使用俚语、习语和文化典故。可以在基于 GenAI 的代理的编排层，通过一些审核规则提供进一步的保护。

指南 #6: “它”代词的使用

代词“它”可以在一个段落内使用。但是，它不能用于指代后续段落中的任何内容。最好是再次重复“主语”！其背后的原理是，基于 GenAI 的代理使用检索增强生成框架，该框架通过对内容进行分块处理来生成合适的上下文。如果在分块内容中使用“它”，可能会失去上下文的相关性！

指南 #7: 文章标签 – 新增、已更新、已弃用

假设您的 知识库工具 具有为内容创建标签的功能。那么，技术写作者必须了解基于 GenAI 的代理将如何预处理这些标签，并为回答客户的问题提供上下文。

指南#8：结构化格式

文章内容应遵循 H1 到 H6 标签的层级结构。这种内容的语义结构有助于基于生成式人工智能的智能体检索文章相应子章节中的相关信息，以回答客户的问题。使用清晰的标题和副标题来组织信息。运用项目符号和编号列表来呈现分步说明。此外，在撰写每篇文章时拥有良好的结构也很有帮助。例如，文章的第一部分可以是关于目的，接着是范围，然后是主题相关内容。

现有知识库内容必须进行改造，以适应基于生成式人工智能的智能体的特性。拥有及时且准确的内容能建立对知识库的信任，从而使基于生成式人工智能的智能体能够提供可靠且一致的响应。在整个知识库中使用一致的业务术语将使基于生成式人工智能的智能体能够生成极其清晰的响应，并减少幻觉。让我们为基于生成式人工智能的智能体准备好您的内容，以便与我们的客户互动，提供更丰富的知识体验。