文档首页/ 智能体平台 Versatile/ 最佳实践/ 多智能体应用实践/ 搭建手机银行多智能体应用/ 操作步骤/ 子场景1：搭建转账汇款工作流/ 创建插件
更新时间：2026-01-21 GMT+08:00
查看PDF
分享

创建插件

在智能体平台中，插件能够为智能体提供丰富的专业技能和复杂任务处理能力，帮助其在多样化的实际场景中更高效地完成任务。我们模拟银行系统提供了查询卡片列表、查询卡余额和转账汇款三个API接口，我们需将其封装为插件，以便后续搭建转账汇款工作流调用。

前提条件

  • 登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。
  • 已购买Versatile智能体平台。
  • 已模拟银行系统提供的查询卡片列表API、查询卡余额API和转账汇款API。本实践使用Python脚本模拟API接口，Python脚本请参见附录。

准备工作

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

操作流程

操作步骤

说明

创建查询卡片列表插件

通过配置方式将查询卡片列表API快速创建为插件，以便后续转账汇款工作流能够调用，从而从用户银行卡列表中提取用户选择的银行卡。

创建查询卡余额插件

通过配置方式将查询卡余额API快速创建为插件，以便后续转账汇款工作流能够调用，从而返回转账卡号的账户余额。

创建转账汇款插件

通过配置方式将转账汇款API快速创建为插件，以便后续转账汇款工作流能够调用，从而实现转账操作。

创建查询卡片列表插件

  1. 登录Versatile智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
  2. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建插件”。
  3. 在“创建插件”页面中的“插件类型”中选择“API类型”，然后根据以下步骤配置插件信息。

    1. 在“基本信息”步骤中设置插件的基础信息，请参照表1完成信息配置，并单击“下一步”进入配置信息页面。
      表1 基本信息

      参数

      示例

      说明

      插件图标

      使用默认图标

      单击默认图标按钮，可上传本地图片作为插件的自定义图标。

      支持jpg、jpeg、png格式，不超过200KB。

      展示名称

      查询卡片列表

      用于标识当前插件，在添加到智能体或工作流后显示的名称。这有助于在智能体、工作流和资产中心中快速搜索和定位该插件。

      命名规则：

      命名要求：可以包含中文、英文、数字、特殊字符等；

      长度限制：1~64个字符。

      名称

      QueryMyCards

      插件的英文名称。

      命名规则：

      命名要求：字母、数字和下划线（_）的组合，不允许使用其他特殊字符或空格；

      长度限制：1~64个字符。

      描述

      查询卡片列表

      描述当前插件的类型、功能和适用场景，帮助用户快速了解插件的作用和用途。

      仅我可见

      保持默认配置

      该功能默认关闭。开启后，仅插件的创建者可见。此设置在插件创建后无法修改。
    2. 填写插件配置信息，单击“确定”。
      表2 配置信息

      参数

      示例

      说明

      协议

      http

      API服务接口通信协议。

      • https
      • http

      服务域名

      IP:3000

      提供API服务的服务域名。

      以https://console.ulanqab.huawei.com/v1/chat/completions为例，服务域名为console.ulanqab.huawei.com

      单击右侧的按钮，在服务域名中添加变量。添加变量后，可以在变量参数部分设置参数的描述。

      在工具调测时，可以输入具体的参数值。

      图1 服务域名示例

      基准URL

      /

      基准URL（Base URL）是指域名的根路径，默认为/。

      如果插件中存在多个工具，基准URL可以填写这些工具共用的URL部分。

      以https://console.ulanqab.huawei.com/v1/chat/completions和https://console.ulanqab.huawei.com/v1/chat/workflows为例，基准URL可以填写为/v1/chat。

      单击右侧的按钮，在基准URL中添加变量。添加变量后，可以在变量参数部分设置参数的描述。

      在工具调测时，可以输入具体的参数值。

      图2 基准URL示例

      权限校验

      无需鉴权

      选择调用API时是否需要鉴权。

      • 无需鉴权：API可以公开访问，不需要任何形式的身份验证或授权。
      • API Key：在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息

        需填写密钥位置，并设置API Key的密钥鉴权参数名和密钥值。

        • 密钥位置：密钥是从Header中读取还是从Query中读取。
        • 参数名称：API Key的鉴权参数名称。
        • 参数值：API Key的具体值。
      • 华为云认证：华为云IAM认证，通过IAM账号获取用户Token进行认证。
        • IAM认证url：获取IAM用户Token信息的接口。例如，https://{iam_host}/v3/auth/tokens。
        • 账号名：IAM用户所属账号信息，即账号名。
        • 项目：该服务所属区域信息。例如，cn-southwest-2。
        • 验证方式
          • IAM用户名/密码

            IAM用户名：IAM用户名称。

            IAM用户密码：IAM用户的登录密码。

          • Access Key ID/Secret Access Key

            Access Key ID：访问密钥ID。

            Secret Access Key：与访问密钥ID结合使用的密钥。

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

    1. 基础信息配置。
      表3 基本信息参数说明

      参数

      示例

      说明

      展示名称

      查询卡片列表

      用于标识当前工具，添加到智能体或工作流后将显示此名称。这有助于在智能体、工作流和资产中心中快速搜索和定位。

      名称

      QueryMyCards

      工具的英文名称。

      命名规则：

      • 命名要求：可以包含大小写字母、数字、下划线。
      • 长度限制：1~64个字符。

      描述

      查询卡片列表

      描述当前工具的功能和适用场景，帮助用户快速了解工具的作用。

      长度限制：1~600个字符。
    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. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。

    图3 自动解析后的响应参数

  8. 工具调试完成后，单击“确定”。
  9. 单击右上角的“发布”按钮。

