文档首页/ 应用平台 AppStage/ API参考/ API/ 应用中心/ 创建执行动作

更新时间：2025-03-12 GMT+08:00

查看PDF

创建执行动作

功能介绍

该接口用于为工具创建执行动作。

调用方法

请参见如何调用API。

URI

POST https://aiae.appstage.myhuaweicloud.com/v1/workflow-adapter-open/connectors/{connector_id}/actions

表1 路径参数
参数	是否必选	参数类型	描述
connector_id	是	String	参数解释：工具ID，进入AI原生应用引擎，在左侧导航栏选择“Agent编排中心 > 我的工具”，在工具列表中复制工具ID。约束限制：不涉及。取值范围：只能由英文字母、数字以及“-”组成，且长度为36个字符。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Authorization	是	String	参数解释：鉴权信息。获取平台API Key，并为API Key添加前缀Bearer，得到标准鉴权信息，例如Bearer sk-74e4157*。API Key获取方法请参见创建API Key。约束限制：不涉及。取值范围：不涉及。默认取值：** 不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	参数解释：执行动作的名称。约束限制：只能由中英文、数字、下划线、中划线、英文小括号组成，只能使用中英文以及数字开头，且长度不能超过32个字符。
description	否	String	参数解释：执行动作的描述。约束限制：只能包含中英文、数字、下划线、中划线、空格及,.?:;"'：；“”‘’，。？、（）()/@!！*%#等，且长度不能超过256个字符。
english_name	是	String	参数解释：执行动作的英文名称。约束限制：只能由英文、数字、下划线、中划线、英文小括号组成，只能使用英文以及数字开头，且长度不能超过32个字符。
swagger	是	swagger object	参数解释：执行动作的swagger结构。约束限制：不涉及。

表4 swagger
参数	是否必选	参数类型	描述
paths	否	paths object	参数解释：执行动作的swagger结构。约束限制：不涉及。

表5 paths
参数	是否必选	参数类型	描述
path	否	path object	参数解释：执行动作的swagger结构，本字段的名称与接口路径相同，比如接口路径为/test，此处的key应将path替换为/test。约束限制：不涉及。

表6 path
参数	是否必选	参数类型	描述
post	否	post object	参数解释：执行动作的调用方法，本字段的名称与接口的请求方式相同。约束限制：不涉及。

表7 post
参数	是否必选	参数类型	描述
operationId	否	String	参数解释：执行动作的操作ID，随机的uuid。约束限制：只由英文字母、数字以及“-”组成，且长度为36个字符。
x-hw-visibility	否	Boolean	参数解释：可见性。约束限制：填写none即可，表示当前执行动作在流中可以正常显示。
description	否	String	参数解释：执行动作的描述。约束限制：只能包含中英文、数字、下划线、中划线、空格及,.?:;"'：；“”‘’，。？、（）()/@!！*%#等，且长度不能超过256个字符。
summary	否	String	参数解释：执行动作的名称。约束限制：只能由中英文、数字、下划线、中划线、英文小括号组成，只能使用中英文以及数字开头，且长度不能超过32个字符。
parameters	否	Array of parameters objects	参数解释：执行动作的参数。约束限制：不涉及。
response	否	response object	参数解释：执行动作的响应参数。约束限制：不涉及。
consumes	否	String	参数解释：执行动作接收的请求体格式。约束限制： application/json等常用HTTP请求格式。
produces	否	String	参数解释：执行动作返回的响应体格式。约束限制： application/json等常用HTTP响应格式。

表8 parameters
参数	是否必选	参数类型	描述
in	否	String	参数解释：参数位置。约束限制：可以填写body、header、query、path，分别表示参数在请求体、请求头、查询参数、路径参数中。
name	否	String	参数解释：参数名称。约束限制：不涉及。
description	否	String	参数解释：参数描述。约束限制：不涉及。
x-hw-body-required	否	Boolean	参数解释：请求体是否必填。约束限制：填true即可。
schema	否	Object	参数解释：入参结构，进入AI原生应用引擎，在左侧导航栏选择“Agent编排中心 > 我的工具”，在工具列表中展开执行动作列表，单击执行动作列表操作列的“编辑”。单击“下一步”，在“配置输入”页面单击“复制”进行获取。约束限制：不涉及。
x-hw-xml-header	否	String	参数解释： xml格式入参的头格式。约束限制：不涉及。

