让你的文档从静态展示到一键部署可操作验证

为了解决文档中的这些用户体验问题，通过函数计算的能力让阿里云的文档从静态展示升级为动态可操作验证，用户在文档中单击一键部署可快速完成代码的部署及测试。这一改变已在函数计算的活动沙龙中得到用户的认可，你也快来体验一下吧~~

阿里云的产品作为技术驱动型解决方案，用户对文档中提供的代码示例有较高的依赖。通过分析，发现用户在使用文档时有以下问题。

文档中提供的代码错误，用户无法直接使用

使用如下的代码示例，在测试时一直报错，导致用户无法直接使用。文档中的代码示例由于长时间未更新和缺乏维护，已经变得过时，这直接影响用户使用文档时的体验。

文档中只提供代码片段，用户调试门槛高

文档中只提供代码片段，缺乏完整的项目结构和环境配置指南，用户需要自己搭建项目和设置运行环境，才能使用文档中介绍的功能，这无疑增加了用户实际操作的难度，甚至会吓退很多新手用户。

文档中没有提供代码，用户无法参考文档使用该功能

例如：函数计算的配置OSS文件系统文档中，只提供给用户如何配置OSS挂载，却没有提供如何访问OSS挂载文件相应的代码示例，这直接导致用户想使用该功能时参考该文档无法获取想要的信息。

如果文档中的代码能够部署在函数计算平台，那么用户可以在文档中直接操作验证代码提供的功能，会直接提升用户使用文档代码的体验。

实现方案

整个解决方案的流程示意图如下所示。

1. 通过Serverless Devs工具开发并发布完整代码对应的应用模板。
2. 在文档中配置一键部署，将代码片段与应用模板关联，并发布文档。

3. 用户在文档中单击一键部署后，根据应用名称在函数计算部署应用，并可以直接测试代码功能。

文档效果

以使用函数计算部署通义千问大模型实现AI对话文档为例，介绍文档动态可操作的效果。

用户可以在文档中使用一键部署的入口

• 文档最上方。



• 支持一键部署的代码片段前面，重点提醒用户可点击。支持一键部署的代码codeblock右上角。



单击一键部署后

单击一键部署后，会根据配置的应用模板将代码需要开通的服务、角色、配置的参数在面板中呈现，用户需开通及配置。

部署并查看应用

1. 应用部署成功后，可以查看应用的基本情况。
2. 单击操作列的测试，即可进入函数计算提供的测试页面。
3. 在测试页面，已默认将测试参数填入，单击测试函数，即可根据参数进行函数调用。

4. 最终会返回函数调用返回结果。

用户反馈

在2023年12月的函数计算活动沙龙中，有70多名用户体验了该文档的一键部署能力。在2024年1月的活动沙龙中，有2000多名用户参与任务的体验，其中有500用户完成。用户反馈从文档直接部署降低了体验该功能的门槛。

文档中增加一键部署后有以下优势：

• 用户文档使用体验提升

• 快速验证代码的正确性

• 快速获取完整代码

好的文档应当超越文字的界限，成为知识传递和技能培养的桥梁。阿里云函数计算让我们朝着这一目标迈出了重要一步。我们将文档从传统的静态页面升级为一个动态的、互动性强的工具，用户可以通过一键部署直接在函数计算平台验证文档内容。这种转变较大地提升了文档的可操作性和实际应用价值，让用户不只是阅读和理解概念，还能通过实际操作使用该能力。

我们诚邀所有用户来体验函数计算文档从静态到动态的转变，希望通过你们的参与和反馈，不断优化文档，助力每位用户在学习和使用文档的过程中实现最大化的收益。

如果您希望体验文档的一键部署能力，可以访问下面文档链接。

• 使用函数计算部署通义千问大模型实现AI对话：https://help.aliyun.com/document_detail/2623419.html
• 使用函数计算实现自动解压上传到OSS的ZIP文件：https://help.aliyun.com/document_detail/2624066.html
• 请求处理程序（Handler）：https://help.aliyun.com/document_detail/2512964.html
• 日志：https://help.aliyun.com/document_detail/2512968.html
• 错误处理：https://help.aliyun.com/document_detail/2512969.html

• 快速创建函数：https://help.aliyun.com/document_detail/2509023.html