创建插件

前提条件

• 已实名认证的华为账号或IAM用户。
• 已模拟银行系统提供的查询卡片列表API、查询卡余额API和转账汇款API。本实践使用Python脚本模拟API接口，Python脚本请参见附录。

准备工作

本实践选用平台预置的“DeepSeek-V3-64K”模型。

操作流程

创建查询卡片列表插件

1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择进入所需空间，如图1所示。

   如果已选择团队空间，界面显示为实际的团队空间名称，而非“个人空间”。

   图1 选择团队空间
   

2. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建”。
   图2 创建插件
   

3. 配置插件基本信息，并单击“下一步”。
   图3 基本信息
   

   表1 基本信息

   参数	示例	说明
   插件图标	使用默认图标	单击默认图标按钮，可上传本地图片作为插件的自定义图标。
   插件名称	查询卡片列表	用于标识当前插件的名称，便于在智能体、工作流和资产中心中快速搜索和定位。例如：查询天气。 命名要求：可以包含中文、英文、数字、特殊字符等。 长度限制：1~64个字符。
   插件英文名称	QueryMyCards	插件的英文名称，用于在大模型调用时快速搜索和定位该插件。 命名要求：字母、数字和下划线（_）的组合，不允许使用其他特殊字符或空格。 长度限制：1~64个字符。
   插件描述	查询卡片列表	描述当前插件的类型、功能和适用场景，帮助用户快速了解插件的作用和用途。
   仅我可见	保持默认配置	该功能默认关闭。开启后，仅插件的创建者可见。此设置在插件创建后无法修改。

4. 填写插件配置信息，单击“确定”。
   图4 配置信息
   

   表2 配置信息

   参数	示例	说明
   协议	http	API服务接口通信协议。 https http
   主机地址	IP:3000	提供API服务的服务器地址。
   基准URL	/	基准URL（Base URL）是指域名的根路径，默认为/。
   权限校验	无需鉴权	选择调用API时是否需要鉴权。 无需鉴权：API可以公开访问，不需要任何形式的身份验证或授权。 API Key：在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息 需填写密钥位置，并设置API Key的密钥鉴权参数名和密钥值。 密钥位置：密钥是从Header中读取还是从Query中读取。 参数名称：API Key的鉴权参数名称。 参数值：API Key的具体值

5. 配置完单击“确定”。插件创建成功后，单击新创建的插件进入详情页面。
6. 在“我的插件”页面，单击需要添加工具的插件进入详情页面。
7. 在“工具信息”页签中，单击左侧的“新建”。
8. 在“添加工具”弹框中配置工具名称、工具英文名称、工具描述，参数如表3所示。

   表3 基本信息参数说明

   参数	示例	说明
   工具名称	查询卡片列表	用于标识当前工具的名称，便于在智能体、工作流和资产中心中快速搜索和定位。
   工具英文名称	QueryMyCards	工具的英文名称。 命名要求：可以包含大小写字母、数字、下划线； 长度限制：1~64个字符。
   工具描述	查询卡片列表	描述当前工具的功能和适用场景，帮助用户快速了解工具的作用。

9. 单击“下一步”，工具URL配置请参见表4，响应参数配置请参见表5，其他参数使用默认配置。

   表4 工具URL参数配置说明

   参数	示例	说明
   请求方式	GET	服务的请求方式，支持POST或GET。
   工具path	/my_cards	所调用API接口的访问地址或相关资源链接。如果已配置基准URL，则工具path应填写基准URL之后的部分；如果未配置基准URL，则工具path应为从主机地址之后的完整路径。

   表5 响应参数配置说明

   参数名称	描述	参数类型	必填
   card_list	卡片列表	Array<String>	勾选
   card_size	卡片数量	Number	勾选

10. 单击“工具调测”按钮，单击“开始调测”检查调测结果。
11. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。
12. 工具调试完成后，单击“确定”。
13. 在插件详情页面，单击右上角的“发布”按钮。

创建查询卡余额插件

1. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建”。
   图5 创建插件
   

2. 配置插件基本信息，并单击“下一步”。
   图6 基本信息
   

   表6 基本信息

   参数	示例	说明
   插件图标	使用默认图标	单击默认图标按钮，可上传本地图片作为插件的自定义图标。
   插件名称	查询卡余额	用于标识当前插件的名称，便于在智能体、工作流和资产中心中快速搜索和定位。例如：查询天气。 命名要求：可以包含中文、英文、数字、特殊字符等。 长度限制：1~64个字符。
   插件英文名称	QueryCardBalance	插件的英文名称，用于在大模型调用时快速搜索和定位该插件。 命名要求：字母、数字和下划线（_）的组合，不允许使用其他特殊字符或空格。 长度限制：1~64个字符。
   插件描述	查询卡余额	描述当前插件的类型、功能和适用场景，帮助用户快速了解插件的作用和用途。
   仅我可见	保持默认配置	该功能默认关闭。开启后，仅插件的创建者可见。此设置在插件创建后无法修改。

3. 填写插件配置信息，单击“确定”。
   图7 配置信息
   

   表7 配置信息

   参数	示例	说明
   协议	http	API服务接口通信协议。 https http
   主机地址	IP:3000	提供API服务的服务器地址。
   基准URL	/	基准URL（Base URL）是指域名的根路径，默认为/。 如果插件中存在多个工具，基准URL可以填写这些工具共用的URL部分。
   权限校验	无需鉴权	选择调用API时是否需要鉴权。 无需鉴权：API可以公开访问，不需要任何形式的身份验证或授权。 API Key：在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息 需填写密钥位置，并设置API Key的密钥鉴权参数名和密钥值。 密钥位置：密钥是从Header中读取还是从Query中读取。 参数名称：API Key的鉴权参数名称。 参数值：API Key的具体值