创建查询卡余额插件

  1. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建插件”。
  2. 在“创建插件”页面中的“插件类型”中选择“API类型”，然后根据以下步骤配置插件信息。

    1. 在“基本信息”步骤中设置插件的基础信息，请参照表6完成信息配置，并单击“下一步”进入配置信息页面。
      表6 基本信息

      参数

      示例

      说明

      插件图标

      使用默认图标

      单击默认图标按钮，可上传本地图片作为插件的自定义图标。

      支持jpg、jpeg、png格式，不超过200KB。

      展示名称

      查询卡余额

      用于标识当前插件，在添加到智能体或工作流后显示的名称。这有助于在智能体、工作流和资产中心中快速搜索和定位该插件。

      命名规则：

      命名要求：可以包含中文、英文、数字、特殊字符等；

      长度限制：1~64个字符。

      名称

      QueryCardBalance

      插件的英文名称。

      命名规则：

      命名要求：字母、数字和下划线（_）的组合，不允许使用其他特殊字符或空格；

      长度限制：1~64个字符。

      描述

      查询卡余额

      描述当前插件的类型、功能和适用场景，帮助用户快速了解插件的作用和用途。

      仅我可见

      保持默认配置

      该功能默认关闭。开启后，仅插件的创建者可见。此设置在插件创建后无法修改。
    2. 填写插件配置信息，单击“确定”。
      表7 配置信息

      参数

      示例

      说明

      协议

      http

      API服务接口通信协议。

      • https
      • http

      服务域名

      IP:3000

      提供API服务的服务域名。

      以https://console.ulanqab.huawei.com/v1/chat/completions为例，服务域名为console.ulanqab.huawei.com

      单击右侧的按钮，在服务域名中添加变量。添加变量后，可以在变量参数部分设置参数的描述。

      在工具调测时，可以输入具体的参数值。

      图4 服务域名示例

      基准URL

      /

      基准URL（Base URL）是指域名的根路径，默认为/。

      如果插件中存在多个工具，基准URL可以填写这些工具共用的URL部分。

      以https://console.ulanqab.huawei.com/v1/chat/completions和https://console.ulanqab.huawei.com/v1/chat/workflows为例，基准URL可以填写为/v1/chat。

      单击右侧的按钮，在基准URL中添加变量。添加变量后，可以在变量参数部分设置参数的描述。

      在工具调测时，可以输入具体的参数值。

      图5 基准URL示例

      权限校验

      无需鉴权

      选择调用API时是否需要鉴权。

      • 无需鉴权：API可以公开访问，不需要任何形式的身份验证或授权。
      • API Key：在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息

        需填写密钥位置，并设置API Key的密钥鉴权参数名和密钥值。

        • 密钥位置：密钥是从Header中读取还是从Query中读取。
        • 参数名称：API Key的鉴权参数名称。
        • 参数值：API Key的具体值。
      • 华为云认证：华为云IAM认证，通过IAM账号获取用户Token进行认证。
        • IAM认证url：获取IAM用户Token信息的接口。例如，https://{iam_host}/v3/auth/tokens。
        • 账号名：IAM用户所属账号信息，即账号名。
        • 项目：该服务所属区域信息。例如，cn-southwest-2。
        • 验证方式
          • IAM用户名/密码

            IAM用户名：IAM用户名称。

            IAM用户密码：IAM用户的登录密码。

          • Access Key ID/Secret Access Key

            Access Key ID：访问密钥ID。

            Secret Access Key：与访问密钥ID结合使用的密钥。

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

    1. 基础信息配置。
      表8 基本信息参数说明

      参数

      示例

      说明

      展示名称

      查询卡余额

      用于标识当前工具，添加到智能体或工作流后将显示此名称。这有助于在智能体、工作流和资产中心中快速搜索和定位。

      名称

      QueryCardBalance

      工具的英文名称。

      命名规则：

      • 命名要求：可以包含大小写字母、数字、下划线。
      • 长度限制：1~64个字符。

      描述

      查询卡余额

      描述当前工具的功能和适用场景，帮助用户快速了解工具的作用。

      长度限制：1~600个字符。
    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. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。

    调测时，输入的请求参数值为API接口中已有的值，具体请参考附录。

    图6 解析后的响应参数

  7. 工具调试完成后，单击“确定”。
  8. 单击右上角的“发布”按钮。

