当TC遇到AI

简介:

随着人工智能(Artificial Intelligence,简称AI)的迅速发展,各行各业都在经历着深刻的变革。原本默默无闻的技术传播(Technical Communication,简称TC)行业也焕发出勃勃生机。

前言

TC行业是随着科技的发展而成长起来的。根据中国标准化协会的定义,“TC指与技术性产品、软件或服务有关且伴随其全部生命周期的所有信息”,“是伴随着工业化社会繁荣与进步,应对纷繁复杂的工业产品说明而诞生的专业化领域”。

可以说,TC行业的发展依托整个社会的技术发展。因此TC起源于美国也就不足为奇了,早在70年代,美国的大学就已经出现了技术写作(Technical Writing)专业。而我国的TC行业起步较晚,仅在外企或者海外市场份额较大的国内企业中才有比较稳定的需求。最近几年北京大学等一些知名大学才相继开设了技术传播课程。

即使在TC的发源地美国,TC诞生后的三四十年里,也只能用一个词形容:不温不火。而近几年,随着云计算、DT时代的到来,一场规模空前的技术革命正在兴起,人工智能已经到了爆发的临界点,趁着技术变革的东风,原本默默无闻的TC行业也焕发出勃勃生机,迸发出无限可能。

TC与AI的结合

长期以来,技术文档工程师的大量时间花在copy-paste以及整理格式等低级的重复性劳动上,普遍的附加值不高。随着AI的发展,技术文档工程师可以从这些繁琐的工作总解脱出来,专注于架构和内容的深度开发,为企业创造更高的价值。

AI应该可以帮技术文档工程师做这些事:

  • 自动内容摘要。从正文中提取关键内容组合成摘要。
  • 关键词提取。自动抽取关键词,提升搜索命中率。
  • 自动内容推送。根据当前内容自动关联其他相关内容,推送用户可能需要的信息。
  • 分析用户反馈,做数据挖掘,给出文档需求建议。技术文档工程师不再闭门造车,而是根据AI的建议,写出用户真正需要的内容。
  • 简单内容写作。一些简单内容,例如API和操作指南等格式比较固定的内容,可以由AI完成。目前市面上已有一些内容自动生成的工具,用户只要在界面上操作,即可自动生成操作指南。例如惠普公司的HPE Adoption Readiness Tool(ART)工具。

Chatbot数据训练

Chatbot就是我们常说的聊天机器人,或者智能客服。理想的chatbot是能和人类自然对话,并随时随地解答人类提出的问题。这需要强大的AI技术,但更重要的是优质海量的数据输入和训练。可以说好的数据等于好的AI。

Chatbot在阿里云已有了实际应用。点击阿里云官网任意网页右侧的咨询建议,都可以调出智能顾问,实时回答用户的各种问题。

用户可以选择产品并查看该产品的常见问题,也可以直接输入问题提问。

  • 选择产品并查看该产品的常见问题

后台根据服务体量,列出了最热门的产品。

用户可以点击需要咨询的产品,智能顾问将推荐关于此产品的常见问题。

这里的常见问题可以在智能平台进行配置。类似工单拦截页面的热门知识点推送。配置步骤请参见下文中的配置常见问题

  • 直接输入问题提问

用户也可以直接在对话框中输入问题,系统将实时做出回应。这种一问一答的方式即问答对。可以在智能平台进行配置。配置步骤请参见下文中的添加问答对

要提升智能顾问的命中率和准确性,需要不断对其进行训练,尽可能地丰富语料库,把各种用户场景和问题与答案关联起来。客服人员最了解用户场景,而技术文档工程师最了解内容,二者携手对语料库进行训练是最合适不过了。

配置常见问题

您可以配置智能顾问针对某一产品默认推荐的常见问题,提升用户的提问效率以及智能顾问解决问题的效率。配置步骤如下:

  1. 登录智能平台,选择 基础语料管理 > 菜单管理
  2. 搜索某一产品,如OSS。
  3. 单击OSS常见问题对应的操作列里的编辑图标。系统列出已有的常见问题菜单结构。
  4. 单击某一类问题,查看已有的菜单节点,然后单击添加菜单项。
  1. 输入菜单节点名称,从类型下拉列表中选择帮助与文档,然后输入对应的知识点链接。单击确定

添加问答对

