百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

作为一名技术文档工程师我是如何使用人工智能?

zhezhongyun 2025-01-08 18:41 72 浏览

我已经使用大型语言模型 (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 用法非常一致。例如:

  1. 您经常通过粘贴的文档来分享上下文(就像您刚刚在本帖中所做的那样),这与您提到使用 Claude 的项目功能提供写作样本和上下文一致。
  2. 您经常要求我通过编辑和反馈来帮助分析和改进现有文本,类似于您描述使用 LLM 来完善和修改内容的方式。
  3. 您的提示往往清晰而具体,展现了您提到的了解“如何以正确的方式提出正确的问题”的经验。
  4. 您可以控制工作的创造性和战略性方面,同时使用我作为工具来增强和加速您的流程 - 正如您在帖子中所描述的那样,“大模型通过消除边缘繁琐的工作来提高我的工作效率。”

我注意到你也在身体力行不要过度大模型——你正在批判性地对待我的回答并保持自己的声音和判断,而不是盲目接受输出。

相关推荐

Python入门学习记录之一:变量_python怎么用变量

写这个,主要是对自己学习python知识的一个总结,也是加深自己的印象。变量(英文:variable),也叫标识符。在python中,变量的命名规则有以下三点:>变量名只能包含字母、数字和下划线...

python变量命名规则——来自小白的总结

python是一个动态编译类编程语言,所以程序在运行前不需要如C语言的先行编译动作,因此也只有在程序运行过程中才能发现程序的问题。基于此,python的变量就有一定的命名规范。python作为当前热门...

Python入门学习教程:第 2 章 变量与数据类型

2.1什么是变量?在编程中,变量就像一个存放数据的容器,它可以存储各种信息,并且这些信息可以被读取和修改。想象一下,变量就如同我们生活中的盒子,你可以把东西放进去,也可以随时拿出来看看,甚至可以换成...

绘制学术论文中的“三线表”具体指导

在科研过程中,大家用到最多的可能就是“三线表”。“三线表”,一般主要由三条横线构成,当然在变量名栏里也可以拆分单元格,出现更多的线。更重要的是,“三线表”也是一种数据记录规范,以“三线表”形式记录的数...

Python基础语法知识--变量和数据类型

学习Python中的变量和数据类型至关重要,因为它们构成了Python编程的基石。以下是帮助您了解Python中的变量和数据类型的分步指南:1.变量:变量在Python中用于存储数据值。它们充...

一文搞懂 Python 中的所有标点符号

反引号`无任何作用。传说Python3中它被移除是因为和单引号字符'太相似。波浪号~(按位取反符号)~被称为取反或补码运算符。它放在我们想要取反的对象前面。如果放在一个整数n...

Python变量类型和运算符_python中变量的含义

别再被小名词坑哭了:Python新手常犯的那些隐蔽错误,我用同事的真实bug拆给你看我记得有一次和同事张姐一起追查一个看似随机崩溃的脚本,最后发现罪魁祸首竟然是她把变量命名成了list。说实话...

从零开始:深入剖析 Spring Boot3 中配置文件的加载顺序

在当今的互联网软件开发领域,SpringBoot无疑是最为热门和广泛应用的框架之一。它以其强大的功能、便捷的开发体验,极大地提升了开发效率,成为众多开发者构建Web应用程序的首选。而在Spr...

Python中下划线 ‘_’ 的用法,你知道几种

Python中下划线()是一个有特殊含义和用途的符号,它可以用来表示以下几种情况:1在解释器中,下划线(_)表示上一个表达式的值,可以用来进行快速计算或测试。例如:>>>2+...

解锁Shell编程:变量_shell $变量

引言:开启Shell编程大门Shell作为用户与Linux内核之间的桥梁,为我们提供了强大的命令行交互方式。它不仅能执行简单的文件操作、进程管理,还能通过编写脚本实现复杂的自动化任务。无论是...

一文学会Python的变量命名规则!_python的变量命名有哪些要求

目录1.变量的命名原则3.内置函数尽量不要做变量4.删除变量和垃圾回收机制5.结语1.变量的命名原则①由英文字母、_(下划线)、或中文开头②变量名称只能由英文字母、数字、下画线或中文字所组成。③英文字...

更可靠的Rust-语法篇-区分语句/表达式,略览if/loop/while/for

src/main.rs://函数定义fnadd(a:i32,b:i32)->i32{a+b//末尾表达式}fnmain(){leta:i3...

C++第五课:变量的命名规则_c++中变量的命名规则

变量的命名不是想怎么起就怎么起的,而是有一套固定的规则的。具体规则:1.名字要合法:变量名必须是由字母、数字或下划线组成。例如:a,a1,a_1。2.开头不能是数字。例如:可以a1,但不能起1a。3....

Rust编程-核心篇-不安全编程_rust安全性

Unsafe的必要性Rust的所有权系统和类型系统为我们提供了强大的安全保障,但在某些情况下,我们需要突破这些限制来:与C代码交互实现底层系统编程优化性能关键代码实现某些编译器无法验证的安全操作Rus...

探秘 Python 内存管理:背后的神奇机制

在编程的世界里,内存管理就如同幕后的精密操控者,确保程序的高效运行。Python作为一种广泛使用的编程语言,其内存管理机制既巧妙又复杂,为开发者们提供了便利的同时,也展现了强大的底层控制能力。一、P...