异步触发技能执行,立即返回 RunId。
接口说明
请求说明
本接口仅支持异步模式:提交后立即返回 RunId 和 Status=Running,客户端通过 GetSkillRun 轮询最终结果。
TenantId:可选公共参数,由网关透传到后端 Header。
SkillCode / SkillName:二选一;SkillCode 优先;SkillName 不唯一时返回
ERR.SkillHub.SkillNameAmbiguous。Arguments:必填,技能入参对象,结构由
GetSkill返回的 inputConfig 描述。ClientToken:可选幂等键;当前版本仅记录到任务元数据,不做强幂等去重。
注意:同步模式(Async=false)、Stream、CallbackUrl 一期不支持,将在后续版本提供。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /openapi/runSkill HTTP/1.1
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
租户 ID,公共参数,缺省时使用调用方默认租户。 |
10000 |
| skillCode |
string |
否 |
技能编码(全局唯一),优先级高于 skillName。 |
string_value |
| skillName |
string |
否 |
技能名称,未传 skillCode 时使用;租户范围内必须唯一。 |
string_value |
| arguments |
object |
否 |
保存错误信息的占位变量值。 |
string_value |
| operatingObjectName |
string |
否 |
数字员工名称;用于按绑定关系计算 CodeAgent allowedSkills 白名单。 |
string_value |
| model |
string |
否 |
抽象模型名(模型档位),不传默认 standard。 |
quick |
| clientToken |
string |
否 |
幂等 token,调用方自行生成;当前版本仅记录到 metadata,未做去重。 |
string_value |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
异步入队成功。 |
||
| code |
string |
响应状态码。 |
200 |
| message |
string |
提示信息。 |
The current zone list is illegal. |
| requestId |
string |
请求 ID |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| runId |
string |
异步任务 ID,用于 getSkillRun 查询。 |
exampleRunId |
| skillCode |
string |
实际执行的技能编码。 |
string_value |
| skillName |
string |
技能名称。 |
string_value |
| status |
string |
任务状态:提交即返回 Running。 |
READY |
| createdAt |
string |
任务创建时间,ISO8601 UTC 格式。 |
string_value |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "The current zone list is illegal.",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"runId": "exampleRunId",
"skillCode": "string_value",
"skillName": "string_value",
"status": "READY",
"createdAt": "string_value"
}