创建插件

前提条件

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

准备工作

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

操作流程

创建查询卡片列表插件

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

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

   图1 选择团队空间
   

2. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建插件”。
3. 在“创建插件”页面中的“插件类型”中选择“API类型”，然后根据以下步骤配置插件信息。
   1. 在“基本信息”步骤中设置插件的基础信息，请参照表1完成信息配置，并单击“下一步”进入配置信息页面。

      表1 基本信息

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

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

      表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的具体值

4. 配置完单击“确定”。插件创建成功后，进入“工具信息”页签。
5. 在“工具信息”页签中，单击左侧的“创建工具”，在“添加工具”页面填写工具信息。
   1. 基础信息配置。

      表3 基本信息参数说明

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

   2. 工具URL配置。

      表4 工具URL参数配置说明

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

   3. 请求参数配置。

      保持默认配置即可。

   4. 响应参数配置。
      单击参数列表右侧的“添加参数”按钮，可以添加请求参数。单击右侧的，可以删除添加的请求参数。响应参数配置请参见表5，其他参数使用默认配置。

      表5 响应参数配置说明

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

6. 单击“工具调测”按钮，单击“开始调测”检查调测结果。
7. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。
8. 工具调试完成后，单击“确定”，进入工具列表页面。
9. 在工具列表页面，单击右上角的“发布”按钮。

创建查询卡余额插件

1. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建插件”。
2. 在“创建插件”页面中的“插件类型”中选择“API类型”，然后根据以下步骤配置插件信息。
   1. 在“基本信息”步骤中设置插件的基础信息，请参照表6完成信息配置，并单击“下一步”进入配置信息页面。

      表6 基本信息

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

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

      表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的具体值

3. 配置完单击“确定”。插件创建成功后，进入“工具信息”页签。
4. 在“工具信息”页签中，单击左侧的“创建工具”，在“添加工具”页面填写工具信息。
   1. 基础信息配置。

      表8 基本信息参数说明

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

   2. 工具URL配置。

      表9 工具URL参数配置说明

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

   3. 请求参数配置。
      单击参数列表右侧的“添加参数”按钮，可以添加请求参数。单击右侧的，可以删除添加的请求参数。请求参数配置请参见表10，其他参数使用默认配置。

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

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

   4. 响应参数配置。
      单击参数列表右侧的“添加参数”按钮，可以添加响应参数。单击右侧的，可以删除添加的响应参数。响应参数配置请参见表11，其他参数使用默认配置。

      表11 响应参数配置说明

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

5. 单击“工具调测”按钮，单击“开始调测”检查调测结果。
6. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。
7. 工具调试完成后，单击“确定”，进入工具列表页面。
8. 在工具列表页面，单击右上角的“发布”按钮。

创建转账汇款插件

1. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建插件”。
2. 在“创建插件”页面中的“插件类型”中选择“API类型”，然后根据以下步骤配置插件信息。
   1. 在“基本信息”步骤中设置插件的基础信息，请参照表6完成信息配置，并单击“下一步”进入配置信息页面。

      表12 基本信息

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

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

      表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的具体值

3. 配置完单击“确定”。插件创建成功后，进入“工具信息”页签。
4. 在“工具信息”页签中，单击左侧的“创建工具”，在“添加工具”页面填写工具信息。
   1. 基础信息配置。

      表14 基本信息参数说明

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

   2. 工具URL配置。

      表15 工具URL参数配置说明

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

   3. 请求参数配置。

      单击参数列表右侧的“添加参数”按钮，可以添加请求参数。单击右侧的，可以删除添加的请求参数。请求参数配置请参见表16，其他参数使用默认配置。

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

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

   4. 响应参数配置

      单击参数列表右侧的“添加参数”按钮，可以添加响应参数。单击右侧的，可以删除添加的响应参数。响应参数配置请参见表17，其他参数使用默认配置。

      表17 响应参数配置说明

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

5. 单击“工具调测”按钮，单击“开始调测”检查调测结果。
6. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。
7. 工具调试完成后，单击“确定”，进入工具列表页面。
8. 在工具列表页面，单击右上角的“发布”按钮。