表9 response
参数	是否必选	参数类型	描述
200	否	200 object	参数解释：请求成功时的响应参数。约束限制：不涉及。

**表10** 200
参数	是否必选	参数类型	描述
description	否	String	参数解释：请求成功。约束限制：填写“请求成功”。
schema	否	Object	参数解释：响应参数结构，进入AI原生应用引擎，在左侧导航栏选择“Agent编排中心 > 我的工具”，在工具列表中展开执行动作列表，单击执行动作列表操作列的“编辑”。单击“下一步”，在“配置输出”页面单击“复制”进行获取。约束限制：不涉及。
headers	否	Object	参数解释：响应参数结构，进入AI原生应用引擎，在左侧导航栏选择“Agent编排中心 > 我的工具”，在工具列表中展开执行动作列表，单击执行动作列表操作列的“编辑”。单击“下一步”，在“配置输出”页面单击“复制”进行获取。约束限制：不涉及。
x-hw-xml-header	否	String	参数解释： xml格式响应参数的头格式。约束限制：不涉及。

响应参数

状态码：200

**表11** 响应Body参数
参数	参数类型	描述
-	String	参数解释：创建出的工具的ID。约束限制：不涉及。

状态码：500

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误信息。取值范围：不涉及。

请求示例

{
  "swagger" : {
    "paths" : {
      "/test" : {
        "post" : {
          "operationId" : "1234567-1234-1234-123451234512",
          "x-hw-visibility" : "none",
          "description" : "example description",
          "summary" : "example name",
          "parameters" : [ {
            "in" : "body",
            "name" : "body",
            "description" : "",
            "x-hw-body-required" : true,
            "schema" : {
              "properties" : {
                "input" : {
                  "description" : "input",
                  "default" : "",
                  "x-hw-default" : "",
                  "type" : "string",
                  "x-hw-label" : "input",
                  "format" : "input",
                  "x-hw-format" : "input",
                  "x-hw-select-options" : [ ]
                }
              },
              "required" : [ "input" ],
              "type" : "object",
              "xml" : null
            },
            "x-hw-xml-header" : null
          } ],
          "response" : {
            "200" : {
              "description" : "请求成功",
              "schema" : {
                "properties" : {
                  "output" : {
                    "description" : "输出",
                    "default" : "",
                    "x-hw-default" : "",
                    "type" : "string",
                    "x-hw-label" : "output",
                    "x-hw-visibility" : "none",
                    "format" : "input",
                    "x-hw-format" : "input",
                    "x-hw-select-options" : [ ]
                  }
                },
                "type" : "object",
                "xml" : null
              },
              "headers" : { },
              "x-hw-xml-header" : null
            }
          },
          "x-model" : {
            "input-MappingConfig" : {
              "rules" : [ ]
            },
            "input-is-model-mapping" : false,
            "input-model" : { },
            "output-MappingConfig" : {
              "rules" : [ ]
            },
            "output-is-model-mapping" : false,
            "output-model" : { }
          },
          "consumes" : [ "application/json" ],
          "produces" : [ "application/json" ]
        }
      }
    }
  },
  "name" : "example name",
  "description" : "example description",
  "english_name" : "example english name"
}

响应示例

状态码：200

成功。

{
  "data" : "tool id"
}

状态码：500

服务器内部错误或三方服务器内部错误。

{
  "error_code" : "AIAE.22009001",
  "error_msg" : "Internal Server Error."
}

状态码

状态码	描述
200	成功。
500	服务器内部错误或三方服务器内部错误。

错误码

请参见错误码。

父主题： 应用中心

上一篇：创建工具

下一篇：删除执行动作

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

盘古Doer提问云社区提问