最佳实践
[TOC]
##一、准备工作
###1.下载TRAE Work软件
软件下载地址：
https://www.trae.cn/ide/download
根据操作系统确定下载的版本，点击下载图标进行下载：
本教程以Windows 11作为软件的演示环境，软件当前的版本号为0.1.32，如果您安装的版本、操作系统等，与我们演示的差异较大，请参考官方的帮助手册：https://docs.trae.cn/work_what-is-trae-solo
下载后，双击安装包，按照提示安装该软件，然后提前注册、登录该软件，相关步骤此处省略。
###2.注册ShowAPI平台账号（已注册请忽略该步骤）
注册地址：https://www.showapi.com/auth/reg
###3.登录ShowAPI平台以获取AppKey（已有AppKey可忽略该步骤）
登录地址：https://www.showapi.com/auth/login
登录成功后，具体操作步骤依次为：点击右上角"控制台" -> 左侧菜单的"接口使用者" -> "appKey管理"
如下图所示：
根据个人需要，可以创建独立的应用和appKey，也可以设置访问IP或接口权限。
点击“查看”按钮，并输入注册时的密码，即可查看和复制appKey,后续调用Skills时会用到该appKey。
##二、下载技能包
###1.进入工作流市场
进入“万维易源”平台首页：https://www.showapi.com/
如未登录，请先登录。然后，点击导航栏的“AI工作流”：
或者直接进入如下地址：https://www.showapi.com/ai/promptflow
点击页面下方的“搜索工作流市场”
###2.下载skill（技能）
首先，查阅工作流
工作流市场中的内容会不断变化，您看到的内容和此处展示的可能不一致。
我们以“文创设计”工作流技能包的安装为例进行演示（其他技能包的使用步骤完全一致）。在搜索框住输入“文创设计”，回车，就可以找到对应的工作流：
点击工作流卡片,然后依次点击：
① "开发集成(Skills)" -> ② "Agent Skill" -> ③ "下载技能包"
需要留意您下载技能包的存放位置，在稍后的步骤中需要选择该技能包。
##二、安装技能包
###1.打开软件
###2.导入技能包
如图，依次选择“技能”、“上传技能”，然后以文件方式上传技能包
上传中：
安装成功的界面:
##三、使用技能
###1.查阅技能（skill）参数
以文创设计工作流为例，地址： https://www.showapi.com/ai/promptflow/detail/6a4c58393c51f2d32d00c4fc?tab=test&sub=skill
在线测试界面如下：
它包含了四个信息，分别是生成的产品图排版（1~4宫格图）、参考图（url或图片的base64字符串）、产品描述（提示词）、生成的产品图长宽比（默认1:1），其中第一个参数信息是必填项，其他参数可选。为确保生成的图片满足您的需求，建议您在软件中输入的提示词，要包含这四个参数，且尽可能详细的描述各个参数对应的信息。
###2.调用skill的提示词
首先，点击左侧菜单中的“新建任务”，在输入框中输入“/文创设计”,然后选择如图所示的技能包：
输入您的需求，也就是提示词，建议提示词中尽量包含测试界面中的所有参数。参考示例如下：
`生成一个文化创意的产品宣传图,图片主要描述江浙一带的绸缎文化,图片为四宫格的图片,长宽比为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
*
如上图，填写好提示词，回车或点击右下角的发送按钮，开始调用skill。
###3.调用过程及结果
注意：首次在调用skill，需要设置AppKey，后续调用该skill时就无需再配置了。登录后在此地址下可获取AppKey：https://www.showapi.com/console#/myApp；
在技能调用过程中，会不定时的在提示词输入框的位置处，或整个窗口界面，弹出窗口进行交互或确认，您根据实际情况进行操作。如网络请求权限的确认、文件操作的确认、调用所需密钥的调整、某些环境变量的更改等情况，会需要您的确认。交互的过程根据不同的skill，提示和操作的内容会完全不同，在此不做过多说明和展示，依据提示进行操作即可。
AppKey设置的交互操作：
整个交互过程：
渲染的HTML：
最终生成的结果图:
