引言
大家好，我是石小石！
前几天收到阿里云开发者社区的定邀，期望我对《主动式智能导购AI助手构建》解决方案进行评测，刚好，我对快速搭建一个网站的智能导购AI助手非常感兴趣！
对于商城或者购物类网站而言，它非常具有商业价值，于是秉承着强烈的兴趣和对技术的热爱，我以一个新手小白的角色体验了智能导购AI助手构建的过程。
接下来，我将结合自己的实践经历，分享一下自己的实际体验感受，并提出一些自己的想法与建议。
什么是智能导购 AI 助手
在正文开始之前， 我觉得应该先介绍一下什么是“智能导购 AI 助手”。刚开始看教程的摘要和方案概述，我其实对整个产品有点迷糊。
我知道这篇文章是介绍如何构建一个AI智能助手，但它的实际使用场景和用途我觉得文章描述的不够清楚，尤其是对一个新手小白。
那么教程中的AI智能导购助手的用途是什么呢？
假设我们拥有一个自己的商城网站，上面售卖各种商品。根据教程，我们可以快速在我们的网站引入一个智能导购助手，它能够像淘宝客服一样，对用户提出的商品问题进行回答，甚至主动对用户提问，从而实现对用户需求的24小时响应，实现降本增效，利益最大化。
官方提供的解决方案是什么？
官方提供的解决方案非常清晰明了：通过百炼构建一个 Multi-Agent 架构的大模型应用，从而实现一个智能导购助手。
为了降低我们的理解难度，点击【立即部署】，我们可以看到官方提供的demo教程，按照教程【快速体验】的内容，我们就能极速实现一个智能导购助手的构建。
单看解决方案，还是非常清晰直观的，我们可以通过【立即部署】快速体验搭建过程，也可以通过【联系咨询】了解更详细的定制化解决方案。
部署体验
由于是第一次接触阿里云的相关产品，我对整体业务、阿里云的其他产品也没有什么了解，官方提供的实践教程文档成了我实践的最佳工具。
官方提供的教程文档涉及的内容还是比较全面的，基本上重要的概念与信息都可以在文中找到对应的解释。根据官方文档的指引，在配置好一些关键内容后，我仅在几分钟就实现了AI助手的部署：
不得不说，这款产品做的非常不错，无论是部署速度还是使用效果都是非常令人满意的。
但作为一个新手，整个实践过程并非一帆风顺，由于官方文档的不完善，部分步骤详略不当，导致自己频繁卡壳。结合官方的其他文档和翻看评论区，才最终完成AI助手的配置部署与理解。
总的来说，产品的部署速度和使用效果非常不错，但教程文档存在一定的缺陷，亟待完善。
部署体验过程中遇到的问题
在各种实践之前，我一般会大概瞅一下整个教程的目录架构，以防错过一些重要提示信息等内容。从教程的目录架构来看，它的排布还是非常不错的：读者可以通过“方案概述”快速了解整个教程的目的，然后通过“快速体验”快速实现产品的构建，最后通过“代码解释”等内容加深了对产品的深入理解与应用。
但教程可能面向的是一些对阿里云相关产品有接触的老用户，对于一个纯新手小白，我觉得10分钟了解这一套东西还是太有难度了。从我的角度出发，我觉得教程有以下需要改进的地方：
- 文档排版、外链需要优化
- 文档信息缺失，新用户无法按照教程完成实践
- 教程衔接不够合理，阅读存在割裂感
- 专有名词缺乏引导，新手理解难度大
- 教程详略不当，部分内容不够全面
文档排版、链接需要优化
作为一个读者，我认为好的文章布局、关键词的着重提示能更容易让人找到关键信息，但显然教程里这一点做的不是非常好。当然，这其实也和阿里云网站的UI设计有关，如果能优化我觉得最好不过。
文章阅读中，很多大面积的白板内容，很容易让人觉得是不是什么重要内容没加载出来；一些错别字也希望开发人员能及时改正。
在教程中，我任务比较严重的就是一些外链打开报错的问题，比如
点击教程中的【我的API-KEY】跳转后的链接提示未找到页面(通过其他路径可以打开
点击教程中【优化提示词】跳转不到对应文档
点击教程中【百炼-模型广场】跳转后，提示函数方法错误
此外，相关的评测文章中，有一篇似乎与内容毫无关联，审核同学是不是得扣鸡腿？
文档信息缺失，新用户无法按照教程完成实践
上文中，我提到了API Key获取链接的缺失，但通过其他文档API Key的获取还是比较容易的。如果说API Key获取链接是阻碍实践的绊脚石，那下面的问题就是实践过程的梦想粉碎机。
在我第一次按照教程完成导购AI助手搭建时，无论我输入什么内容，AI助手总返回空白信息。
我仔细核对了教程的步骤，再确认我没有任何遗漏后，我开始怀疑是我的VPN影响了数据的返回。于是，关闭VPN我又折腾了好久，但最终不断的失败还是让我不得不放弃实践。
后来，经过不断地翻阅其他文档，我才终于明白：新用户必须开通【阿里云百炼】服务
开通阿里云百炼非常简单，进入阿里云百炼 管理平台，点击【开通服务】即可。
纵观整个教程文档，我并没有发现类似的提示声明，这是文档亟待优化的一个地方！
教程衔接不够合理，阅读存在割裂感
在【快速体验】章节中，读者更期望的是能够快速顺利的完成AI助手的实践。但在阅读过程中，教程中提到的“百炼应用”让我很疑惑，作为一个可选项，我并没有理解它的作用是什么，我只能先选择忽视。
直到后来，我完成了整个项目的实践，参阅其他读者的文章时，我才明白，原来百炼应用可以让我们的智能导购助手更加智能，能够根据我们的提供的商品数据信息对用户问题进行准确回答。
那么，我觉得百炼应用的引入是是不是应该在产品完成搭建后引出更加合理？
按照教程搭建出智能助手后，我本想参考文档继续深入学习，但是突然出现的“关键代码解释”章节让我不知所措。
整个实践过程我根本没有见哪里出现了代码，难道官方认为用户都是很熟悉阿里云的管理平台的开发人员吗？
得亏我是一个开发，用过腾讯云的管理平台，一番摸索，我还是有惊无险的找到了“关键代码解释”章节所展示的代码：
不得不说，藏的真深啊！但凡官方文档里给个代码地址的链接，我也不用费这个大功夫。
专有名词缺乏引导，新手理解难度大
作为第一次使用阿里云产品的用户，我觉得教程很不友好，文章中一开始提到的一些“百炼应用”、“函数计算应用”专有名词理解起来还是很困难的。教程中没有相应的铺垫解释，也没有提供可参考的链接，这很大程度提高了文档的阅读门槛，降低了读者的使用兴趣。
再者，教程一开始的方案概览我也觉得写的不够清晰明了。我并不是说“概述”写的不够专业，而真是因为太专业反而显得适得其反。
教程的目的应该是引导读者快速理解或完成某项实践，它应该用最通俗易懂的语言来引导读者，而不是用高度抽象的概念来增加阅读难度。
就比如方案概述一开始的内容就非常接地气，容易理解
但画风一转，立马放了一个内容较多的原理架构图及一些需要思考才能理解的概念。读者一开始可能并不会对这些概念感兴趣，他们更希望能快速完成实践，因此，我个人觉得这里可以放一些更简单的架构介绍，等读者体验完，可以再放全面的架构图。
教程详略不当，部分内容不够全面
- 快速体验部分
快速体验部分的【创建函数计算应用】作为整个教程的核心，这里缺乏对“创建函数计算应用”的相关介绍，新手用户很难理解它是一个什么东西，将会发生什么作用。其次，百炼应用也不应该在【创建函数计算应用】部分出现，作为一个可选内容，它更适合在完善AI助手的步骤中出现。比如，下面的架构可能更有利于用户理解产品：
1、通过创建函数计算应用实现AI助手部署
2、访问网站验证智能导购效果
3、如何使用自定义数据优化AI助手（引出百炼应用的概念）
4、百炼应用的引入与使用（可选）
- 百炼商品检索应用部分
教程中也提到了通过创建百炼商品检索应用并集成到智能导购中的方案，但文中的方案除了文字就是文字
对于一个新手小白来说，首先就是缺乏对百炼的介绍， 上来就是介绍它的用法会让人一脸懵逼。其次，整个操作步骤缺乏必要的图片提示，学习成本比较大。
如果通过下面的动图形式，就能极大程度的降低用户的学习成本！
- 总结部分
教程的总结部分实际并没有对AI助手的搭建尽心核心的技术要点或者必要的步骤进行总结，提供了生产环境应用和持续改进的介绍。
对于部署生产环境而言，文档只是简单的进行的介绍，但具体如何修改知识库并没有足够的引导，源码的修改也没有给出可以快速查看源码的链接。
其次，在持续改进中，文档也只是草草带过，没有给出更详尽的方案或者关联文章链接。甚至，关联的链接也存在访问异常的情况。 