我们的文档,尤其是基础设施类文档,经过近两年的发展,已经比较完善,但经常无法有效解决用户的实际问题,一个重要原因就是文档描述的角度和用户实际场景不同。文档一般是偏向功能说明,尽量讲明白我们的产品是什么,怎么用;而用户则是带着问题去寻找答案,我有什么需求,产品如何帮我实现。技术文档工程师一方面可以不断改进文档内容,使之更加贴合用户场景,另一方面也可以尝试架设一座桥梁,把文档内容和用户问题关联起来。问答对就是针对后者的尝试。

例如,分析工单发现,有不少用户询问:我有大量的医疗影像资料需要存储,很少访问,应该用什么产品比较合适?其实我们的文档中已经有明确的各类存储产品适用的场景,只需要把用户问题和对应的存储类型说明形成问答对的形式即可。

针对以上场景,我们可以在智能平台中通过以下步骤快速添加问答对:

  1. 登录智能平台,选择 基础语料管理 > 问答对管理 > OSS
  1. 语料关键词搜索框中,输入文档“存储类型介绍”中对应的二级标题“归档存储类型(Archive)”进行搜索。
    系统默认将所有线上文档拆分到二级标题,便于问题定位。
  1. 在搜索结果中,单击操作列中的添加图标+,添加问句。
    问句的设计要尽量贴合用户场景。添加问句的注意事项请参见这里

针对同一篇文档甚至同一个二级标题,可以添加多个问句。也可以根据热度和解决率及时调整已有的问句。比如某个问句的热度很高,解决率却很低。说明用户需要这方面的内容,但是当前文档无法有效解决问题,需要文档人员及时补充和优化内容。对一些长期热度和解决率很低的问句,可以考虑删除。

问答发现

要丰富语料库,不能闭门造车想当然,要分析海量的用户数据,抽取出共性问题。靠人工分析工单是非常低效的做法,尤其是对服务体量庞大的基础设施类产品,需要通过机器分析数据和发掘数据背后的需求。智能平台的问答发现基于客服小二实际使用文档的热度统计,帮助我们分析包含文档推荐的客服对话,并自动推荐需要更新的问答对。

例如,在问答发现中有一条“设置域名解析”的知识点,热度比较高:

可以这么做:

  1. 登录智能平台,选择 基础语料管理 > 问答发现
  2. 单击查看,逐条查看具体的客服与用户之间的对话,以及推荐文档出现的场景和位置。

例如:

  1. 单击更新知识点,系统列出对话中提到的文档二级标题。
  1. 选择需要添加问句的二级标题,单击下一步。系统列出对话中涉及到的所有问句。
  1. 编辑问句。您可以:
  • 保留有价值的问句。
  • 删除无意义的问句。
  • 添加更多问句。

添加近义词

有些产品中,同样一个意思会有多个术语表达,我们可以通过词库管理设置近义词,提升问答对添加的效率。例如,在OSS中,对象、文件、object是一个意思,如果需要添加“如何批量上传文件”的问句对,在设置同义词之前,为了防止遗漏,我们需要设置3条问句对:

  • 如何批量上传文件
  • 如何批量上传对象
  • 如何批量上传object

设置了近义词之后,我们只要设置其中任何一条就可以了。

添加近义词的操作如下:

  1. 登录智能平台,选择 基础语料管理 > 词库管理
  2. 单击阿里云核心词典对应的详情
  3. 单击右上方的添加图标+
  4. 输入词汇,单击确定
  1. 单击近义词一列中的添加图标+,输入对应的近义词。如果有多个近义词,需要逐个添加。

总结

中国互联网行业在全球已处于领先地位,在人工智能、物联网等国际前沿技术上的发展也毫不逊色于欧美等先进国家。技术上的突破,势必带动技术传播领域的飞跃。技术文档工程师在专注于内容创作的同时,也需要深入思考用户获取内容的途径和效率,从而使内容的价值最大化。

