最佳实践

[TOC] ##一、准备工作 ###1.下载智谱AutoClaw 软件下载地址: https://autoclaw.zhipuai.cn/ 根据操作系统确定下载的版本,点击下载图标进行下载: ![](https://oss.showapi.com/doc/3989/21/2713f4e3a78e_1783779508615.png?x-oss-process=image/resize,p_100) 本教程以Windows 11作为软件的演示环境,软件当前的版本号为1.11.4,如果您安装的版本、操作系统等,与我们演示的差异较大,请参考官方网站。 下载后,双击安装包,按照提示安装该软件,然后提前注册、登录该软件,相关步骤此处省略。 ###2.注册ShowAPI平台账号(已注册请忽略该步骤) 注册地址:https://www.showapi.com/auth/reg ![](https://oss.showapi.com/doc/3989/4/a138e25cee90_1782735365134.png?x-oss-process=image/resize,p_100) ###3.登录ShowAPI平台以获取AppKey(已有AppKey可忽略该步骤) 登录地址:https://www.showapi.com/auth/login 登录成功后,具体操作步骤依次为:点击右上角"控制台" -> 左侧菜单的"接口使用者" -> "appKey管理" 如下图所示: ![](https://oss.showapi.com/doc/3989/4/8a92594fa3d7_1782736191682.png?x-oss-process=image/resize,p_100) 根据个人需要,可以创建独立的应用和appKey,也可以设置访问IP或接口权限。 点击“查看”按钮,并输入注册时的密码,即可查看和复制appKey,后续调用Skills时会用到该appKey。 ##二、下载技能包 ###1.进入工作流市场 进入“万维易源”平台首页:https://www.showapi.com/ 如未登录,请先登录。然后,点击导航栏的“AI工作流”: ![](https://oss.showapi.com/doc/3989/12/908fa6f20f6e_1782877262566.jpg?x-oss-process=image/resize,p_100) 或者直接进入如下地址:https://www.showapi.com/ai/promptflow 点击页面下方的“搜索工作流市场” ![](https://oss.showapi.com/doc/3989/12/c23ebcb7bb1b_1782736372041.jpg?x-oss-process=image/resize,p_100) ###2.下载skill(技能) 首先,查阅工作流 ![](https://oss.showapi.com/doc/3989/15/918ee2282b48_1783476322733.jpg?x-oss-process=image/resize,p_100) 工作流市场中的内容会不断变化,您看到的内容和此处展示的可能不一致。 我们以“文创设计”工作流技能包的安装为例进行演示(其他技能包的使用步骤完全一致)。在搜索框住输入“文创设计”,回车,就可以找到对应的工作流: ![](https://oss.showapi.com/doc/3989/15/057cb0e3659f_1783476423731.png?x-oss-process=image/resize,p_100) 点击工作流卡片,然后依次点击: ① "开发集成(Skills)" -> ② "Agent Skill" -> ③ "下载技能包" ![](https://oss.showapi.com/doc/3989/15/326e425ce391_1783477758463.jpg?x-oss-process=image/resize,p_100) 需要留意您下载技能包的存放位置,在稍后的步骤中需要选择该技能包。 ##二、安装技能包 ###1.打开软件 ![](https://oss.showapi.com/doc/3989/21/8df39b3a7010_1783780248873.png?x-oss-process=image/resize,p_100) ###2.导入技能包 首先,解压之前下载的技能包,这里使用的是浏览器默认的下载位置,解压后的路径如下图所示: ![](https://oss.showapi.com/doc/3989/21/9a6b90c837d4_1783780866794.png?x-oss-process=image/resize,p_100) 接着,依次选择“Skill商店”、“创建”、“添加技能文件”,然后选择解压好的技能包文件夹 ![](https://oss.showapi.com/doc/3989/21/fae4926cebbd_1783780538527.jpg?x-oss-process=image/resize,p_100) 安装成功的界面: ![](https://oss.showapi.com/doc/3989/21/239f1cab858c_1783780726064.jpg?x-oss-process=image/resize,p_100) 在我的创建栏目下,多了一个“文创设计”的技能 ![](https://oss.showapi.com/doc/3989/21/b5aad5378657_1783780809223.png?x-oss-process=image/resize,p_100) ##三、使用技能 ###1.查阅技能(skill)参数 以文创设计工作流为例,地址: https://www.showapi.com/ai/promptflow/detail/6a4c58393c51f2d32d00c4fc?tab=test&sub=skill 在线测试界面如下: ![](https://oss.showapi.com/doc/3989/15/8685afc34067_1783490916113.png?x-oss-process=image/resize,p_100) 它包含了四个信息,分别是生成的产品图排版(1~4宫格图)、参考图(url或图片的base64字符串)、产品描述(提示词)、生成的产品图长宽比(默认1:1),其中第一个参数信息是必填项,其他参数可选。为确保生成的图片满足您的需求,建议您在软件中输入的提示词,要包含这四个参数,且尽可能详细的描述各个参数对应的信息。 ###2.调用skill的提示词 首先,点击左侧菜单中的“新对话”,在输入框下方选择“Skills”,然后在③出输入“/文创”,然后选择如图所示的技能包: ![](https://oss.showapi.com/doc/3989/21/c185f87c3db9_1783781010672.png?x-oss-process=image/resize,p_100) 输入您的需求,也就是提示词,建议提示词中尽量包含测试界面中的所有参数。参考示例如下: `生成一个文化创意的产品宣传图,图片主要描述江浙一带的绸缎文化,图片为四宫格的图片,长宽比为16:9横版的, 产品参考图: https://oss.showapi.com/doc/4826/5/ae919726ce38_1780382555943.jpg ` * 这段提示词里,包含了四个参数的信息,分别是: 1> grid_num = 4、 2> image = https://oss.showapi.com/...82555943.jpg 3> prompt = 生成一个文化创意的产品宣传图,图片主要描述江浙一带的绸缎文化 4> aspect_ratio = 16:9 * ![](https://oss.showapi.com/doc/3989/21/69204bfa8897_1783781097878.png?x-oss-process=image/resize,p_100) 如上图,填写好提示词,回车或点击右下角的发送按钮,开始调用skill。 ###3.调用过程及结果 注意:首次在调用skill,需要设置AppKey,后续调用该skill时就无需再配置了。登录万维易源官网后在此地址下可获取AppKey:https://www.showapi.com/console#/myApp; 在技能调用过程中,会不定时的在提示词输入框的位置处,或整个窗口界面,弹出窗口进行交互或确认,您根据实际情况进行操作。如网络请求权限的确认、文件操作的确认、调用所需密钥的调整、某些环境变量的更改等情况,会需要您的确认。交互的过程根据不同的skill,提示和操作的内容会完全不同,在此不做过多说明和展示,依据提示进行操作即可。 AppKey设置的交互操作: ![](https://oss.showapi.com/doc/3989/21/88e2ee9c3670_1783781275985.png?x-oss-process=image/resize,p_100) 整个交互过程(过程稍长,分成多张截图展示): ![](https://oss.showapi.com/doc/3989/21/ae9285ba71df_1783781584764.png?x-oss-process=image/resize,p_100) ![](https://oss.showapi.com/doc/3989/21/bb02f9917935_1783781653641.png?x-oss-process=image/resize,p_100) 渲染的HTML(图片渲染失败,但skill调用实际上是成功的): ![](https://oss.showapi.com/doc/3989/21/64879f7c1848_1783781902441.jpg?x-oss-process=image/resize,p_100) *渲染失败,可能是默认的模型能力不够,请选择更新、更好的模型,如GLM5.2,操作如下图 * ![](https://oss.showapi.com/doc/3989/21/f981c7505b1b_1783782286744.png?x-oss-process=image/resize,p_100) 最终生成的结果图: ![](https://oss.showapi.com/doc/3989/21/4b519d38b88e_1783781849693.jpg?x-oss-process=image/resize,p_100)