4. 配置完单击“确定”。插件创建成功后，单击新创建的插件进入详情页面。
5. 在“我的插件”页面，单击需要添加工具的插件进入详情页面。
6. 在“工具信息”页签中，单击左侧的“新建”。
7. 在“添加工具”弹框中配置工具名称、工具英文名称、工具描述，参数如表8所示。

   表8 基本信息参数说明

   参数	示例	说明
   工具名称	查询卡余额	用于标识当前工具的名称，便于在智能体、工作流和资产中心中快速搜索和定位。
   工具英文名称	QueryCardBalance	工具的英文名称。 命名要求：可以包含大小写字母、数字、下划线； 长度限制：1~64个字符。
   工具描述	查询卡余额	描述当前工具的功能和适用场景，帮助用户快速了解工具的作用。

8. 单击“下一步”，工具URL配置请参见表9，请求参数配置请参见表10，响应参数配置请参见表11，其他参数使用默认配置。

   表9 工具URL参数配置说明

   参数	示例	说明
   请求方式	GET	服务的请求方式，支持POST或GET。
   工具path	/card_balance	所调用API接口的访问地址或相关资源链接。如果已配置基准URL，则工具path应填写基准URL之后的部分；如果未配置基准URL，则工具path应为从主机地址之后的完整路径。

   表10 请求参数-查询参数（Query）配置说明

   参数名称	中文名称	参数类型	默认值	描述	必填
   card_no	卡片号码	string	-	卡片号码	勾选

   表11 响应参数配置说明

   参数名称	描述	参数类型	必填
   balance	卡内余额	number	勾选

9. 单击“工具调测”按钮，单击“开始调测”检查调测结果。
10. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。
11. 工具调试完成后，单击“确定”。
12. 在插件详情页面，单击右上角的“发布”按钮。

创建转账汇款插件

1. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建”。
   图8 创建插件
   

2. 配置插件基本信息，并单击“下一步”。
   图9 基本信息
   

   表12 基本信息

   参数	示例	说明
   插件图标	使用默认图标	单击默认图标按钮，可上传本地图片作为插件的自定义图标。
   插件名称	转账汇款	用于标识当前插件的名称，便于在智能体、工作流和资产中心中快速搜索和定位。例如：查询天气。 命名要求：可以包含中文、英文、数字、特殊字符等。 长度限制：1~64个字符。
   插件英文名称	Transfer	插件的英文名称，用于在大模型调用时快速搜索和定位该插件。 命名要求：字母、数字和下划线（_）的组合，不允许使用其他特殊字符或空格。 长度限制：1~64个字符。
   插件描述	转账汇款	描述当前插件的类型、功能和适用场景，帮助用户快速了解插件的作用和用途。
   仅我可见	保持默认配置	该功能默认关闭。开启后，仅插件的创建者可见。此设置在插件创建后无法修改。

3. 填写插件配置信息，单击“确定”。
   图10 配置信息
   

   表13 配置信息

   参数	示例	说明
   协议	http	API服务接口通信协议。 https http
   主机地址	IP:3000	提供API服务的服务器地址。
   基准URL	/	基准URL（Base URL）是指域名的根路径，默认为/。 如果插件中存在多个工具，基准URL可以填写这些工具共用的URL部分。
   权限校验	无需鉴权	选择调用API时是否需要鉴权。 无需鉴权：API可以公开访问，不需要任何形式的身份验证或授权。 API Key：在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息 需填写密钥位置，并设置API Key的密钥鉴权参数名和密钥值。 密钥位置：密钥是从Header中读取还是从Query中读取。 参数名称：API Key的鉴权参数名称。 参数值：API Key的具体值

4. 配置完单击“确定”。插件创建成功后，单击新创建的插件进入详情页面。
5. 在“我的插件”页面，单击需要添加工具的插件进入详情页面。
6. 在“工具信息”页签中，单击左侧的“新建”。
7. 在“添加工具”弹框中配置工具名称、工具英文名称、工具描述，参数如表14所示。

   表14 基本信息参数说明

   参数	示例	说明
   工具名称	转账汇款	用于标识当前工具的名称，便于在智能体、工作流和资产中心中快速搜索和定位。
   工具英文名称	Transfer	工具的英文名称。 命名要求：可以包含大小写字母、数字、下划线； 长度限制：1~64个字符。
   工具描述	转账汇款	描述当前工具的功能和适用场景，帮助用户快速了解工具的作用。

8. 单击“下一步”，工具URL配置请参见表15，请求参数配置请参见表16，响应参数配置请参见表17，其他参数使用默认配置。

   表15 工具URL参数配置说明

   参数	示例	说明
   请求方式	POST	服务的请求方式，支持POST或GET。
   工具path	/transfer	所调用API接口的访问地址或相关资源链接。如果已配置基准URL，则工具path应填写基准URL之后的部分；如果未配置基准URL，则工具path应为从主机地址之后的完整路径。

   表16 请求参数-请求体（Body）配置说明

   参数名称	中文名称	参数类型	默认值	描述	必填
   card_no	收款的卡号	string	-	收款的卡号	勾选
   amount	转账金额	number	-	转账金额	勾选

   表17 响应参数配置说明

   参数名称	描述	参数类型	必填
   balance	卡内余额	number	勾选

9. 单击“工具调测”按钮，单击“开始调测”检查调测结果。
10. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。
11. 工具调试完成后，单击“确定”。
12. 在插件详情页面，单击右上角的“发布”按钮。