创建转账汇款插件

  1. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件 > 创建插件”。
  2. 在“创建插件”页面中的“插件类型”中选择“API类型”，然后根据以下步骤配置插件信息。

    1. 在“基本信息”步骤中设置插件的基础信息，请参照表12完成信息配置，并单击“下一步”进入配置信息页面。
      表12 基本信息

      参数

      示例

      说明

      插件图标

      使用默认图标

      单击默认图标按钮，可上传本地图片作为插件的自定义图标。

      支持jpg、jpeg、png格式，不超过200KB。

      展示名称

      转账汇款

      用于标识当前插件，在添加到智能体或工作流后显示的名称。这有助于在智能体、工作流和资产中心中快速搜索和定位该插件。

      命名规则：

      命名要求：可以包含中文、英文、数字、特殊字符等；

      长度限制：1~64个字符。

      名称

      Transfer

      插件的英文名称。

      命名规则：

      命名要求：字母、数字和下划线（_）的组合，不允许使用其他特殊字符或空格；

      长度限制：1~64个字符。

      描述

      转账汇款

      描述当前插件的类型、功能和适用场景，帮助用户快速了解插件的作用和用途。

      仅我可见

      保持默认配置

      该功能默认关闭。开启后，仅插件的创建者可见。此设置在插件创建后无法修改。
    2. 填写插件配置信息，单击“确定”。
      表13 配置信息

      参数

      示例

      说明

      协议

      http

      API服务接口通信协议。

      • https
      • http

      服务域名

      IP:3000

      提供API服务的服务域名。

      以https://console.ulanqab.huawei.com/v1/chat/completions为例，服务域名为console.ulanqab.huawei.com

      单击右侧的按钮，在服务域名中添加变量。添加变量后，可以在变量参数部分设置参数的描述。

      在工具调测时，可以输入具体的参数值。

      图7 服务域名示例

      基准URL

      /

      基准URL（Base URL）是指域名的根路径，默认为/。

      如果插件中存在多个工具，基准URL可以填写这些工具共用的URL部分。

      以https://console.ulanqab.huawei.com/v1/chat/completions和https://console.ulanqab.huawei.com/v1/chat/workflows为例，基准URL可以填写为/v1/chat。

      单击右侧的按钮，在基准URL中添加变量。添加变量后，可以在变量参数部分设置参数的描述。

      在工具调测时，可以输入具体的参数值。

      图8 基准URL示例

      权限校验

      无需鉴权

      选择调用API时是否需要鉴权。

      • 无需鉴权：API可以公开访问，不需要任何形式的身份验证或授权。
      • API Key：在调用API时提供一个唯一的API Key进行鉴权。需配置以下信息

        需填写密钥位置，并设置API Key的密钥鉴权参数名和密钥值。

        • 密钥位置：密钥是从Header中读取还是从Query中读取。
        • 参数名称：API Key的鉴权参数名称。
        • 参数值：API Key的具体值。
      • 华为云认证：华为云IAM认证，通过IAM账号获取用户Token进行认证。
        • IAM认证url：获取IAM用户Token信息的接口。例如，https://{iam_host}/v3/auth/tokens。
        • 账号名：IAM用户所属账号信息，即账号名。
        • 项目：该服务所属区域信息。例如，cn-southwest-2。
        • 验证方式
          • IAM用户名/密码

            IAM用户名：IAM用户名称。

            IAM用户密码：IAM用户的登录密码。

          • Access Key ID/Secret Access Key

            Access Key ID：访问密钥ID。

            Secret Access Key：与访问密钥ID结合使用的密钥。

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

    1. 基础信息配置。
      表14 基本信息参数说明

      参数

      示例

      说明

      展示名称

      转账汇款

      用于标识当前工具，添加到智能体或工作流后将显示此名称。这有助于在智能体、工作流和资产中心中快速搜索和定位。

      名称

      Transfer

      工具的英文名称。

      命名规则：

      • 命名要求：可以包含大小写字母、数字、下划线。
      • 长度限制：1~64个字符。

      描述

      转账汇款

      描述当前工具的功能和适用场景，帮助用户快速了解工具的作用。

      长度限制：1~600个字符。
    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. 确保输出符合预期，再单击“自动解析”按钮，系统将自动生成响应参数。

    调测时，输入的请求参数值为API接口中已有的值，具体请参考附录。

    图9 解析后的响应参数

  7. 工具调试完成后，单击“确定”。
  8. 单击右上角的“发布”按钮。

相关文档