调用工具的执行动作
功能介绍
该接口用于调用用户配置的工具的执行动作。
调用方法
请参见如何调用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 |
参数解释: 本次调用的输入内容,即请求体。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
body |
String |
参数解释: 本次调用的请求体。 取值范围: 不涉及。 |
|
header |
String |
参数解释: 本次调用的请求头。 取值范围: 不涉及。 |
状态码: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 |
服务器内部错误或三方服务器内部错误。 |
错误码
请参见错误码。