调用工具的执行动作
功能介绍
该接口用于调用用户配置的工具的执行动作。
调用方法
请参见如何调用API。
URI
POST https://aiae.appstage.myhuaweicloud.com/v1/workflow-adapter-open/skills/{skill_id}
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
skill_id | 是 | String | 参数解释: 工具的执行动作ID,进入AI原生应用引擎,在左侧导航栏选择“Agent编排中心 > 我的工具”,在工具列表中复制执行动作ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字以及“-”组成,且长度为36个字符。 默认取值: 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 参数解释: 鉴权信息。获取平台API Key,并为API Key添加前缀Bearer,得到标准鉴权信息,例如Bearer sk-74e4157***。API Key获取方法请参见创建API Key。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
body | 是 | Object | 参数解释: 结构与工具的执行动作的配置相关,并且所有请求头中的入参与请求参数均添加至请求体中,由AI原生应用引擎自动完成分配。如果为GET请求则为非必填,如果为POST请求则为必填。 比如工作流配置了query_param作为查询参数,header_param作为请求头参数,body_param_1与body_param_2作为请求体参数,此时调用本接口只需要将这些参数依次传入,AI原生应用引擎自动按照名称进行分配,并完成工具的执行动作的调用。 具体结构请参照本接口的请求示例。 约束限制: 不涉及。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
data | data object | 响应的body参数。 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 参数解释: 调用记录ID。 取值范围: 只由英文字母、数字以及“-”组成,且长度为36个字符。 |
version | Number | 参数解释: 工具的版本号。 取值范围: 正整数。 |
connector_id | String | 参数解释: 工具ID。 取值范围: 只由英文字母、数字以及“-”组成,且长度为36个字符。 |
action_id | String | 参数解释: 工具的执行动作ID。 取值范围: 只由英文字母、数字以及“-”组成,且长度为36个字符。 |
start_time | String | 参数解释: 本次调用的开始时间。 取值范围: UTC格式的日期。 |
end_time | String | 参数解释: 本次调用的结束时间。 取值范围: UTC格式的日期。 |
cost | Number | 参数解释: 本次调用的总耗时,单位为毫秒。 取值范围: 正整数。 |
status | String | 参数解释: 本次调用的结果。 取值范围:
|
status_code | Number | 参数解释: 本次调用的状态码。 取值范围: 不涉及。 |
method | String | 参数解释: 本次调用的方法。 取值范围:
|
path | String | 参数解释: 本次调用的url。 取值范围: 不涉及。 |
invoke_output | invoke_output object | 参数解释: 本次调用的输出结果,即返回体。 取值范围: 不涉及。 |
invoke_input | invoke_input object | 参数解释: 本次调用的输入内容,即请求体。 取值范围: 不涉及。 |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释: 错误码。 取值范围: 不涉及。 |
error_msg | String | 参数解释: 错误信息。 取值范围: 不涉及。 |
请求示例
{
"query_param" : "query_example",
"header_param" : "header_example",
"body_param_1" : "body_example_1",
"body_param_2" : "body_example_2"
} 响应示例
状态码:200
成功。
{
"data" : {
"id" : "6f46e379-9adf-4395-af0d-4549e09c4048",
"version" : 3,
"connector_id" : "d5a2b8fd-ad02-437d-9234-2225eb992fd6",
"action_id" : "a224ce98-07b5-479a-b75e-560029399312",
"start_time" : "2024-12-28T01:17:31.146Z",
"end_time" : "2024-12-28T01:17:33.582Z",
"cost" : 2436,
"status" : "success",
"status_code" : 200,
"method" : "POST",
"path" : "some path",
"invoke_output" : {
"body" : "something in response body"
},
"invoke_input" : {
"body" : "something in request body",
"header" : "something in request header"
}
}
} 状态码:500
服务器内部错误或三方服务器内部错误。
{
"error_code" : "AIAE.22009001",
"error_msg" : "Internal Server Error."
} 状态码
状态码 | 描述 |
|---|---|
200 | 成功。 |
500 | 服务器内部错误或三方服务器内部错误。 |
错误码
请参见错误码。

