第3章 案例2 生成型预训练变换模型辅助下的技术写作.docxVIP

生成型预训练变换模型辅助下的技术写作

1.案例目标

借助生成型预训练变换模型，撰写技术内容，嵌入配套文档，实现跨文档内容管理。

2.技术工具和数据资源

生成型预训练变换模型：Promptitude(mptitude.io/)

数据包：某公司公开文档包AudioandAcousticsTestSoftware

3.任务设计

3.1基础任务：撰写软件新功能用户指南

源文档：软件开发工程师提供的新功能介绍（附件）

参考文档：CheckingSystemConnectionswiththeAudioandAcousticsDebugToolVI(/docs/en-US/bundle/audio-acoustics-test-sw/page/check-system-connect-debug-tool.html)

任务目标：基于源文档生成信息准确、结构简明、与参考文档风格一致的新功能用户指南。

操作步骤：

登录Promptitude平台。

点击NewPrompt，选择PromptWizard，简要描述任务后点击Createprompt。

例：Writeauserguideforanewfeatureofasoftwareproduct

在Prompt框中，输入或修改角色设定###ProfessionalRole###。

例：Youreaprofessionaltechnicalwriterspecializingincreatinguserguidefornewfeaturesofsoftwareproducts.

在Prompt框中，输入背景信息###Context###，并设置变量{{feature_name}}{{feature_description}}{{website}}。

例：Thenewfeatureiscalled{{feature_name}}andit{{feature_description}}.Pleaserefertothecontentavailableonthe{{website}}togathernecessaryinformationaboutthesoftwareproductandwritingstyle.

点击页面右侧Input，点击+Add新增变量。提取源文档中信息，填入变量默认值DefaultValue。

{{feature_name}}：AudioandAcousticsTestConfigurator

{{feature_description}}：填入部分信息或上传整个源文档

{{website}}：参考文档地址/docs/en-US/bundle/audio-acoustics-test-sw/page/check-system-connect-debug-tool.html

点击Output，选择ResultType为FormattedText。

在Prompt框中，输入或修改指示词###Instructions###。

例：-Familiarizewiththewritingstyleofthecontentonthe{{website}}.

-Understandthefunctionalityofthenewfeaturethoroughly.

-Describethefeatureinsimple,user-friendlylanguage.

-Structuretheguideintoclearsections,suchasconfiguringparameters,runningtests,andcheckingtestresults.

-Ensuretask-orientedcontentwithstep-by-stepinstructionsforusingthefeature.

在Prompt框中，输入或修改任务描述###Task###。

例：Writeuserguideforanewfeature:

下图为已完成设置Prompt样例：

点击页面右上角Saveprompt。

从Edit页面转至Use页面，点击Generate。

根据源文档和参考文档，校验并修正生成内容的准确性和可读性。

3.2进阶任务：更新配套内容

配套文档：

AudioandAcousticsTestSoftwareUserManual:NewFeaturesandC