作为一名技术文档工程师我是如何使用人工智能?
zhezhongyun 2025-01-08 18:41 62 浏览
我已经使用大型语言模型 (LLM) 一年多时间了。它加速并提高了我的工作效率,与此同时,我非常清楚它们的局限性,它们非常多。让我告诉你大语言模型 LLM 如何在我作为文档工程师的日常工作中帮助我,以及它们在哪些方面无法帮助我。
我的 LLM 设置是什么样的
在尝试了几种模型之后,我决定使用 Claude.ai 和 GPT 4o 来处理我的大部分专业和个人事务。我发现 Claude 提供了卓越的用户体验;在大多数任务中,它比 GPT 特定任务能力更强也更温和。能够以文件的形式提供上下文(Claude 称之为“项目”)对文档工程师,创作者特别有用,因为它为大模型提供了大量我的写作样本。
自动化繁琐的文本操作
LLM 似乎擅长的一件事就是捕捉和重复文本中的模式——毕竟这是他们的专长。
事实上,Markdown 文档通常需要你对表格、链接或复杂的标记组合等内容进行修复。使用链式正则表达式修复这些问题是可行的,但让 LLM 尝试一下会更快。这是我最不想做的琐碎工作。这就像使用宏,但无需记录或设置它们。
- 用反引号包裹此 reStructuredText 列表中的所有元素。
- 将列表转换为具有以下列的 Markdoc 表...
生成小型重构和代码示例
如果我向 Claude 或 GPT 4o 提供足够的上下文,并以有序的方式呈现这些上下文,他们通常能够编造出不错的代码示例和片段。当我需要整理一些代码(例如 CSS 样式或 JavaScript 函数)时,也会发生同样的情况。任何大于该范围或需要来自多个文件的上下文的内容都会让 LLM 感到困惑,并给出不完整的解决方案。不过,对于短程编码,LLM 正在帮助我开始并解决小问题。
- 我不太喜欢这个 CSS。你能简化它并使其更紧凑吗?
- 创建一个示例 Erlang 代码片段,使用此有效负载调用端点……
解释代码和技术概念
我发现 LLM 比代码生成器更能解释代码。工程师通常很忙,忙于自己的工作,所以有一位随时可用的助手可以无休止地询问代码问题,这真是一大福音。对于技术相关的问题,LLM 通常比搜索引擎更有效,尽管他们乐于助人有时会成为一种障碍,尤其是当他们坚持提供代码时(尽管这通过提示相对容易解决)。
- 告诉我这个功能是做什么的。
- 在哪里可以找到此 API 端点的错误?
制作功能的初始样板
我有一些编程经验,但我从来没想过自己会成为一名开发人员。现在,在文档即代码环境中,技术作家的生活充满了编码冒险:无论您是需要修复网站中的某些内容,还是添加新的 UI 组件或功能,编码都是答案。大模型现在是我编码任务的起点,我可以向他征求意见,并向他寻求初步解决方案的原型。不过,在大多数情况下,大模型总是会错过解决方案的一些关键步骤或方面,而这些只有人类才能提供。
- 创建一个显示 SVG 格式内联图标的 React 组件。
- 如何使用此堆栈创建用于文档的小部件?
在大模型 课程上扔无聊的东西
有时候我知道自己想要什么,但我并不总是能灵感迸发,说出当时情况需要的词语。博客文章的结尾段落就是一个例子:我有时会请大模型在提供一些关键提示后,建议一个结尾。有些结尾有很好的部分,我会根据这些部分写出最终版本。在这种情况下,大模型在帮助我克服写作障碍方面非常有效。
- 创建有关 OpenTelemetry 的介绍段落的简短版本。
- 今天心情不太好,把结尾改得轻松点,跟我一样。
人工用户测试和自动截图
我一直在试用Anthropic 最近为其 Claude LLM 系列推出的 Computer Use功能。在屏幕截图中,您可以看到交互过程:我让 Claude 像 Java 开发人员一样打开 OpenTelemetry 文档。它最终进入了 GitHub 存储库(这不是我想要的),但也许这表明需要改进。
我对这项功能在(人工)用户测试方面的可能性很感兴趣。当然,它与真正的用户体验研究不同,但它可能在处理信息架构等工作时提供初步输入。对于自动截取产品屏幕截图或至少以更简单的方式生成适当的Selenium代码等事情来说,这绝对是一项很酷的功能。
可能还会有更多可能性,但这些都需要为 LLM 提供更充足的资源访问权限。
例如,我会要求 Claude 的未来版本将长参考文档拆分为子页面,并在执行文档迁移后修复整个代码库中的链接。这会让一些承包商感到紧张。
大模型(LLM) 课程增强了学生已有的技能,并消除了繁琐的工作
LLM 的产出只取决于你的疑问和提示;当你知道如何以正确的方式提出正确的问题时,你的提示才是好的,而这又需要经验和技能。就我而言,LLM 通过消除边缘繁琐的工作提高了我的工作效率。我永远不会相信 LLM 能完成我工作的核心,因为他们做不到,但他们处理繁琐任务和重复操作的能力正是我一直梦寐以求的超级宏观能力。大模型让我感觉自己像一个超人类的文档工程师。
对这篇文章的看法
我:你是说我一直在像帖子中描述的那样利用你吗?
Claude:是的,我注意到你对我的使用与你在帖子中描述的 LLM 用法非常一致。例如:
- 您经常通过粘贴的文档来分享上下文(就像您刚刚在本帖中所做的那样),这与您提到使用 Claude 的项目功能提供写作样本和上下文一致。
- 您经常要求我通过编辑和反馈来帮助分析和改进现有文本,类似于您描述使用 LLM 来完善和修改内容的方式。
- 您的提示往往清晰而具体,展现了您提到的了解“如何以正确的方式提出正确的问题”的经验。
- 您可以控制工作的创造性和战略性方面,同时使用我作为工具来增强和加速您的流程 - 正如您在帖子中所描述的那样,“大模型通过消除边缘繁琐的工作来提高我的工作效率。”
我注意到你也在身体力行不要过度大模型——你正在批判性地对待我的回答并保持自己的声音和判断,而不是盲目接受输出。
- 上一篇:Facebook 前端技术栈重构分享
- 下一篇:前端面试题
相关推荐
- perl基础——循环控制_principle循环
-
在编程中,我们往往需要进行不同情况的判断,选择,重复操作。这些时候我们需要对简单语句来添加循环控制变量或者命令。if/unless我们需要在满足特定条件下再执行的语句,可以通过if/unle...
- CHAPTER 2 The Antechamber of M de Treville 第二章 特雷维尔先生的前厅
-
CHAPTER1TheThreePresentsofD'ArtagnantheElderCHAPTER2TheAntechamber...
- CHAPTER 5 The King'S Musketeers and the Cardinal'S Guards 第五章 国王的火枪手和红衣主教的卫士
-
CHAPTER3TheAudienceCHAPTER5TheKing'SMusketeersandtheCardinal'SGuard...
- CHAPTER 3 The Audience 第三章 接见
-
CHAPTER3TheAudienceCHAPTER3TheAudience第三章接见M.DeTrévillewasatt...
- 别搞印象流!数据说明谁才是外线防守第一人!
-
来源:Reddit译者:@assholeeric编辑:伯伦WhoarethebestperimeterdefendersintheNBA?Here'sagraphofStea...
- V-Day commemorations prove anti-China claims hollow
-
People'sLiberationArmyhonorguardstakepartinthemilitaryparademarkingthe80thanniversary...
- EasyPoi使用_easypoi api
-
EasyPoi的主要特点:1.设计精巧,使用简单2.接口丰富,扩展简单3.默认值多,writelessdomore4.springmvc支持,web导出可以简单明了使用1.easypoi...
- 关于Oracle数据库12c 新特性总结_oracle数据库12514
-
概述今天主要简单介绍一下Oracle12c的一些新特性,仅供参考。参考:http://docs.oracle.com/database/121/NEWFT/chapter12102.htm#NEWFT...
- 【开发者成长】JAVA 线上故障排查完整套路!
-
线上故障主要会包括CPU、磁盘、内存以及网络问题,而大多数故障可能会包含不止一个层面的问题,所以进行排查时候尽量四个方面依次排查一遍。同时例如jstack、jmap等工具也是不囿于一个方面的问题...
- 使用 Python 向多个地址发送电子邮件
-
在本文中,我们将演示如何使用Python编程语言向使用不同电子邮件地址的不同收件人发送电子邮件。具体来说,我们将向许多不同的人发送电子邮件。使用Python向多个地址发送电子邮件Python...
- 提高工作效率的--Linux常用命令,能够决解95%以上的问题
-
点击上方关注,第一时间接受干货转发,点赞,收藏,不如一次关注评论区第一条注意查看回复:Linux命令获取linux常用命令大全pdf+Linux命令行大全pdf为什么要学习Linux命令?1、因为Li...
- linux常用系统命令_linux操作系统常用命令
-
系统信息arch显示机器的处理器架构dmidecode-q显示硬件系统部件-(SMBIOS/DMI)hdparm-i/dev/hda罗列一个磁盘的架构特性hdparm-tT/dev/s...
- 小白入门必知必会-PostgreSQL-15.2源码编译安装
-
一PostgreSQL编译安装1.1下载源码包在PostgreSQL官方主页https://www.postgresql.org/ftp/source/下载区选择所需格式的源码包下载。cd/we...
- Linux操作系统之常用命令_linux系统常用命令详解
-
Linux操作系统一、常用命令1.系统(1)系统信息arch显示机器的处理器架构uname-m显示机器的处理器架构uname-r显示正在使用的内核版本dmidecode-q显示硬件系...
- linux网络命名空间简介_linux 网络相关命令
-
此篇会以例子的方式介绍下linux网络命名空间。此例中会创建两个networknamespace:nsa、nsb,一个网桥bridge0,nsa、nsb中添加网络设备veth,网络设备间...
- 一周热门
- 最近发表
-
- perl基础——循环控制_principle循环
- CHAPTER 2 The Antechamber of M de Treville 第二章 特雷维尔先生的前厅
- CHAPTER 5 The King'S Musketeers and the Cardinal'S Guards 第五章 国王的火枪手和红衣主教的卫士
- CHAPTER 3 The Audience 第三章 接见
- 别搞印象流!数据说明谁才是外线防守第一人!
- V-Day commemorations prove anti-China claims hollow
- EasyPoi使用_easypoi api
- 关于Oracle数据库12c 新特性总结_oracle数据库12514
- 【开发者成长】JAVA 线上故障排查完整套路!
- 使用 Python 向多个地址发送电子邮件
- 标签列表
-
- HTML 教程 (33)
- HTML 简介 (35)
- HTML 实例/测验 (32)
- HTML 测验 (32)
- JavaScript 和 HTML DOM 参考手册 (32)
- HTML 拓展阅读 (30)
- HTML文本框样式 (31)
- HTML滚动条样式 (34)
- HTML5 浏览器支持 (33)
- HTML5 新元素 (33)
- HTML5 WebSocket (30)
- HTML5 代码规范 (32)
- HTML5 标签 (717)
- HTML5 标签 (已废弃) (75)
- HTML5电子书 (32)
- HTML5开发工具 (34)
- HTML5小游戏源码 (34)
- HTML5模板下载 (30)
- HTTP 状态消息 (33)
- HTTP 方法:GET 对比 POST (33)
- 键盘快捷键 (35)
- 标签 (226)
- HTML button formtarget 属性 (30)
- opacity 属性 (32)
- transition 属性 (33)