作为一名技术文档工程师我是如何使用人工智能?
zhezhongyun 2025-01-08 18:41 38 浏览
我已经使用大型语言模型 (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 前端技术栈重构分享
- 下一篇:前端面试题
相关推荐
- 字体缩放(方式一)(字体缩放150%怎么做)
-
通过元素宽度和字数计算得到缩放简单实现如下:/***字体最大为视觉要求大小(maxFontSize);超出缩小字体显示,最小为minFontSize;最小字体时超出部分使用圆点(...);*p...
- 网页世界隐藏的神秘代码语言,竟能这样改变布局
-
CSS基础:选择器与属性CSS(CascadingStyleSheets)是用于控制网页外观的一门样式表语言。它通过定义HTML元素的显示方式来增强网页的表现力。CSS的选择器允许开发者精确地定位...
- CSS属性值计算过程详解(css属性用来定义元素计算)
-
在CSS中,即使某些属性没有显式声明,浏览器也会通过**属性值计算过程**为每个元素的所有属性赋予最终值。这一过程分为四个关键步骤,以下将逐一解析。1.确定声明值浏览器首先检查所有**直接应用**到...
- 软网推荐:找回调整Windows 10字号功能
-
之前的系统,从WindowsXP到早期版本的Windows10,均有字体大小调整功能,但从创意者版Windows10以来,取消了之前的设置选项,取而代之的是自定义缩放比例设置。使用这个功能调整过...
- Excel中如何设置文本框属性,实例代码讲解
-
Excel不仅可以对数据进行处理,而且也可以图形化数据,直观显示数据表达的内容。本节介绍一个很重要的对象,Characters,字符对象,使用Characters对象可修改包含在全文本字符串中的任...
- CSS 字体样式(css中字体)
-
本节我们来讲字体样式,之前我们学习HTML的时候学过一些用于字体加粗、倾斜的标签,但是使用标签来实现的效果肯定没有我们通过CSS中的样式来的方便。接下来我们会给大家介绍下面这几个属性的使用:通...
- PC网站建设必备代码知识:HTML基础与应用技巧
-
在PC网站建设的相关课程里,代码扮演着至关重要的角色。只有熟练运用正确的代码,我们才能打造出功能完善、用户体验出色的PC网站。接下来,我会详细讲解在PC网站建设环节中必须了解的代码知识。HTML基础代...
- 让你大跌眼镜的疯狂 HTML 和 CSS 技巧
-
今天,分享一个让你大开眼界的技巧。通过使用这个技巧,你可以将整个网页变成一个CSS编辑器。没错,你从未见过这种方法。当我第一次尝试时,我完全被震惊到了。现在,让我们开始吧!步骤1首先,创建一个基础的...
- jQuery EasyUI使用教程:创建一个链接按钮
-
jQueryEasyUI最新版下载>本教程主要为大家展示如何使用jQueryEasyUI创建一个链接按钮。通常情况下,使用“button/”元素来创建一个按钮;使用“a/”元素来创建链接按钮...
- React 19 有哪些新特性?(react100)
-
如果你对React18还不熟悉,欢迎阅读之前的文章《React18全览[1]》最近React发布了V19RC版本,按照惯例,我们对React19的新特性进行一次深度的体验学习...
- Java注解探秘:为什么@PostConstruct能解决你的初始化难题?
-
你是否在Spring项目中遇到过这样的困扰:明明依赖注入已经完成,但某些配置就是无法正常加载?手动调用初始化方法又容易引发空指针异常?这就是@PostConstruct注解大显身手的时候了!@Post...
- AI驱动的表单自动填写(ai置入表格)
-
我们都同意,填写表格是一项枯燥且耗时的任务。如果我们可以创建一个可以为我们填写表格的AI助手,让我们将时间投入到更有建设性的任务中,那会怎样?AI助手将能够通过调用以表单字段为参数的函数来填写表...
- 从零到一:小程序设计新手如何快速上手?
-
开发环境搭建对于小程序设计新手而言,搭建合适的开发环境是首要任务。以小程序为例,其官方提供了功能强大的开发工具——开发者工具。首先,新手需前往官方开发者平台,在页面中找到“工具下载”板块,根据...
- JavaSwingGUI从小白到大神-6(续)(java从小白到大牛怎么样)
-
接上一篇《JavaSwingGUI从小白到大神-6》,因本篇文章3万多字,头条一篇发不完,只能分开发。同事查询面板:CompanyFind.javapublicclassCompanyFind{...
- C# winform界面假死(c#程序假死)
-
针对C#WinForm界面假死问题,以下是分步解决方案:1.使用异步编程(async/await)将耗时操作移至后台线程,保持UI线程响应。步骤:将事件处理函数标记为async。使用Task....
- 一周热门
- 最近发表
- 标签列表
-
- HTML 教程 (33)
- HTML 简介 (35)
- HTML 实例/测验 (32)
- HTML 测验 (32)
- HTML 参考手册 (28)
- JavaScript 和 HTML DOM 参考手册 (32)
- HTML 拓展阅读 (30)
- HTML中如何键入空格 (27)
- HTML常用标签 (29)
- 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)