目录
相关文章
|
3月前
|
消息中间件 人工智能 安全
云原生进化论:加速构建 AI 应用
本文将和大家分享过去一年在支持企业构建 AI 应用过程的一些实践和思考。
733 47
|
4月前
|
人工智能 安全 中间件
阿里云 AI 中间件重磅发布,打通 AI 应用落地“最后一公里”
9 月 26 日,2025 云栖大会 AI 中间件:AI 时代的中间件技术演进与创新实践论坛上,阿里云智能集团资深技术专家林清山发表主题演讲《未来已来:下一代 AI 中间件重磅发布,解锁 AI 应用架构新范式》,重磅发布阿里云 AI 中间件,提供面向分布式多 Agent 架构的基座,包括:AgentScope-Java(兼容 Spring AI Alibaba 生态),AI MQ(基于Apache RocketMQ 的 AI 能力升级),AI 网关 Higress,AI 注册与配置中心 Nacos,以及覆盖模型与算力的 AI 可观测体系。
1037 54
|
3月前
|
人工智能 运维 Kubernetes
Serverless 应用引擎 SAE:为传统应用托底,为 AI 创新加速
在容器技术持续演进与 AI 全面爆发的当下,企业既要稳健托管传统业务,又要高效落地 AI 创新,如何在复杂的基础设施与频繁的版本变化中保持敏捷、稳定与低成本,成了所有技术团队的共同挑战。阿里云 Serverless 应用引擎(SAE)正是为应对这一时代挑战而生的破局者,SAE 以“免运维、强稳定、极致降本”为核心,通过一站式的应用级托管能力,同时支撑传统应用与 AI 应用,让企业把更多精力投入到业务创新。
503 30
|
3月前
|
设计模式 人工智能 自然语言处理
3个月圈粉百万,这个AI应用在海外火了
不知道大家还记不记得,我之前推荐过一个叫 Agnes 的 AI 应用,也是当时在 WAIC 了解到的。
496 1
|
3月前
|
消息中间件 人工智能 安全
构建企业级 AI 应用:为什么我们需要 AI 中间件?
阿里云发布AI中间件,涵盖AgentScope-Java、AI MQ、Higress、Nacos及可观测体系,全面开源核心技术,助力企业构建分布式多Agent架构,推动AI原生应用规模化落地。
366 0
构建企业级 AI 应用:为什么我们需要 AI 中间件?
|
3月前
|
存储 人工智能 NoSQL
AI大模型应用实践 八:如何通过RAG数据库实现大模型的私有化定制与优化
RAG技术通过融合外部知识库与大模型,实现知识动态更新与私有化定制,解决大模型知识固化、幻觉及数据安全难题。本文详解RAG原理、数据库选型(向量库、图库、知识图谱、混合架构)及应用场景,助力企业高效构建安全、可解释的智能系统。
|
3月前
|
人工智能 算法 Java
Java与AI驱动区块链:构建智能合约与去中心化AI应用
区块链技术和人工智能的融合正在开创去中心化智能应用的新纪元。本文深入探讨如何使用Java构建AI驱动的区块链应用,涵盖智能合约开发、去中心化AI模型训练与推理、数据隐私保护以及通证经济激励等核心主题。我们将完整展示从区块链基础集成、智能合约编写、AI模型上链到去中心化应用(DApp)开发的全流程,为构建下一代可信、透明的智能去中心化系统提供完整技术方案。
318 3
|
4月前
|
存储 人工智能 Serverless
函数计算进化之路:AI 应用运行时的状态剖析
AI应用正从“请求-响应”迈向“对话式智能体”,推动Serverless架构向“会话原生”演进。阿里云函数计算引领云上 AI 应用 Serverless 运行时技术创新,实现性能、隔离与成本平衡,开启Serverless AI新范式。
529 12
|
3月前
|
人工智能 安全 Serverless
再看 AI 网关:助力 AI 应用创新的关键基础设施
AI 网关作为云产品推出已有半年的时间,这半年的时间里,AI 网关从内核到外在都进行了大量的进化,本文将从 AI 网关的诞生、AI 网关的产品能力、AI 网关的开放生态,以及新推出的 Serverless 版,对其进行一个全面的介绍,期望对正在进行 AI 应用落地的朋友,在 AI 基础设施选型方面提供一些参考。
710 67
|
3月前
|
人工智能 缓存 运维
【智造】AI应用实战:6个agent搞定复杂指令和工具膨胀
本文介绍联调造数场景下的AI应用演进:从单Agent模式到多Agent协同的架构升级。针对复杂指令执行不准、响应慢等问题,通过意图识别、工具引擎、推理执行等多Agent分工协作,结合工程化手段提升准确性与效率,并分享了关键设计思路与实践心得。
614 20
【智造】AI应用实战:6个agent搞定复杂指令和工具膨胀